Re: [groff] man-page fixes

2018-11-26 Thread Larry Kollar
> Damian McGuckin wrote: > > In what seems like a gazillion years ago, both DEC and IBM wrote manuals > using a subset of English to make their manuals easy to read for those for > whom English was not a native language. I would love to be able to find the > rules which governed the writing

Re: [groff] man-page fixes

2018-11-23 Thread Damian McGuckin
On Fri, 23 Nov 2018, Larry Kollar wrote: Nowadays, minimalism is all the rage. Omit needless words, as Professor Strunk wrote in 1918. A (shortened?? 26-page) version of which is at https://faculty.washington.edu/heagerty/Courses/b572/public/StrunkWhite.pdf The 4th and latest editio

Re: [groff] man-page fixes

2018-11-23 Thread Larry Kollar
Ingo Schwarze wrote: > Doug McIlroy wrote on Thu, Nov 15, 2018 at 08:40:14PM -0500: > >> Regardless of standards considerations, if there's any advice >> that needs to be hammered into man authors, it's to be concise >> and accurate, but not pedantic. As Will Strunk commanded, >> "Omit needle

Re: [groff] man-page fixes

2018-11-16 Thread Ingo Schwarze
Hi Doug, Doug McIlroy wrote on Thu, Nov 15, 2018 at 08:40:14PM -0500: > Regardless of standards considerations, if there's any advice > that needs to be hammered into man authors, it's to be concise > and accurate, but not pedantic. As Will Strunk commanded, > "Omit needless words." That is rema

Re: [groff] man-page fixes

2018-11-15 Thread John Gardner
> > *The most needless words of all are promotional. No man page should utter > words like "powerful", "extraordinarily versatile", "user-friendly", or > "has a wide range of options".* I couldn't agree more, Doug. *curl(1)* reminds me of this every time I run `man curl` for a reminder on what sw

Re: [Groff] man-page fixes

2007-09-24 Thread Ralph Corderoy
Hi Axel, > >>> http://cm.bell-labs.com/cm/cs/cstr/54.ps.gz > > > Is is possible to have a copy of this document on gnu.org ? > > sometimes documents vanish suddenly (i learned that leasson last > > week). > > I was actually surprised that the files were still there:-) > > I didn't find any lic

Re: [Groff] man-page fixes

2007-09-24 Thread Axel Kielhorn
Am 24.09.2007 um 12:47 schrieb Walter Harms: groff.man (7) linkt to http://cm.bell-labs.com/cm/cs/54.ps but the actual file is at http://cm.bell-labs.com/cm/cs/cstr/54.ps.gz Is is possible to have a copy of this document on gnu.org ? sometimes documents vanish suddenly (i learned that leasso

Re: [Groff] man-page fixes

2007-09-24 Thread Walter Harms
> > Am 21.09.2007 um 20:32 schrieb Axel Kielhorn: > >> Hi! >> >> I'm currently adding a section about further literature to my short >> guide. >> While reading the man-pages I stumbled over a few things: >> >> groff_char.man the Latin-1 (ISO-8859-1) code. >> >> groff.man (7) linkt to http://cm.bel

Re: [Groff] man-page fixes

2007-09-23 Thread Werner LEMBERG
> Here are the patches: Applied with modifications, thanks. Werner

Re: [Groff] man-page fixes

2007-09-22 Thread Axel Kielhorn
Am 21.09.2007 um 20:32 schrieb Axel Kielhorn: Hi! I'm currently adding a section about further literature to my short guide. While reading the man-pages I stumbled over a few things: groff_char.man the Latin-1 (ISO-8859-1) code. groff.man (7) linkt to http://cm.bell-labs.com/cm/cs/54.ps bu

Re: [Groff] man-page fixes

2007-09-21 Thread Werner LEMBERG
> Do you want patches? Yes, please. > If yes, which format? diff -u Werner

Re: [Groff] man-page fixes

2007-09-21 Thread M Bianchi
On Fri, Sep 21, 2007 at 08:32:54PM +0200, Axel Kielhorn wrote: > : > groff.man (7) linkt to http://cm.bell-labs.com/cm/cs/54.ps but the > actual file is at > http://cm.bell-labs.com/cm/cs/cstr/54.ps.gz (Which is actually a ps > file, unless my browser ungziped it on the fly.) It is a gzip