[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Groff] The case against the case against .EX/.EE & .DS/.DE
From: |
Werner LEMBERG |
Subject: |
Re: [Groff] The case against the case against .EX/.EE & .DS/.DE |
Date: |
Fri, 29 Dec 2006 16:01:29 +0100 (CET) |
> > I tend to advocate the use of .DS/.DE, .TQ, .EX/.EE, .SY, .OP, and
> > probably other nifty things to be used within man pages,
> > *together* with its macro definitions in the preamble. This gives
> > us both a decent markup and backwards compatibility.
>
> This is certainly an acceptable path, provided that the new macros
> are offered in a public domain implementation so that everybody can
> use them without worrying about the license.
Of course.
> Still, if you want macros for the synopsis, there is something
> missing yet. Code like
>
> | .OP \-W name
> | .RI "[\ " files\|.\|.\|. "\ ]"
>
> mixes structural and visual markup in a questionable way (the
> second line makes assumptions about how the output of .OP looks).
I'm open to any suggestions for a sensible macro.
> POSIX (available for free from <http://www.unix.org>) has a set of
> prescriptions for synopsis formatting within the standard (Base
> Definitions, 12.1 "Utility Argument Syntax"). It clearly has its
> origins in manual page synopsis practice, so looking at it might be
> helpful for defining synopsis macros.
Thanks for the pointer. Here a direct URL:
http://www.opengroup.org/onlinepubs/009695399/basedefs/xbd_chap12.html
However, those rules are not really helpful IMHO in our discussion how
such macros should look like.
Werner
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, (continued)
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Gunnar Ritter, 2006/12/28
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Eric S. Raymond, 2006/12/28
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Meg McRoberts, 2006/12/28
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Eric S. Raymond, 2006/12/28
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Meg McRoberts, 2006/12/28
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Werner LEMBERG, 2006/12/29
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Zvezdan Petkovic, 2006/12/28
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Eric S. Raymond, 2006/12/28
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Werner LEMBERG, 2006/12/29
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Gunnar Ritter, 2006/12/29
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE,
Werner LEMBERG <=
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Gunnar Ritter, 2006/12/29
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Gunnar Ritter, 2006/12/29
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Werner LEMBERG, 2006/12/29
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Gunnar Ritter, 2006/12/29
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Ralph Corderoy, 2006/12/29
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, D. E. Evans, 2006/12/29
- Re: [Groff] The case against the case against .EX/.EE & .DS/.DE, Eric S. Raymond, 2006/12/30
- Re: [Groff] Re: Simplifying groff documentation, Ralph Corderoy, 2006/12/29
- [Groff] Avoiding the pod2man mistake, Eric S. Raymond, 2006/12/29
- [Groff] Re: Avoiding the pod2man mistake, Ralph Corderoy, 2006/12/29