[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

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 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 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 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

[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
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

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
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

[gentoo-user] Documentation of and utilities to manipulate console fonts?

2015-06-03 Thread Alan Mackenzie
Hello, Gentoo. Recently, in another software project, somebody wants to replace the ASCII quoting characters ", `, ' with curly unicode quoting characters. I'm not in favour of this, but I'll probably be losing the argument. So I need a font which can display these characters. Not an X-windows G

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

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

[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
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

Re: [gentoo-user] Documentation of and utilities to manipulate console fonts?

2015-06-03 Thread Alan Mackenzie
Hello, again. On Wed, Jun 03, 2015 at 03:40:17PM +, Alan Mackenzie wrote: > Hello, Gentoo. > Recently, in another software project, somebody wants to replace the > ASCII quoting characters ", `, ' with curly unicode quoting characters. > I'm not in favour of this, but I'll probably be losing

Re: [gentoo-user] hdparm / mutlisect

2015-06-03 Thread wabenbau
Adam Carter wrote: > I have 1 ssd and 2 spinners in a system. hdparm reports that > multcount=0, and hdparm -i reports MultSect=off on the ssd (only). > > Are mulitcount and MultiSect the same thing? It seems to be the same (see below). > Why would it be disabled by default on the ssd? From