Hi Werner,

Werner LEMBERG wrote on Thu, Apr 28, 2016 at 02:05:05PM +0200:
> Ingo Schwarze wrote:
>> Werner LEMBERG wrote:

>>> However, `info' is the official GNU documentation format, and its
>>> indexing system is quite good, something groff's output formats
>>> don't provide.

>> Actually, mdoc(7) indexing is more powerful than info(1) indexing:
>> 
>>   http://man.openbsd.org/?query=Ft,Fa~[ug]id_t&apropos=1
>> 
>> Documentation:
>> 
>>   http://man.openbsd.org/apropos

> I rather meant indexing *within* a single document.  By their very
> nature, man pages don't need that because everything is on a single
> page.

The same argument applies.  Take a large manual, for example ksh(1).
With the mandoc-based implementation of man(1), type

  $ man ksh

Then inside less(1), type

  :t read

to jump straight to the description of the "read" builtin command,
while

  /read

is almost useless for the same purpose.

That is a virtue of mdoc(7) which, AFAIK, info(1) cannot keep up
with.

So while i agree that indexing is irrelevant for cat(1) and
true(1) and the like, it is useful and works with mdoc(7) in
large manuals.

Yours,
  Ingo

Reply via email to