bodewig 2005/03/22 03:11:48
Modified: docs/manual/CoreTasks chmod.html
docs/manual/OptionalTasks attrib.html chgrp.html chown.html
Log:
Hint at maxparallel attribute, PR 34119
Revision Changes Path
1.21 +11 -0 ant/docs/manual/CoreTasks/chmod.html
Index: chmod.html
===================================================================
RCS file: /home/cvs/ant/docs/manual/CoreTasks/chmod.html,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- chmod.html 9 Mar 2005 11:30:12 -0000 1.20
+++ chmod.html 22 Mar 2005 11:11:48 -0000 1.21
@@ -26,6 +26,17 @@
<p>Starting with Ant 1.6, this task also supports nested <a
href="../CoreTypes/filelist.html">filelist</a>s.</p>
+<p>By default this task will use a single invocation of the underlying
+chmod command. If you are working on a large number of files this may
+result in a command line that is too long for your operating system.
+If you encounter such problems, you should set the maxparallel
+attribute of this task to a non-zero value. The number to use highly
+depends on the length of your file names (the depth of your directory
+tree) and your operating system, so you'll have to experiment a
+little. POSIX recommends command line length limits of at least 4096
+characters, this may give you an approximation for the number you
+could use as initial value for these experiments.</p>
+
<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
<tr>
1.8 +8 -0 ant/docs/manual/OptionalTasks/attrib.html
Index: attrib.html
===================================================================
RCS file: /home/cvs/ant/docs/manual/OptionalTasks/attrib.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- attrib.html 11 Mar 2005 09:42:56 -0000 1.7
+++ attrib.html 22 Mar 2005 11:11:48 -0000 1.8
@@ -23,6 +23,14 @@
nested <code><fileset></code>, <code><dirset></code>
and
<code><filelist></code> elements.</p>
+<p>By default this task will use a single invocation of the underlying
+attrib command. If you are working on a large number of files this
+may result in a command line that is too long for your operating
+system. If you encounter such problems, you should set the
+maxparallel attribute of this task to a non-zero value. The number to
+use highly depends on the length of your file names (the depth of your
+directory tree), so you'll have to experiment a little.</p>
+
<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
<tr>
1.10 +11 -0 ant/docs/manual/OptionalTasks/chgrp.html
Index: chgrp.html
===================================================================
RCS file: /home/cvs/ant/docs/manual/OptionalTasks/chgrp.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- chgrp.html 11 Mar 2005 09:42:56 -0000 1.9
+++ chgrp.html 22 Mar 2005 11:11:48 -0000 1.10
@@ -23,6 +23,17 @@
nested <code><fileset></code>, <code><dirset></code>
and
<code><filelist></code> elements.</p>
+<p>By default this task will use a single invocation of the underlying
+chgrp command. If you are working on a large number of files this may
+result in a command line that is too long for your operating system.
+If you encounter such problems, you should set the maxparallel
+attribute of this task to a non-zero value. The number to use highly
+depends on the length of your file names (the depth of your directory
+tree) and your operating system, so you'll have to experiment a
+little. POSIX recommends command line length limits of at least 4096
+characters, this may give you an approximation for the number you
+could use as initial value for these experiments.</p>
+
<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
<tr>
1.8 +11 -0 ant/docs/manual/OptionalTasks/chown.html
Index: chown.html
===================================================================
RCS file: /home/cvs/ant/docs/manual/OptionalTasks/chown.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- chown.html 11 Mar 2005 09:42:56 -0000 1.7
+++ chown.html 22 Mar 2005 11:11:48 -0000 1.8
@@ -24,6 +24,17 @@
<code><filelist></code> elements.</p>
+<p>By default this task will use a single invocation of the underlying
+chown command. If you are working on a large number of files this may
+result in a command line that is too long for your operating system.
+If you encounter such problems, you should set the maxparallel
+attribute of this task to a non-zero value. The number to use highly
+depends on the length of your file names (the depth of your directory
+tree) and your operating system, so you'll have to experiment a
+little. POSIX recommends command line length limits of at least 4096
+characters, this may give you an approximation for the number you
+could use as initial value for these experiments.</p>
+
<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
<tr>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org
|