Automatically generate manpage #100

Closed
opened 2026-02-20 22:25:30 -05:00 by deekerman · 3 comments
Owner

Originally created by @phihag on GitHub (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.

Originally created by @phihag on GitHub (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.
Author
Owner

@rbrito commented on GitHub (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).

@rbrito commented on GitHub (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).
Author
Owner

@phihag commented on GitHub (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?).

@phihag commented on GitHub (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?).
Author
Owner

@rbrito commented on GitHub (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.

@rbrito commented on GitHub (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 in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/youtube-dl-ytdl-org#100
No description provided.