bodewig 00/11/30 01:42:53
Modified: docs index.html
Log:
Fixed some typos in the telnet task description.
Submitted by: Chris Todd <[EMAIL PROTECTED]>
Reinstated alphabetical ordering of optional tasks, this makes the
change look bigger than it is.
Revision Changes Path
1.158 +87 -87 jakarta-ant/docs/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/jakarta-ant/docs/index.html,v
retrieving revision 1.157
retrieving revision 1.158
diff -u -r1.157 -r1.158
--- index.html 2000/11/29 17:15:21 1.157
+++ index.html 2000/11/30 09:42:52 1.158
@@ -27,7 +27,7 @@
<li>Dave Walend (<a href="mailto:[EMAIL PROTECTED]">[EMAIL
PROTECTED]</a>)</li>
</ul>
-<p>Version 1.3 - 2000/11/29</p>
+<p>Version 1.3 - 2000/11/30</p>
<hr>
<h2>Table of Contents</h2>
@@ -4573,8 +4573,8 @@
<li><a href="propertyfile.html">PropertyFile</a></li>
<li><a href="#renameexts">RenameExtensions</a></li>
<li><a href="#script">Script</a></li>
- <li><a href="#vssget">VssGet</a></li>
<li><a href="#telnet">Telnet</a></li>
+ <li><a href="#vssget">VssGet</a></li>
</ul>
<hr>
<h2><a name="cab">Cab</a></h2>
@@ -5354,6 +5354,91 @@
BUILD SUCCESSFUL
</pre></blockquote>
<hr>
+<h2><a name="telnet">Telnet</a></h2>
+<h3>Description</h3>
+Task to automate a remote telnet session. The task uses nested <read>
to indicate strings to wait for, and <write> tags to specify text to
send.
+
+<p>If you do specify a userid and password, the system will assume a common
unix prompt to wait on. This behavior can be easily over-ridden.</p>
+<h3>Parameters</h3>
+<table border="1" cellpadding="2" cellspacing="0">
+ <tr>
+ <th>Attribute</th>
+ <th>Values</th>
+ <th>Required</th>
+ </tr>
+ <tr>
+ <td>userid</td>
+ <td>the login id to use on the telnet server.</td>
+ <td>No</td>
+ </tr>
+ <tr>
+ <td>password</td>
+ <td>the login password to use on the telnet server.</td>
+ <td>No</td>
+ </tr>
+ <tr>
+ <td>server</td>
+ <td>the address of the remote telnet server.</td>
+ <td>Yes</td>
+ </tr>
+ <tr>
+ <td>port</td>
+ <td>the port number of the remote telnet server. Defaults to port
21.</td>
+ <td>No</td>
+ </tr>
+ <tr>
+ <td>initialCR</td>
+ <td>send a cr after connecting ("yes"). Defaults to "no".</td>
+ <td>No</td>
+ </tr>
+ <tr>
+ <td>timeout</td>
+ <td>set a default timeout to wait for a response. Specified in seconds.
Default is no timeout.</td>
+ <td>No</td>
+ </tr>
+</table>
+<h3>Examples</h3>
+A simple example of connecting to a server and running a command. This
assumes a prompt of "ogin:" for the userid, and a prompt of "assword:" for the
password.
+<blockquote><pre>
+<telnet userid="bob" password="badpass"
server="localhost">
+ <read>/home/bob</read>
+ <write>ls</write>
+ <read string="/home/bob"/>
+</telnet>
+</pre></blockquote>
+
+This task can be rewritten as:
+<blockquote><pre>
+<telnet server="localhost">
+ <read>ogin:</read>
+ <write>bob</write>
+ <read>assword:</read>
+ <write>badpass</write>
+ <read>/home/bob</read>
+ <write>ls</write>
+ <read>/home/bob</read>
+</telnet>
+</pre></blockquote>
+
+A timeout can be specified at the <telnet> level or at the
<read> level. This will connect, issue a sleep command that is suppressed
from displaying and wait 10 seconds before quitting.
+<blockquote><pre>
+<telnet userid="bob" password="badpass"
server="localhost" timeout="20">
+ <read>/home/bob</read>
+ <write echo="false">sleep 15</write>
+ <read timeout="10">/home/bob</read>
+</telnet>
+</pre></blockquote>
+
+The task can be used with other ports as well:
+<blockquote><pre>
+<telnet userid="bob" password="badpass"
server="localhost" defaultTimeout="20">
+ <read/>
+ <write>GET / http/0.9</write>
+ <write/>
+ <read timeout="10">&lt;/HTML&gt;</read>
+</telnet>
+</pre></blockquote>
+<hr>
<h2><a name="vssget">VssGet</a></h2>
<h3>Description</h3>
Task to perform GET commands to Microsoft Visual Source Safe.
@@ -5431,91 +5516,6 @@
<i>C:\mysrc\myproject</i>. The local files will be writable.</p>
<hr>
-<h2><a name="telnet">Telnet</a></h2>
-<h3>Description</h3>
-Task to automate a remote telnet session. The task uses nested <read>
to indicate strings to wait for, and <write> tags to specify text to
send.
-
-<p>If you do specify a userid and password, the system will assume a common
unix prompt to wait on. This behavior can be easily over-ridden.</p>
-<h3>Parameters</h3>
-<table border="1" cellpadding="2" cellspacing="0">
- <tr>
- <th>Attribute</th>
- <th>Values</th>
- <th>Required</th>
- </tr>
- <tr>
- <td>userid</td>
- <td>the login id to use on the telnet server.</td>
- <td>No</td>
- </tr>
- <tr>
- <td>password</td>
- <td>the login password to use on the telnet server.</td>
- <td>No</td>
- </tr>
- <tr>
- <td>server</td>
- <td>the address of the remote ftp server.</td>
- <td>Yes</td>
- </tr>
- <tr>
- <td>port</td>
- <td>the port number of the remote ftp server. Defaults to port 21.</td>
- <td>No</td>
- </tr>
- <tr>
- <td>initialCR</td>
- <td>send a cr after connecting ("yes"). Defaults to "no".</td>
- <td>No</td>
- </tr>
- <tr>
- <td>timeout</td>
- <td>set a default timeout to wait for a response. Specified in seconds.
Default is no timeout.</td>
- <td>No</td>
- </tr>
-</table>
-<h3>Examples</h3>
-A simple example of connecting to a server and running a command. This
assumes a prompt of "ogin:" for the userid, and a prompt of "ssword:" for the
password.
-<blockquote><pre>
-<telnet userid="bob" password="badpass"
server="localhost">
- <read>/home/bob</read>
- <write>ls</read>
- <read string="/home/bob"/>
-</telnet>
-</pre></blockquote>
-
-This task can be rewritten as:
-<blockquote><pre>
-<telnet server="localhost">
- <read>ogin:</read>
- <write>bob</read>
- <read>ssword:</read>
- <write>badpass</read>
- <read>/home/bob</read>
- <write>ls</read>
- <read>/home/bob</read>
-</telnet>
-</pre></blockquote>
-
-A timeout can be specified at the <telnet> level or at the
<read> level. This will connect, issue a sleep command that is suppressed
from displaying and wait 10 seconds before quitting.
-<blockquote><pre>
-<telnet userid="bob" password="badpass"
server="localhost" timeout="20">
- <read>/home/bob</read>
- <write echo="false">sleep 15</read>
- <read timeout="10">/home/bob</read>
-</telnet>
-</pre></blockquote>
-
-The task can be used with other ports as well:
-<blockquote><pre>
-<telnet userid="bob" password="badpass"
server="localhost" defaultTimeout="20">
- <read/>
- <write>GET / http/0.9</read>
- <write/>
- <read timeout="10">&lt;/HTML&gt;</read>
-</telnet>
-</pre></blockquote>
-<hr>
<h2><a name="buildevents">Build Events</a></h2>
Ant is capable of generating build events as it performs the tasks necessary
to build a project.
Listeners can be attached to ant to receive these events. This capability
could be used, for example,