awk script to render mdoc from man pages

[jklowden]

The attached awk script converts Help2Man output (troff -man macros) to mdoc. The results aren't perfect, but the script alleviates a lot of the tedium in the conversion.

I would be willing to improve the script for the project's benefit if the development team finds it useful.

It's my understanding this is an important outstanding TODO for the project, per https://eucalyptus.atlassian.net/projects/TOOLS/issues/TOOLS-677?filter=allopenissues.

[Joshua Powers (powersj)]

Hi! Thanks for taking the time to file a bug and the development work. My suggestion is to open an account on the upstream atlassian site you linked to and submit a comment there with your fix. We only track ubuntu bugs here it would be better if your work were included directly in the upstream source, then we would get your update code on the next update of euca2ools.

[jklowden (jklowden)]

On Wed, 06 Dec 2017 16:51:11 -0000
Joshua Powers <email address hidden> wrote:

> My suggestion is to open an account on the upstream atlassian site you
> linked to and submit a comment there with your fix. We only track
> ubuntu bugs here it would be better if your work were included
> directly in the upstream source

Hi Joshua,

Thanks, but I hereby give up.

I tried to open an account there. I think I *did* create an account,
but that doesn't give me access to that project.

I wrote the script. I posted it. The project doesn't offer any
contact information, let alone an email address. If they want any
help, they have an odd way of showing it.

If some human being contacts me with a willingness to work, instead of
bureaucratic blah-di-blah, I'll be happy to get involved. But filling
out forms and opening useless accounts is why I left corporate
America.

Kind regards,

--jkl

[Christian Ehrhardt  (paelzer)]

Arrr,
people participating should be encouraged. IMHO it was right by Josh that this should be fixed upstream to tickle down into all projects.
But I tried to contribute or even ping there fore you - what a hell of a ride.
Account Creation -> no access (that sounds like what you had).
Trying to find an email of the bug assignee or any other way to let people know - like a maze.

Overall this thing seems dead to me, with an inactive project lead listed as lead on [1].
And it seems to me the issues in reporting a but or comment could be lack of maintenance on the Jira tracker for it.

Nothing gave me any chance to do [2] comments.
I found the opener of the report [3] on github with a collection of euca repos which seems reasonable confirmation that he is the "one" - Hi Matt!

By following [4] I contacted him directly, so I hope he can help you to contribute there or at least pick up your changes from here for the issue.

Odd case ...

[1]: https://eucalyptus.atlassian.net/projects/TOOLS/summary
[2]: https://confluence.atlassian.com/jira064/commenting-on-an-issue-720416302.html
[3]: https://github.com/mbacchi
[4]: https://www.sourcecon.com/how-to-find-almost-any-github-users-email-address/

[Christian Ehrhardt  (paelzer)]

For the chance of [1] being the same person I added him here - sorry if you are a different one.

[1]: https://launchpad.net/~mattbacchi

[jklowden (jklowden)]

On Thu, 07 Dec 2017 07:41:19 -0000
ChristianEhrhardt <email address hidden> wrote:

> But I tried to contribute or even ping there fore you

Thank you for your efforts, Christian. Much obliged.

--jkl

[Joshua Powers (powersj)]

Matt was kind enough to respond, here is what he said:

---
Unfortunately development of Eucalyptus from an official corporate capacity has been halted. Since its an open source project, anyone can contribute PRs using github. The euca2ools github repository is at: https://github.com/eucalyptus/euca2ools
---

@jkl is proposing a merge on github something you would be willing to do?

[jklowden (jklowden)]

On Thu, 07 Dec 2017 23:30:06 -0000
Joshua Powers <email address hidden> wrote:

> Matt was kind enough to respond, here is what he said:
>
> ---
> Unfortunately development of Eucalyptus from an official corporate
> capacity has been halted. Since its an open source project, anyone
> can contribute PRs using github. The euca2ools github repository is
> at: https://github.com/eucalyptus/euca2ools
> ---
>
> @jkl is proposing a merge on github something you would be willing to
> do?

Yes, can do. This way, the script will be available to anyone who
wants it. It doesn't sound like the euca2ools project any longer has
interest in producing mdoc man pages, but since it came up early in
my search for such a conversion tool, someone else looking for one may
find it there.

Many thanks for your diligence.

--jkl

[Launchpad Janitor (janitor)]

[Expired for euca2ools (Ubuntu) because there has been no activity for 60 days.]