groff
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Groff] More referenceability for -mdoc would be an improvement!?


From: Steffen Nurpmeso
Subject: Re: [Groff] More referenceability for -mdoc would be an improvement!?
Date: Fri, 12 Sep 2014 18:45:14 +0200
User-agent: s-nail v14.7.6-15-gc1887ab

 |Ingo Schwarze <address@hidden> wrote:
 ||Steffen Nurpmeso wrote on Thu, Sep 11, 2014 at 04:22:22PM +0200:
 ||> anyway, i really think that -mdoc would need a few more commands
 ||> so that it would be possible to create "better" documents with it,
 ||> where "better" refers to usability and user experience.
 ||
 ||If we keep groff_mdoc(7) and mandoc(1) in sync, i'm not necessarily
 ||opposed to very sparingly adding functionality, if it adds very
 ||considerable value.

 ||Anyway, here are a few possible ideas:
 ||
 ||  .Ix [macro] [key]
 ||
 ||Example:
 ||
 ||  .Ix Ev USER
 ||
 ||That would add an index entry for the string USER to the index
 ||of environment variables.  Arguments would default to the next

 ||content macro occurring in the input stream.  So
 ||
 ||  .Ix
 ||  .Ix Ar
 ||  .It Fl o Ar outfile
 ||
 ||would be equivalent to
 ||
 ||  .Ix Fl o
 ||  .Ix Ar outfile
 ||  .It Fl o Ar outfile

of course a counter (and optional args saved in numbered strings)
can do this for roff.  Say.  Or better say "could", the non-mandoc
-mdoc is pretty static at the moment..

--steffen



reply via email to

[Prev in Thread] Current Thread [Next in Thread]