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

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

 



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



[Index of Archives]     [Fedora Users]     [Fedora Desktop]     [Red Hat 9]     [Yosemite News]     [KDE Users]

  Powered by Linux