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