The following ramble is not fully thought-out.
I was thinking about how I'd like to be able to support i18n of our
docs, specifically looking toward the stanzas in a .def file.
While doing this, I also was again reminded that with Kapila's recent
work we can now expect to see things like 'prog-man-descrip' or
'prog-mdoc-descrip'.
I was noting that I'd like the 'detail' stanza to have certain tags get
expanded (things like the program name, etc).
Right now, the detail stanza is "plain inhaled text" and it is not
post-processed.
Given that there are a number of templates that "share" stanzas, and
that we "need" and now "have" the ability to translate tags from one
format to another, I'm thinking that it would be Swell if there were
some internal autogen functions and variables that would "help out"
template writers, such as:
- a list of the preferred tag types, defaulting to, say:
texi mdoc pod man html text
- a function a la: expandStanza("stanzaName", "tagtype")
that would mean something like:
Scan the symbol table looking for 'stanzaName-tagtype'.
If it is there, give it to me unmodified.
If it is not there, start searching first for stanzaName-texi, then
stanzaName-mdoc, ... (per the preferred tag type list mentioned above)
and as soon as you find the first one use the translation stuff
Kapila wrote to convert it to the desired "tagtype".
The other reason I like this is that it makes it much easier to support
new tag types and have them become automatically supported in existing
.tpl files.
I'm suggesting this because I do not want to have to maintain multiple
instances of a given stanza (for different output formats) unless I
absolutely have to.
--
Harlan Stenn <st...@ntp.org>
http://ntpforum.isc.org - be a member!
------------------------------------------------------------------------------
Learn how Oracle Real Application Clusters (RAC) One Node allows customers
to consolidate database storage, standardize their database environment, and,
should the need arise, upgrade to a full multi-node Oracle RAC database
without downtime or disruption
http://p.sf.net/sfu/oracle-sfdevnl
_______________________________________________
Autogen-users mailing list
Autogen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/autogen-users
