This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
Re: <filename>'s transition to smallcptr.char.mix, 3.x -> 4.x
- To: Norman Walsh <ndw at nwalsh dot com>
- Subject: Re: DOCBOOK: <filename>'s transition to smallcptr.char.mix, 3.x -> 4.x
- From: Nik Clayton <nik at nothing-going-on dot demon dot co dot uk>
- Date: Sun, 14 Jan 2001 16:59:19 +0000
- Cc: docbook at lists dot oasis-open dot org
- Organization: Nik at home, where there's nothing going on
- References: <20010111103828.A99809@canyon.nothing-going-on.org><871yu8lxvm.fsf@nwalsh.com>
On Fri, Jan 12, 2001 at 08:10:21AM -0500, Norman Walsh wrote:
> / Nik Clayton <nik@nothing-going-on.demon.co.uk> was heard to say:
> | This means that constructs such as
> |
> | <para>Your ssh key pair will be placed in the
> | <filename><envar>$HOME</envar>/.ssh</filename> directory.</para>
> |
> | which were valid in 3.x are no longer valid.
> |
> | Is there a recommended alternative way to mark up this sort of text?
> | Wanting to mark up the environment variable, while still indicating it's
> | part of a filename seems fairly natural to me.
>
> This may be evidence that we reduced the content model of filename (and
> perhaps other elements) too far. Is there anything else that should
> be allowed?
I've just gone through the rest of the FreeBSD documentation set --
that's the only thing that will bite us in <filename> (I'm transitioning
our DTD customisation from 3.1 to 4.1). The requirement now for
<segtitle> in <segmentedlist> was a surprise, but I can handle that.
Looking through the DTD at everything else that uses smallcptr.char.mix,
I suppose it's feasible that <prompt> might need it as well. Do you
want me to submit an RFE requesting that <envar> be added back?
N
--
Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95.
Telephone line, $24.95 a month. Software, free. USENET transmission,
hundreds if not thousands of dollars. Thinking before posting, priceless.
Somethings in life you can't buy. For everything else, there's MasterCard.
-- Graham Reed, in the Scary Devil Monastery