Skip to content

Commit ab337e1

Browse files
henhen
committed
Copying the CLI2 site over, to then be tightened up to be a CLI1 website
git-svn-id: https://svn.apache.org/repos/asf/commons/proper/cli/branches/cli-1.x@756326 13f79535-47bb-0310-9956-ffa450edef68
1 parent 74cb5d9 commit ab337e1

26 files changed

Lines changed: 3376 additions & 0 deletions

‎xdocs/changes.xml‎

Lines changed: 138 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,138 @@
1+
<?xml version="1.0"?>
2+
<!--
3+
Licensed to the Apache Software Foundation (ASF) under one or more
4+
contributor license agreements. See the NOTICE file distributed with
5+
this work for additional information regarding copyright ownership.
6+
The ASF licenses this file to You under the Apache License, Version 2.0
7+
(the "License"); you may not use this file except in compliance with
8+
the License. You may obtain a copy of the License at
9+
10+
http://www.apache.org/licenses/LICENSE-2.0
11+
12+
Unless required by applicable law or agreed to in writing, software
13+
distributed under the License is distributed on an "AS IS" BASIS,
14+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15+
See the License for the specific language governing permissions and
16+
limitations under the License.
17+
-->
18+
19+
<document>
20+
<properties>
21+
<title>Commons CLI Release Notes</title>
22+
</properties>
23+
<body>
24+
25+
<release version="1.2" date="2009-03-19" description="This is a maintenance release containing bug fixes.">
26+
<action type="fix" dev="oheger" issue="CLI-175">
27+
Test class BugCLI162Test fails under Windows
28+
</action>
29+
<action type="fix" dev="joehni" issue="CLI-177">
30+
OptionBuilder is not reseted in case of an IAE at create.
31+
</action>
32+
<action type="remove" dev="bayard">
33+
Ant build system removed.
34+
</action>
35+
<action type="fix" dev="ebourg" issue="CLI-154">
36+
Incomplete usage documentation about Java property option.
37+
</action>
38+
<action type="fix" dev="bayard" issue="CLI-170">
39+
TypeHandler prints messages to stderr.
40+
</action>
41+
<action type="fix" dev="bayard" issue="CLI-170">
42+
TypeHandler prints messages to stderr.
43+
</action>
44+
<action type="fix" dev="bayard" issue="CLI-162">
45+
Infinite loop in the wrapping code of HelpFormatter.
46+
</action>
47+
<action type="fix" dev="sgoeschl">
48+
Fixing some minor javadoc issues.
49+
</action>
50+
<action type="fix" dev="ebourg" issue="CLI-137">
51+
The number of arguments defined for an option specifies the arguments per occurrence of the option
52+
and not for all occurrences. This was a major regression in CLI 1.1 which prevented the use of repeated options.
53+
</action>
54+
<action type="add" dev="ebourg">
55+
Added a getOptionProperties() method in the CommandLine class to retrieve easily the key/value pairs
56+
specified with options like -Dkey1=value1 -Dkey2=value2.
57+
</action>
58+
<action type="update" dev="ebourg" issue="CLI-157">
59+
GnuParser now supports long options with an '=' sign (ie. --foo=bar and -foo=bar)
60+
</action>
61+
<action type="fix" dev="ebourg" issue="CLI-164">
62+
PosixParser no longer ignores unrecognized short options.
63+
</action>
64+
<action type="fix" dev="ebourg" issue="CLI-163">
65+
PosixParser no longer stops the bursting process of a token if stopAtNonOption is enabled and a non option
66+
character is encountered.
67+
</action>
68+
<action type="fix" dev="ebourg" issue="CLI-165">
69+
PosixParser no longer keeps processing the tokens after an unrecognized long option
70+
when stopAtNonOption is enabled.
71+
</action>
72+
<action type="fix" dev="ebourg" issue="CLI-156">
73+
Required options are properly checked if an Options instance is used twice to parse a command line.
74+
</action>
75+
<action type="update" dev="bayard" issue="CLI-155">
76+
The ordering of options can be defined in help messages.
77+
</action>
78+
<action type="fix" dev="bayard" issue="CLI-151" due-to="Dan Armbrust">
79+
The line wrapping in HelpFormatter now works properly. This caused CLI-162, and thus there was a feature change
80+
for the HelpFormatter in that it is strict on width now rather than what seemed to be lenience before. Text without
81+
whitespace will be cut off to fit in the spacing, and an IllegalStateException will be thrown if it is impossible
82+
to output the information due to spacing constraints.
83+
</action>
84+
<action type="fix" dev="bayard" issue="CLI-149">
85+
The message of MissingOptionException has been improved.
86+
</action>
87+
<action type="update" dev="ebourg" issue="CLI-86">
88+
The exceptions have been enhanced with methods to retrieve easily the related options.
89+
</action>
90+
<action type="fix" dev="bayard" issue="CLI-141" due-to="Henning Schmiedehausen, Bjorn Townsend">
91+
Option.toString() now reports arguments properly.
92+
</action>
93+
<action type="update" dev="bayard" issue="CLI-142" due-to="Henning Schmiedehausen">
94+
The Parser class has been changed to be more easily extendable.
95+
</action>
96+
<action type="update" dev="bayard" issue="CLI-140">
97+
The following classes are now serializable: Option, OptionGroup, CommandLine and Options.
98+
</action>
99+
<action type="remove" dev="ebourg">
100+
OptionValidator is no longer public, its methods were all private.
101+
</action>
102+
</release>
103+
104+
<release version="1.1" date="2007-07-08" description="This is a maintenance release containing bug fixes.">
105+
106+
<action type="fix" issue="CLI-2">Wrong usage summary. </action>
107+
<action type="fix" issue="CLI-5">Dependecy on commons-lang-2.0 but commons-lang-1.0 is obtained. </action>
108+
<action type="fix" issue="CLI-8">Line separator as first char for helpformatter (footer) throws exception. </action>
109+
<action type="fix" issue="CLI-13">CommandLine.getOptionValue() behaves contrary to docs. </action>
110+
<action type="fix" issue="CLI-21">clone method in Option should use super.clone(). </action>
111+
<action type="fix" issue="CLI-23">Passing properties in Parser does not work for options with a single argument. </action>
112+
<action type="fix" issue="CLI-26">Only long options without short option seems to be noticed. </action>
113+
<action type="fix" issue="CLI-28">Infinite Loop in Command-Line processing. </action>
114+
<action type="fix" issue="CLI-29">Options should not be able to be added more than once. </action>
115+
<action type="fix" issue="CLI-35">HelpFormatter doesn't sort options properly. </action>
116+
<action type="fix" issue="CLI-38">HelpFormatter doesn't function correctly for options with only LongOpt. </action>
117+
<action type="fix" issue="CLI-44">Document enhancement. </action>
118+
<action type="fix" issue="CLI-45">Documentation errors. </action>
119+
<action type="fix" issue="CLI-51">Parameter value "-something" misinterpreted as a parameter. </action>
120+
<action type="fix" issue="CLI-56">clone() method doesn't fully clone contents. </action>
121+
<action type="fix" issue="CLI-59">No Javadoc for HelpFormatter!. </action>
122+
<action type="fix" issue="CLI-65">Parser breaks up command line parms into single characters. </action>
123+
<action type="fix" issue="CLI-67">Missing arguments in HelpFormatter.renderOptions(..). </action>
124+
<action type="fix" issue="CLI-69">Error parsing option arguments. </action>
125+
<action type="fix" issue="CLI-71">A weakness of parser. </action>
126+
<action type="add" issue="CLI-78">Setting description of a Option. </action>
127+
<action type="fix" issue="CLI-129">CLI_1_BRANCH build.xml doesn't work. </action>
128+
<action type="fix" issue="CLI-130">Remove the Commons Lang dependency. </action>
129+
<action type="fix" issue="CLI-131">Options class returns options in random order. </action>
130+
<action type="fix" issue="CLI-132">MissingOptionException should contain a useful error message. </action>
131+
<action type="fix" issue="CLI-133">NullPointerException in Util.stripLeadingHyphens when passed a null argument. </action>
132+
<action type="fix" issue="CLI-134">1.1 is not backwards compatible because it adds methods to the CommandLineParser interface. </action>
133+
<action type="fix" issue="CLI-135">Backwards compatibility between 1.1 and 1.0 broken due to Option.addValue removal. </action>
134+
135+
</release>
136+
137+
</body>
138+
</document>

