You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cactus-dev@jakarta.apache.org by cm...@apache.org on 2003/01/18 14:04:38 UTC

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
  - Remove link around figure, doesn't work with printed docs and isn't 
    allowed by the experimental DTD I'm using locally
  
  Revision  Changes    Path
  1.6       +4 -5      jakarta-cactus/documentation/docs/xdocs/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-cactus/documentation/docs/xdocs/index.xml,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- index.xml	18 Jan 2003 00:08:32 -0000	1.5
  +++ index.xml	18 Jan 2003 13:04:38 -0000	1.6
  @@ -11,7 +11,7 @@
   
     <body>
   
  -    <section name="Project description">
  +    <section title="Project Description">
         <p>
           Cactus is a simple test framework for unit testing server-side java
           code (Servlets, EJBs, Tag Libs, Filters, ...).
  @@ -36,13 +36,12 @@
           usefulness of an in-container approach).
         </p>
         <p>
  -        <link href="site:how_it_works">
  -        <figure src="images/archiani.gif" alt="How it works ..."/></link>
  +        <img src="images/archiani.gif" alt="How it works ..."/>
         </p>
       </section>
   
       <anchor id="unittest_types"/>
  -    <section name="Different kinds of unit tests">
  +    <section title="Different kinds of unit tests">
   
         <p>
           There are several kinds of unit testing frameworks. We categorize them
  @@ -88,7 +87,7 @@
   
       </section>
   
  -    <section name="Getting Started">
  +    <section title="Getting Started">
   
         <p>
           To get started, read the
  
  
  

--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>


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

Posted by Vincent Massol <vm...@octo.com>.

> -----Original Message-----
> From: Christopher Lenz [mailto:cmlenz@gmx.de]
> 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: cmlenz@apache.org [mailto:cmlenz@apache.org]
> >>Sent: 18 January 2003 13:05
> >>To: jakarta-cactus-cvs@apache.org
> >>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:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>


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

Posted by Christopher Lenz <cm...@gmx.de>.
Vincent Massol wrote:
> Hi Chris,
> 
>>-----Original Message-----
>>From: cmlenz@apache.org [mailto:cmlenz@apache.org]
>>Sent: 18 January 2003 13:05
>>To: jakarta-cactus-cvs@apache.org
>>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:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>


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

Posted by Vincent Massol <vm...@octo.com>.
Hi Chris,

> -----Original Message-----
> From: cmlenz@apache.org [mailto:cmlenz@apache.org]
> Sent: 18 January 2003 13:05
> To: jakarta-cactus-cvs@apache.org
> 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... :-)

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

Thanks
-Vincent


--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>