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

Karsten Wade kwade at redhat.com
Tue Aug 31 17:12:44 UTC 2004


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





More information about the fedora-docs-list mailing list