bodewig 02/03/26 00:05:49
Modified: docs faq.html
xdocs faq.xml
Log:
Add FAQ for national characters in build files.
Submitted by: Mark Stehr <[EMAIL PROTECTED]>
Revision Changes Path
1.25 +49 -0 jakarta-ant/docs/faq.html
Index: faq.html
===================================================================
RCS file: /home/cvs/jakarta-ant/docs/faq.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- faq.html 15 Mar 2002 09:52:36 -0000 1.24
+++ faq.html 26 Mar 2002 08:05:49 -0000 1.25
@@ -217,6 +217,10 @@
isn't giving me any files at all. What's wrong?
</a></li>
+ <li><a href="#encoding">
+ How can I include national characters like German
+ umlauts in my build file?
+ </a></li>
</ul>
</blockquote>
</td></tr>
@@ -1240,6 +1244,51 @@
to get them. If you find you need to trim the list that the
<code><include></code> elements
produce, then use <code><exclude></code> elements.</p>
+ </blockquote>
+ </td></tr>
+ </table>
+ </a>
+ <a name="encoding">
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#828DA6">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <strong>
+ How can I include national characters like German
+ umlauts in my build file?
+ </strong>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p>You need to tell the XML parser which
character encoding
+ your build file uses, this is done inside the <a
href="http://www.w3.org/TR/2000/REC-xml-20001006#sec-prolog-dtd";>XML
+ declaration</a>.</p>
+ <p>By default the parser assumes you
are using the UTF-8
+ encoding instead of your platform's default. For most western
+ european contries you should set the encoding to
+ <code>ISO-8859-1</code>. To do so, make the very first line
+ of you build file read like</p>
+ <div align="left">
+ <table cellspacing="4" cellpadding="0" border="0">
+ <tr>
+ <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
+ <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
+ <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
+ </tr>
+ <tr>
+ <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
+ <td bgcolor="#ffffff"><pre>
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+</pre></td>
+ <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
+ </tr>
+ <tr>
+ <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
+ <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
+ <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
+ </tr>
+ </table>
+ </div>
</blockquote>
</td></tr>
</table>
1.16 +21 -0 jakarta-ant/xdocs/faq.xml
Index: faq.xml
===================================================================
RCS file: /home/cvs/jakarta-ant/xdocs/faq.xml,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- faq.xml 13 Mar 2002 17:02:35 -0000 1.15
+++ faq.xml 26 Mar 2002 08:05:49 -0000 1.16
@@ -564,6 +564,27 @@
</answer>
</faq>
+ <faq id="encoding">
+ <question>How can I include national characters like German
+ umlauts in my build file?</question>
+
+ <answer>
+ <p>You need to tell the XML parser which character encoding
+ your build file uses, this is done inside the <a
+ href="http://www.w3.org/TR/2000/REC-xml-20001006#sec-prolog-dtd";>XML
+ declaration</a>.</p>
+
+ <p>By default the parser assumes you are using the UTF-8
+ encoding instead of your platform's default. For most western
+ european contries you should set the encoding to
+ <code>ISO-8859-1</code>. To do so, make the very first line
+ of you build file read like</p>
+
+ <source><![CDATA[
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+]]></source>
+ </answer>
+ </faq>
</faqsection>
<faqsection title="Ant and IDEs/Editors">
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
