From 119e49b11a7c7b72fd5a0d6f1a5b7ab2dd1a9234 Mon Sep 17 00:00:00 2001
From: Sam Ruby <rubys@apache.org>
Date: Sat, 3 Mar 2001 13:10:45 +0000
Subject: [PATCH] Delinquent change to the documentation to document
 build.sysclasspath.

THis is only the first installment.  Next I'm going to go into each task
affected and document the default and provide a link to this text.


git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@268752 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/coretasklist.html |  1 +
 docs/manual/sysclasspath.html | 56 +++++++++++++++++++++++++++++++++++
 2 files changed, 57 insertions(+)
 create mode 100644 docs/manual/sysclasspath.html
diff --git a/docs/manual/coretasklist.html b/docs/manual/coretasklist.html
index c458f794d..f89a5fac6 100644
--- a/docs/manual/coretasklist.html
+++ b/docs/manual/coretasklist.html
@@ -12,6 +12,7 @@
 
 <h3>Concepts and Types</h3>
 <a href="dirtasks.html">Directory Based Tasks</a><br>
+<a href="sysclasspath.html">build.sysclasspath</a><br>
 <a href="CoreTypes/patternset.html">Patternset</a><br>
 <a href="CoreTypes/fileset.html">Fileset</a><br>
 <a href="CoreTypes/mapper.html">File Mappers</a><br>
diff --git a/docs/manual/sysclasspath.html b/docs/manual/sysclasspath.html
new file mode 100644
index 000000000..6806a79ba
--- /dev/null
+++ b/docs/manual/sysclasspath.html
@@ -0,0 +1,56 @@
+<html>
+
+<head>
+<meta http-equiv="Content-Language" content="en-us">
+<title>Ant User Manual</title>
+</head>
+
+<body>
+
+<h2><a name="sysclasspath">build.sysclasspath</a></h2>
+<p>The value of the build.sysclasspath property
+control how the system classpath, ie. the classpath in effect when
+Ant is run, affects the behaviour of classpaths in Ant. 
+The default behavior varies from Ant to Ant task.</p>
+
+The values and their meanings are:
+
+<table cellspacing="20">
+<tr>
+<th align="left" valign="top">only</th>
+<td>Only the system classpath is used and classpaths specified in build files,
+etc are ignored. This situation could be considered as the person running
+the build file knows more about the environment than the person writing the
+build file
+</td>
+</tr>
+
+<tr>
+<th align="left" valign="top">ignore</th>
+<td>
+The system classpath is ignored. This situation is the reverse of the
+above. The person running the build trusts the build file writer to get the
+build file right
+</td>
+</tr>
+
+<tr>
+<th align="left" valign="top">last</th>
+<td>
+The classpath is concatenated to any specified classpaths at the end. This
+is a compromise, where the build file writer has priority.
+</td>
+</tr>
+
+<tr>
+<th align="left" valign="top">first</th>
+<td>
+Any specified classpaths are concatenated to the system classpath. This is
+the other form of compromise where the build runner has priority.
+</td>
+</tr>
+</table>
+
+</body>
+</html>
+

only	Only the system classpath is used and classpaths specified in build files, +etc are ignored. This situation could be considered as the person running +the build file knows more about the environment than the person writing the +build file +
ignore	+The system classpath is ignored. This situation is the reverse of the +above. The person running the build trusts the build file writer to get the +build file right +
last	+The classpath is concatenated to any specified classpaths at the end. This +is a compromise, where the build file writer has priority. +
first	+Any specified classpaths are concatenated to the system classpath. This is +the other form of compromise where the build runner has priority. +