[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Groff] Toward a convention for namespaces
From: |
Werner LEMBERG |
Subject: |
Re: [Groff] Toward a convention for namespaces |
Date: |
Mon, 08 Feb 2010 07:33:15 +0100 (CET) |
> [...] it means we really need only focus on namespaces for *support*
> packages.
Exactly. Additionally, we should ensure that `main' macro packages
use a prefix (or a set of prefixes, if useful) for auxiliary stuff
consistently.
> Besides, retrofitting namespaces into primary packages may break
> documents that call low-level macros to fix a particular issue --
> we're not supposed to do it, but we do (and I'll admit, you'll find
> an occasional "address@hidden" in my documents).
Hmm. This is a difficult topic. Ideally, we shouldn't care about
this at all, preferring a clean implementation. In other words, only
the documented macros should have unmodifiable names. For backwards
compatibility we could retain the `original' macros under a different
package name (cf. -mdoc and -mdoc-old).
> That leaves us with the nature of the namespaces themselves. [...]
I don't have any preference. It would be a good start to simply
document the prefixes of the main and auxiliary macro packages which
are floating around, additionally looking for (and documenting)
irregularities.
Any takers?
BTW, a `prefix' in the above sense can be a special character too,
located somewhere inbetween:
foo*bar
foo:bar
foo!bar
address@hidden
Again, it would be great if someone documents that.
Werner
- [Groff] Another hdtbl patch, Larry Kollar, 2010/02/01
- Re: [Groff] Another hdtbl patch, Werner LEMBERG, 2010/02/03
- Re: [Groff] Another hdtbl patch, Werner LEMBERG, 2010/02/03
- Re: [Groff] Another hdtbl patch, Robert Thorsby, 2010/02/03
- Re: [Groff] Another hdtbl patch, Mike Bianchi, 2010/02/03
- Re: [Groff] Another hdtbl patch, Werner LEMBERG, 2010/02/04
- Re: [Groff] Another hdtbl patch, Ralph Corderoy, 2010/02/05
- [Groff] names in groff -- was: Another hdtbl patch, Mike Bianchi, 2010/02/05
- Re: [Groff] names in groff -- was: Another hdtbl patch, walter harms, 2010/02/05
- Re: [Groff] names in groff -- was: Another hdtbl patch, Werner LEMBERG, 2010/02/08
- Re: [Groff] Another hdtbl patch, Tadziu Hoffmann, 2010/02/04
- Re: [Groff] Another hdtbl patch, Robert Thorsby, 2010/02/04