Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Automatically generate manpage #151

Closed
phihag opened this issue Sep 13, 2011 · 3 comments
Closed

Automatically generate manpage #151

phihag opened this issue Sep 13, 2011 · 3 comments

Comments

@phihag
Copy link
Contributor

@phihag phihag commented Sep 13, 2011

There should be a make target update-manpage to generate the manpage, just like there is to update the README.

The manpage text can be taken from the existing debian manpage.

@rbrito
Copy link
Contributor

@rbrito rbrito commented Sep 22, 2011

Hi.

Besides the manpage that I created, I think that I can give you the pod source that I created translated to markdown and integrate the little that I have there with the program/README.

Once it is in markdown format, I guess that we could use Joey Hess's hackish converter:

https://github.com/joeyh/ikiwiki/blob/master/mdwn2man

It should probably not be that difficult to rewrite in Python, if we want to avoid an external dependency on Perl (but, then, if we can live with Perl, then my pod manpage would be just fine).

@phihag
Copy link
Contributor Author

@phihag phihag commented Sep 22, 2011

While pod isn't too bad (although the groff generated by it is), I don't really want another format to manage besides markdown.

In any case, would you be willing to contribute your debian manpage under Public Domain (do we need to ask edmonds@debian.org to do so, too?).

@rbrito
Copy link
Contributor

@rbrito rbrito commented Sep 22, 2011

No, no. That manpage was written by me and I'm the maintainer of youtube-dl for quite some time now...

I surely license the manpage under Public Domain. If you need a commit with a signed-off-by, just let me know and I'll send you a pull request.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Linked pull requests

Successfully merging a pull request may close this issue.

None yet
3 participants
You can’t perform that action at this time.