bodewig 2003/10/13 06:42:16
Modified: docs faq.html
xdocs faq.xml
Log:
Answered that jar M question once too often
Revision Changes Path
1.82 +17 -0 ant/docs/faq.html
Index: faq.html
===================================================================
RCS file: /home/cvs/ant/docs/faq.html,v
retrieving revision 1.81
retrieving revision 1.82
diff -u -r1.81 -r1.82
--- faq.html 13 Oct 2003 13:18:08 -0000 1.81
+++ faq.html 13 Oct 2003 13:42:16 -0000 1.82
@@ -239,6 +239,10 @@
How can I include national characters like German
umlauts in my build file?
</a></li>
+ <li><a href="#encoding">
+ How do I use <code>jar</code>'s <code>M</code> switch?
+ I don't want a MANIFEST.
+ </a></li>
</ul>
<h4 class="toc">It doesn't work (as expected)</h4>
<ul>
@@ -852,6 +856,19 @@
<pre class="code">
<?xml version="1.0" encoding="ISO-8859-1" ?>
</pre>
+ <p class="faq">
+ <a name="encoding"></a>
+ How do I use <code>jar</code>'s <code>M</code> switch?
+ I don't want a MANIFEST.
+ </p>
+ <p>A JAR archive is a ZIP file, so if you don't want a
+ MANIFEST you can simply use <code><zip></code>.</p>
+ <p>If your filenames contain national characters you
should
+ know that Sun's <code>jar</code> utility like Ant's
+ <code><jar></code> uses UFT8 to encode their names while
+ <code><zip></code> uses your platforms default encoding.
+ Use the encoding attribute of <code><zip></code> if
+ necessary.</p>
<p class="faq">
<a name="always-recompiles"></a>
Why does Ant always recompile all my Java files?
1.41 +23 -6 ant/xdocs/faq.xml
Index: faq.xml
===================================================================
RCS file: /home/cvs/ant/xdocs/faq.xml,v
retrieving revision 1.40
retrieving revision 1.41
diff -u -r1.40 -r1.41
--- faq.xml 13 Oct 2003 13:18:08 -0000 1.40
+++ faq.xml 13 Oct 2003 13:42:16 -0000 1.41
@@ -199,7 +199,7 @@
<faqsection title="How do I ...">
<faq id="adding-external-tasks">
- <question>How do I add an external task that I've written to the
+ <question>How do I add an external task that I've written to the
page "External Tools and Task"?</question>
<answer>
@@ -215,7 +215,7 @@
<li>a URL: entry linking to the main page of the tool/task</li>
<li>a Contact: entry containing the email address or the URL
of a webpage for the person or list to contact for issues
- related to the tool/task. <strong>Note that we'll add a
+ related to the tool/task. <strong>Note that we'll add a
link on the page, so any email address added there is not
obfuscated and can (and probably will) be abused by robots
harvesting websites for addresses to spam.</strong></li>
@@ -513,7 +513,7 @@
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
+ encoding instead of your platform's default. For most Western
European countries 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>
@@ -523,6 +523,23 @@
]]></source>
</answer>
</faq>
+
+ <faq if="use-zip-instead-of-jar">
+ <question>How do I use <code>jar</code>'s <code>M</code> switch?
+ I don't want a MANIFEST.</question>
+
+ <answer>
+ <p>A JAR archive is a ZIP file, so if you don't want a
+ MANIFEST you can simply use <code><zip></code>.</p>
+
+ <p>If your filenames contain national characters you should
+ know that Sun's <code>jar</code> utility like Ant's
+ <code><jar></code> uses UFT8 to encode their names while
+ <code><zip></code> uses your platforms default encoding.
+ Use the encoding attribute of <code><zip></code> if
+ necessary.</p>
+ </answer>
+ </faq>
</faqsection>
<faqsection title="It doesn't work (as expected)">
@@ -662,12 +679,12 @@
<answer>
<p>When <code>ant</code> loads properties from an external
- file it dosn't touch the value of properties, trailing blanks
+ file it dosn't touch the value of properties, trailing blanks
will not be trimmed for example.</p>
<p>If the value represents a file path, like a jar needed to
compile, the task which requires the value, javac for example
- would fail to compile since it can't find the file due to
+ would fail to compile since it can't find the file due to
trailing spaces.</p>
</answer>
</faq>
@@ -678,7 +695,7 @@
<code>meta-inf</code> directory.</question>
<answer>
- <p>No it doesn't.</p>
+ <p>No it doesn't.</p>
<p>You may have seen these lower-case directory names in
WinZIP, but WinZIP is trying to be helpful (and fails). If
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
