[gentoo-user] Re: writing man pages (gentoo conventions)

2015-06-04 Thread Martin Vaeth
James wrote: > > Pod leaves me with too many choices. Can you narrow it down? pod (and pod2*) is part of perl. Very likely it is already installed. man perlpod (or "perldoc pod::perlpod" if the former does not work on your system). > eix latex returns too many choices. What is the best one(s) to

Re: [gentoo-user] Re: writing man pages (gentoo conventions)

2015-06-03 Thread Joerg Schilling
Grant Edwards wrote: > The easiest thing to do is to grab the source for an existing man page > and start editing... If you use one of sufficient quality ;-) Jörg -- EMail:jo...@schily.net(home) Jörg Schilling D-13353 Berlin joerg.schill...@fokus.fraunhofer.de (wor

[gentoo-user] Re: writing man pages (gentoo conventions)

2015-06-03 Thread Grant Edwards
On 2015-06-03, James wrote: > Grant Edwards gmail.com> writes: > > >> asciidoc, markdown, and reStructuredText can all generate man page >> format as well as HTML, PDF, and others. The main benefit of these is >> that they're also easy to read in their "raw" input format (unlike >> roff). > > I

Re: [gentoo-user] Re: writing man pages (gentoo conventions)

2015-06-03 Thread Joerg Schilling
James wrote: > Joerg Schilling fokus.fraunhofer.de> writes: > > > > man -s5 man > > man 7 man If you like to read the original aman -s5 man, look here: http://schillix.sourceforge.net/man/man5/man.5.html It contains a cookbook for a typical man page. > > BTW: Use other (good) man

Re: [gentoo-user] Re: writing man pages (gentoo conventions)

2015-06-03 Thread Marc Joliet
Am Wed, 3 Jun 2015 15:34:13 + (UTC) schrieb James : > Grant Edwards gmail.com> writes: > > > > asciidoc, markdown, and reStructuredText can all generate man page > > format as well as HTML, PDF, and others. The main benefit of these is > > that they're also easy to read in their "raw" inpu

[gentoo-user] Re: writing man pages (gentoo conventions)

2015-06-03 Thread James
Grant Edwards gmail.com> writes: > asciidoc, markdown, and reStructuredText can all generate man page > format as well as HTML, PDF, and others. The main benefit of these is > that they're also easy to read in their "raw" input format (unlike > roff). I could not find 'restructuretext'; got a

Re: [gentoo-user] Re: writing man pages (gentoo conventions)

2015-06-03 Thread Jc García
2015-06-03 9:14 GMT-06:00 Peter Humphrey : > Isn't there a Gentoo Way too? I can't put my finger on it just now but I think > I've seen a reference to producing Gentoo docs, including man pages. > Portage uses roff[1], so I don't think there is a gentoo specific way. [1] https://github.com/gentoo/

[gentoo-user] Re: writing man pages (gentoo conventions)

2015-06-03 Thread James
Joerg Schilling fokus.fraunhofer.de> writes: > man -s5 man man 7 man > BTW: Use other (good) man pages as reference and avoid the BSD doc format > that was introduced while the AT&T lawsuit was active. Yea, I learned 'monkey see monkey' do a log time ago, to get along; got an explicit

[gentoo-user] Re: writing man pages (gentoo conventions)

2015-06-03 Thread Grant Edwards
On 2015-06-03, Peter Humphrey wrote: > On Wednesday 03 June 2015 14:24:18 Grant Edwards wrote: >> On 2015-06-03, Martin Vaeth wrote: >> > James wrote: >> >> So instead of my spew of ascii information files, I'm now composing >> >> 'man pages' mostly using txt2man. >> > >> > If you want to avoid

[gentoo-user] Re: writing man pages (gentoo conventions)

2015-06-03 Thread James
Martin Vaeth mvath.de> writes: > > So instead of my spew of ascii information files, I'm now composing > > 'man pages' mostly using txt2man. > > If you want to avoid learning *roff, there is also e.g. pod from perl > which gives you simple basic markup functionality and can output in > man page

Re: [gentoo-user] Re: writing man pages (gentoo conventions)

2015-06-03 Thread Peter Humphrey
On Wednesday 03 June 2015 14:24:18 Grant Edwards wrote: > On 2015-06-03, Martin Vaeth wrote: > > James wrote: > >> So instead of my spew of ascii information files, I'm now composing > >> 'man pages' mostly using txt2man. > > > > If you want to avoid learning *roff, there is also e.g. pod from p

[gentoo-user] Re: writing man pages (gentoo conventions)

2015-06-03 Thread Grant Edwards
On 2015-06-03, Martin Vaeth wrote: > James wrote: >> >> So instead of my spew of ascii information files, I'm now composing >> 'man pages' mostly using txt2man. > > If you want to avoid learning *roff, there is also e.g. pod from perl > which gives you simple basic markup functionality and can ou

Re: [gentoo-user] Re: writing man pages (gentoo conventions)

2015-06-03 Thread Joerg Schilling
Martin Vaeth wrote: > James wrote: > > > > So instead of my spew of ascii information files, I'm now composing > > 'man pages' mostly using txt2man. > > If you want to avoid learning *roff, there is also e.g. pod from perl > which gives you simple basic markup functionality and can output in > m

[gentoo-user] Re: writing man pages (gentoo conventions)

2015-06-03 Thread Martin Vaeth
James wrote: > > So instead of my spew of ascii information files, I'm now composing > 'man pages' mostly using txt2man. If you want to avoid learning *roff, there is also e.g. pod from perl which gives you simple basic markup functionality and can output in man page format (and other format). Fo