[fpc-devel] fpdoc and unicode characters

[Graeme Geldenhuys]

On Thu, Aug 14, 2008 at 1:14 PM, Marco van de Voort <marcov at stack.nl> wrote:
>> How does this argument fit with XML which also uses UTF-8 as the de
>> facto standard encoding. And seeing that fpdoc uses XML for the
>> documentation files, can I use the actual Unicode characters in my
>> fpdoc documentation, or must I still stick with the?what now seems to
>> be outdated?escaped method?
>
> Depends. Is & a steering character in all of XML, or only the xhtml like
> standards?

I think only XHTML.

But what is fpdoc's xml files?  Pure XML, XHTML or some custom/hybrid
format? The layout of fpdoc's files seem XML, but the documentation
content seems some hybrid HTML - hence the confusion with what is
allowed!

Anybody know the rules of strict XML files and Unicode?  Can I use
Unicode characters as data in XML nodes? I would imagine I may because
most well-formed XML files specify UTF-8 as the encoding type.

Also something I think has been resolved in recent versions, but in
older 'makeskel' versions, it did not include the encoding in the
generated .xml file.  So what are we supposed to treat such files
encoding as? Default to W3C standards and use assume UTF-8?  LCL and
fpGUI's fpdoc documentation (mostly) has no encoding specified in the
.xml files.  FPC's documentation specifies ISO8859-1 as the encoding
type, though I found one file (dateutils.xml) it FPC docs that hasn't
got an encoding (but my doc update is out of date).


Regards,
 - Graeme -


_______________________________________________
fpGUI - a cross-platform Free Pascal GUI toolkit
http://opensoft.homeip.net/fpgui/