[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]

Re: taking screenshots - new section for Documentation Guide (was installation guide)



On Tue, 2004-08-31 at 10:05, Dave Pawson wrote:
> On Mon, 2004-08-30 at 22:40, Karsten Wade wrote:
> 
> > 
> > I am advocating:
> > 
> > <screen>
> > <![CDATA[
> > foo {
> >   bar ()
> > }
> > ]]>
> > </screen>
> > 
> > Same for <programlisting/> blocks.
> 
> Which is identical to 
> <screen>
> &lt; blah blah,
> </screen>
> 
> I.e. Just a processor frig.
> 
> In the example you've shown they are identical,
> with / without CDATA wrapper, since there is nothing
> needing escaping.

Don't let the example rule the usage.

Anyone who has had to convert many lines of XML, HTML, or other
languages to use entities such as &lt; and &gt; knows what a pain it is
to maintain.  You can't tell from the source what you are looking at.

- Karsten
-- 
Karsten Wade, RHCE, Tech Writer
a lemon is just a melon in disguise
http://people.redhat.com/kwade/
gpg fingerprint: 2680 DBFD D968 3141 0115  5F1B D992 0E06 AD0E 0C41



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]