> -----Original Message-----
> From: Christopher Lenz [mailto:[EMAIL PROTECTED]]
> Sent: 21 January 2003 23:13
> To: Cactus Developers List
> Subject: Re: cvs commit: jakarta-cactus/documentation/docs/xdocs
index.xml
> 
> 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.

No problem. Again, there is nothing urgent here at all!

> 
> >>  - 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.

I'd prefer a link on the image (from a user point of view) but don't
worry. DO not spend much time on this for now. I'd much rather see the
printed doc output! :-)

Thanks
-Vincent



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

Reply via email to