Re: [groff] mom manpage

2018-12-01 Thread John Gardner
> Even better - on OpenBSD-current, i simply type On OpenBSD 6.4, I simply get "man -O tag=wait: Bad argument". ;-) > Just like https://man.openbsd.org/ksh#wait > only at the console. And no, it does *not* require the author to > say "i want an anchor here" in any special syntax. It just work

Re: [groff] mom manpage

2018-12-01 Thread Steffen Nurpmeso
Hello Ingo, Ingo Schwarze wrote in <20181201120713.ga89...@athene.usta.de>: |John Gardner wrote on Sat, Dec 01, 2018 at 05:36:25PM +1100: |> Ingo Schwarze wrote: |>> Even moderately large systems can be beautifully documented in a |>> single manual page - for example, a shell | |> It's amazi

Re: [groff] 1.22.4.rc4 - Final RC before official 1.22.4

2018-12-01 Thread Ingo Schwarze
Hi Bertrand, Bertrand Garrigues wrote on Fri, Nov 30, 2018 at 01:00:59AM +0100: > A few checks can be done with: > > make check Oops, i overlooked this part earlier. OpenBSD-current: schwarze@isnote $ make check make check-am make make all-am make check-TESTS PASS: contrib/gdiffmk/tes

Re: [groff] mom manpage

2018-12-01 Thread John Gardner
> Software that inherently defies concise description is suspect on > its face. In all likelihood it was built by accumulation way beyond > the bounds of any organizing principles that the author(s) may have > had at the outset. MDN (Mozilla Development Network) is probably the first offender that

Re: [groff] mom manpage

2018-12-01 Thread Doug McIlroy
> if you are interested in my perspective - scrap the HTML documentation > and fix the manpage. The reference manual - i.e. the manpage - is > really important: when you use some software regularly, you use the > reference manual all your life. Catering to the experienced user > is most import

Re: [groff] mom manpage

2018-12-01 Thread Ingo Schwarze
Hi John, John Gardner wrote on Sat, Dec 01, 2018 at 05:36:25PM +1100: > Ingo Schwarze wrote: >> Even moderately large systems can be beautifully documented in a >> single manual page - for example, a shell > It's amazing how true this is. Even with massive man-pages, it's still > easier to find

Re: [groff] Design and Implementation of *roff

2018-12-01 Thread John Gardner
> Well, Ali Golhami Rudi made it a few years ago... Reimplementing a Troff > is a task people can do if they have reasons to do so. Well, I assume his reasons were to have a Troff variant which supported right-to-left languages (which, if you think about it, is a pretty glaring oversight in a type

Re: [groff] Design and Implementation of *roff

2018-12-01 Thread Pierre-Jean Fichet
John Gardner wrote: > Reimplementing Troff is a task best not attempted at all. Well, Ali Golhami Rudi made it a few years ago... Reimplementing a Troff is a task people can do if they have reasons to do so. > On Sat, 1 Dec 2018 at 02:37, Yves Cloutier wrote: > > I'm in search of any documenta