‎xdocs/download_cli.xml‎

Lines changed: 145 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,145 @@
1+
<?xml version="1.0"?>
2+
<!--
3+
Licensed to the Apache Software Foundation (ASF) under one or more
4+
contributor license agreements. See the NOTICE file distributed with
5+
this work for additional information regarding copyright ownership.
6+
The ASF licenses this file to You under the Apache License, Version 2.0
7+
(the "License"); you may not use this file except in compliance with
8+
the License. You may obtain a copy of the License at
9+
10+
http://www.apache.org/licenses/LICENSE-2.0
11+
12+
Unless required by applicable law or agreed to in writing, software
13+
distributed under the License is distributed on an "AS IS" BASIS,
14+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15+
See the License for the specific language governing permissions and
16+
limitations under the License.
17+
-->
18+
<!--
19+
+======================================================================+
20+
|**** ****|
21+
|**** THIS FILE IS GENERATED BY THE COMMONS BUILD PLUGIN ****|
22+
|**** DO NOT EDIT DIRECTLY ****|
23+
|**** ****|
24+
+======================================================================+
25+
| TEMPLATE FILE: download-page-template.xml |
26+
| commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates |
27+
+======================================================================+
28+
| |
29+
| 1) Re-generate using: mvn commons:download-page |
30+
| |
31+
| 2) Set the following properties in the component's pom: |
32+
| - commons.componentid (required, alphabetic, lower case) |
33+
| - commons.release.version (required) |
34+
| - commons.binary.suffix (optional) |
35+
| (defaults to "-bin", set to "" for pre-maven2 releases) |
36+
| |
37+
| 3) Example Properties |
38+
| |
39+
| <properties> |
40+
| <commons.componentid>math</commons.componentid> |
41+
| <commons.release.version>1.2</commons.release.version> |
42+
| </properties> |
43+
| |
44+
+======================================================================+
45+
-->
46+
<document>
47+
<properties>
48+
<title>Download Commons CLI</title>
49+
<author email="dev@commons.apache.org">Commons Documentation Team</author>
50+
</properties>
51+
<body>
52+
<section name="Download Commons CLI">
53+
<p>
54+
We recommend you use a mirror to download our release
55+
builds, but you <strong>must</strong> verify the integrity of
56+
the downloaded files using signatures downloaded from our main
57+
distribution directories. Recent releases (48 hours) may not yet
58+
be available from the mirrors.
59+
</p>
60+
61+
<p>
62+
You are currently using <b>[preferred]</b>. If you
63+
encounter a problem with this mirror, please select another
64+
mirror. If all mirrors are failing, there are <i>backup</i>
65+
mirrors (at the end of the mirrors list) that should be
66+
available.
67+
<br></br>
68+
[if-any logo]<a href="[link]"><img align="right" src="[logo]" border="0"></img></a>[end]
69+
</p>
70+
71+
<form action="[location]" method="get" id="SelectMirror">
72+
<p>
73+
Other mirrors:
74+
<select name="Preferred">
75+
[if-any http]
76+
[for http]<option value="[http]">[http]</option>[end]
77+
[end]
78+
[if-any ftp]
79+
[for ftp]<option value="[ftp]">[ftp]</option>[end]
80+
[end]
81+
[if-any backup]
82+
[for backup]<option value="[backup]">[backup] (backup)</option>[end]
83+
[end]
84+
</select>
85+
<input type="submit" value="Change"></input>
86+
</p>
87+
</form>
88+
89+
<p>
90+
The <code>KEYS</code> link links to the code signing keys used to sign the product.
91+
The <code>PGP</code> link downloads the OpenPGP compatible signature from our main site.
92+
The <code>MD5</code> link downloads the checksum from the main site.
93+
</p>
94+
95+
<p>
96+
For more information concerning Commons CLI, see the
97+
<a href="index.html" class="name">Commons CLI</a> web site.
98+
</p>
99+
100+
<p>
101+
<div class="links"><span class="link"><a href="http://www.apache.org/dist/commons/KEYS">KEYS</a></span></div>
102+
<ul class="downloads">
103+
<li class="group"><div class="links"><span class="label">Binary</span></div>
104+
<ul>
105+
<li class="download"><a href="[preferred]/commons/cli/binaries/commons-cli-1.2.tar.gz">1.2.tar.gz</a>
106+
<ul class="attributes">
107+
<li><span class="md5">[<a href="http://www.apache.org/dist/commons/cli/binaries/commons-cli-1.2.tar.gz.md5">md5</a>]</span>
108+
<span class="pgp">[<a href="http://www.apache.org/dist/commons/cli/binaries/commons-cli-1.2.tar.gz.asc">pgp</a>]</span>
109+
</li>
110+
</ul>
111+
</li>
112+
<li class="download"><a href="[preferred]/commons/cli/binaries/commons-cli-1.2.zip">1.2.zip</a>
113+
<ul class="attributes">
114+
<li><span class="md5">[<a href="http://www.apache.org/dist/commons/cli/binaries/commons-cli-1.2.zip.md5">md5</a>]</span>
115+
<span class="pgp">[<a href="http://www.apache.org/dist/commons/cli/binaries/commons-cli-1.2.zip.asc">pgp</a>]</span>
116+
</li>
117+
</ul>
118+
</li>
119+
</ul>
120+
</li>
121+
<li class="group"><div class="links"><span class="label">Source</span></div>
122+
<ul>
123+
<li class="download"><a href="[preferred]/commons/cli/source/commons-cli-1.2-src.tar.gz">1.2.tar.gz</a>
124+
<ul class="attributes">
125+
<li><span class="md5">[<a href="http://www.apache.org/dist/commons/cli/source/commons-cli-1.2-src.tar.gz.md5">md5</a>]</span>
126+
<span class="pgp">[<a href="http://www.apache.org/dist/commons/cli/source/commons-cli-1.2-src.tar.gz.asc">pgp</a>]</span>
127+
</li>
128+
</ul>
129+
</li>
130+
<li class="download"><a href="[preferred]/commons/cli/source/commons-cli-1.2-src.zip">1.2.zip</a>
131+
<ul class="attributes">
132+
<li><span class="md5">[<a href="http://www.apache.org/dist/commons/cli/source/commons-cli-1.2-src.zip.md5">md5</a>]</span>
133+
<span class="pgp">[<a href="http://www.apache.org/dist/commons/cli/source/commons-cli-1.2-src.zip.asc">pgp</a>]</span>
134+
</li>
135+
</ul>
136+
</li>
137+
</ul>
138+
</li>
139+
<li class="download"><a href="[preferred]/commons/cli/">browse download area</a></li>
140+
<li><a href="http://archive.apache.org/dist/commons/cli/">archives...</a></li>
141+
</ul>
142+
</p>
143+
</section>
144+
</body>
145+
</document>

0 commit comments

Comments
 (0)