Re: cvs commit: jakarta-cactus/documentation/docs/xdocs index.xml

[Christopher Lenz]

Vincent Massol wrote:

Hi Chris,

-----Original Message-----
From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED]]
Sent: 18 January 2003 13:05
To: [EMAIL PROTECTED]
Subject: cvs commit: jakarta-cactus/documentation/docs/xdocs index.xml

cmlenz      2003/01/18 05:04:38

 Modified:    documentation/docs/xdocs index.xml
 Log:
 - Change <section name="..."> to <section title="..."> to match the

rest

   of the docs

hum... I had put "name" instead of "title" to be closer to the Maven
xdoc DTD. No worries, we can always change it back later, once we move
to Maven, if need be... :-)

The reason for this change was that all other sections used the title attribute after my find&replace-migration from s1/s2/s3 to section. I have a full DTD for the docs in the pipeline (based on forrest, but altered to match the current Cactus docs). I'd prefer to change the attribute back to "name" when validation against the DTD is in place, so that errors can be found more easily.

 - Remove link around figure, doesn't work with printed docs and

isn't

   allowed by the experimental DTD I'm using locally

I would like to keep the link around the figure as I think it is very
logical. Is it possible to put it back and find a way for the printed
doc to work?

[snip]

Hmm, how about a simple textual link underneath the image? I think that would also make it clearer where the link is taking you to.

The main reason for removing the link was that it didn't fit with the DTD I'm using, which enforces a clean separation between "block" and "inline" content, thus making support for multiple target formats easier.

If you feel a textual link wouldn't be good enough, I can probably find a way around the conflict with the DTD.

--
Christopher Lenz
/=/ cmlenz at gmx.de


--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>