Skip to content

Commit d3afa15

Browse files
britterbritter
committed
Prepare website for 1.0 release
git-svn-id: https://svn.apache.org/repos/asf/commons/proper/csv/trunk@1609554 13f79535-47bb-0310-9956-ffa450edef68
1 parent 4117bb4 commit d3afa15

6 files changed

Lines changed: 377 additions & 62 deletions

File tree

‎RELEASE-NOTES.txt‎

Lines changed: 89 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,89 @@
1+
Apache Commons CSV
2+
Version 1.0
3+
Release Notes
4+
5+
6+
INTRODUCTION:
7+
8+
This document contains the release notes for the 1.0 version of Apache Commons CSV.
9+
Commons CSV reads and writes files in variations of the Comma Separated Value (CSV) format.
10+
11+
CSV requires at least Java 5.0.
12+
13+
The Apache Commons CSV library provides a simple interface for reading and writing
14+
CSV files of various types.
15+
16+
First release
17+
18+
Changes in this version include:
19+
20+
NEW FEATURES
21+
==============
22+
23+
o CSV-121: IllegalArgumentException thrown when the header contains duplicate names when the column names are empty.
24+
Thanks to Sebastian Hardt.
25+
o CSV-120: CSVFormat#withHeader doesn't work with CSVPrinter Thanks to Sergei Lebedev.
26+
o CSV-119: CSVFormat is missing a print(...) method Thanks to Sergei Lebedev.
27+
o CSV-105: Add Map conversion API to CSVRecord
28+
o CSV-52: Keep track of record number
29+
o CSV-92: Need a way to extract parsed headers, e.g. for use in formatting
30+
output
31+
o CSV-65: Header support
32+
o CSV-48: Predefined format for MYSQL
33+
34+
FIXED BUGS
35+
============
36+
37+
o CSV-118: CSVRecord.toMap() throws NPE on formats with no
38+
headers. Thanks to Enrique Lara.
39+
o CSV-113: Check whether ISE/IAE are being used appropriately
40+
o CSV-114: CSVFormat constructor should reject a header array with duplicate
41+
entries
42+
o CSV-112: HeaderMap is inconsistent when it is parsed from an input with
43+
duplicate columns names
44+
o CSV-111: CSVRecord.toMap() fails if row length shorter than header length
45+
o CSV-106: CSVFormat.format allways append null
46+
o CSV-100: CSVParser: getHeaderMap throws NPE
47+
o CSV-53: CSVRecord does not verify that the length of the header mapping
48+
matches the number of values
49+
o CSV-54: Confusing semantic of the ignore leading/trailing spaces parameters
50+
o CSV-34: CSVFormat describes itself as immutable, but it is not - in
51+
particular it is not thread-safe
52+
o CSV-36: Endless loops in CSV parser
53+
o CSV-13: NullPointerException in CSVPrinter.print()/println()
54+
o CSV-23: Excel strategy uses wrong separator
55+
56+
CHANGES
57+
=========
58+
59+
o CSV-117: Validate format parameters in constructor
60+
o CSV-42: Lots of possible changes Thanks to Bob Smith.
61+
o CSV-78: Use Character instead of char for char fields except delimiter
62+
o CSV-99: Revert Builder implementation in CSVFormat
63+
o CSV-93: Allow the handling of NULL values
64+
o CSV-68: Use the Builder pattern for CSVFormat
65+
o CSV-84: Clarify comment handling
66+
o CSV-25: CSVParser.nextValue() seems pointless
67+
o CSV-97: Allow the String value for null to be customized for the CSV
68+
printer
69+
o CSV-88: Not possible to create a CSVFormat from scratch
70+
o CSV-94: Lexer should only use char fields
71+
o CSV-71: Add convenience methods to CSVLexer
72+
o CSV-59: Is CharBuffer really needed, now that StringBuilder is available?
73+
o CSV-55: Replace while(true)-loop in CSVParser.getRecord with do-while-loop
74+
o CSV-45: CSVPrinter overhaul
75+
o CSV-49: CSVStrategy has modifiable public static variables Thanks to Bob Smith.
76+
o CSV-46: Reduce visibility of methods in internal classes
77+
o CSV-26: ExtendedBufferedReader does too much
78+
o CSV-27: Decide whether to keep the csv.writer subpackage
79+
80+
81+
Historical list of changes: http://commons.apache.org/proper/commons-csv/changes-report.html
82+
83+
For complete information on Apache Commons CSV, including instructions on how to submit bug reports,
84+
patches, or suggestions for improvement, see the Apache Apache Commons CSV website:
85+
86+
http://commons.apache.org/proper/commons-csv/
87+
88+
Have fun!
89+
-Apache Commons CSV team

‎src/changes/release-notes.vm‎

Lines changed: 126 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,126 @@
1+
## Licensed to the Apache Software Foundation (ASF) under one
2+
## or more contributor license agreements. See the NOTICE file
3+
## distributed with this work for additional information
4+
## regarding copyright ownership. The ASF licenses this file
5+
## to you under the Apache License, Version 2.0 (the
6+
## "License"); you may not use this file except in compliance
7+
## with the License. You may obtain a copy of the License at
8+
##
9+
## http://www.apache.org/licenses/LICENSE-2.0
10+
##
11+
## Unless required by applicable law or agreed to in writing,
12+
## software distributed under the License is distributed on an
13+
## "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14+
## KIND, either express or implied. See the License for the
15+
## specific language governing permissions and limitations
16+
## under the License.
17+
##
18+
${project.name}
19+
Version ${version}
20+
Release Notes
21+
22+
23+
INTRODUCTION:
24+
25+
This document contains the release notes for the ${version} version of Apache Commons CSV.
26+
Commons CSV reads and writes files in variations of the Comma Separated Value (CSV) format.
27+
28+
CSV requires at least Java 5.0.
29+
30+
$introduction.replaceAll("(?<!\015)\012", "
31+
").replaceAll("(?m)^ +","")
32+
33+
## N.B. the available variables are described here:
34+
## http://maven.apache.org/plugins/maven-changes-plugin/examples/using-a-custom-announcement-template.html
35+
##
36+
## Hack to improve layout: replace all pairs of spaces with a single new-line
37+
$release.description.replaceAll(" ", "
38+
")
39+
40+
## set up indent sizes. Only change indent1
41+
#set($props=${project.properties})
42+
#set($jiralen=$props.get("commons.jira.id").length())
43+
## indent1 = POOL-nnnn:
44+
#set($blanklen=$jiralen+6)## +6 for "-nnnn:"
45+
## must be at least as long as the longest JIRA id
46+
#set($blanks=" ")
47+
#set($indent1=$blanks.substring(0,$blanklen))
48+
## indent2 allows for issue wrapper
49+
#set($indent2="$indent1 ")
50+
##
51+
#macro ( processaction )
52+
## Use replaceAll to fix up LF-only line ends on Windows.
53+
#set($action=$actionItem.getAction().replaceAll("\n","
54+
"))
55+
## Fix up indentation for multi-line action descriptions
56+
#set($action=$action.replaceAll("(?m)^ +",$indent2))
57+
#if ($actionItem.getIssue())
58+
#set($issue="$actionItem.getIssue():")
59+
## Pad shorter issue numbers
60+
#if ($issue.length() < $indent1.length())#set ($issue="$issue ")#end
61+
#if ($issue.length() < $indent1.length())#set ($issue="$issue ")#end
62+
#if ($issue.length() < $indent1.length())#set ($issue="$issue ")#end
63+
#else
64+
#set($issue=$indent1)
65+
#end
66+
#if ($actionItem.getDueTo())
67+
#set($dueto=" Thanks to $actionItem.getDueTo().")
68+
#else
69+
#set($dueto="")
70+
#end
71+
o $issue ${action}$dueto
72+
#set($action="")
73+
#set($issue="")
74+
#set($dueto="")
75+
#end
76+
##
77+
#if ($release.getActions().size() == 0)
78+
No changes defined in this version.
79+
#else
80+
Changes in this version include:
81+
82+
#if ($release.getActions('add').size() !=0)
83+
NEW FEATURES
84+
==============
85+
86+
#foreach($actionItem in $release.getActions('add'))
87+
#processaction()
88+
#end
89+
#end
90+
91+
#if ($release.getActions('fix').size() !=0)
92+
FIXED BUGS
93+
============
94+
95+
#foreach($actionItem in $release.getActions('fix'))
96+
#processaction()
97+
#end
98+
#end
99+
100+
#if ($release.getActions('update').size() !=0)
101+
CHANGES
102+
=========
103+
104+
#foreach($actionItem in $release.getActions('update'))
105+
#processaction()
106+
#end
107+
#end
108+
109+
#if ($release.getActions('remove').size() !=0)
110+
Removed:
111+
#foreach($actionItem in $release.getActions('remove'))
112+
#processaction()
113+
#end
114+
#end
115+
## End of main loop
116+
#end
117+
118+
Historical list of changes: ${project.url}changes-report.html
119+
120+
For complete information on ${project.name}, including instructions on how to submit bug reports,
121+
patches, or suggestions for improvement, see the Apache ${project.name} website:
122+
123+
${project.url}
124+
125+
Have fun!
126+
-Apache Commons CSV team

‎src/site/site.xml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@
2828

2929
<menu name="Commons CSV">
3030
<item name="Overview" href="/index.html"/>
31-
<item name="Download" href="/downloads.html"/>
31+
<item name="Download" href="/download_csv.cgi"/>
3232
<item name="Wiki" href="http://wiki.apache.org/commons/CSV"/>
3333
</menu>
3434

‎src/site/xdoc/download_csv.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+
+======================================================================+
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 Apache Commons CSV</title>
49+
<author email="dev@commons.apache.org">Commons Documentation Team</author>
50+
</properties>
51+
<body>
52+
<section name="Download Apache Commons CSV">
53+
<subsection name="Using a Mirror">
54+
<p>
55+
We recommend you use a mirror to download our release
56+
builds, but you <strong>must</strong> verify the integrity of
57+
the downloaded files using signatures downloaded from our main
58+
distribution directories. Recent releases (48 hours) may not yet
59+
be available from the mirrors.
60+
</p>
61+
62+
<p>
63+
You are currently using <b>[preferred]</b>. If you
64+
encounter a problem with this mirror, please select another
65+
mirror. If all mirrors are failing, there are <i>backup</i>
66+
mirrors (at the end of the mirrors list) that should be
67+
available.
68+
<br></br>
69+
[if-any logo]<a href="[link]"><img align="right" src="[logo]" border="0"></img></a>[end]
70+
</p>
71+
72+
<form action="[location]" method="get" id="SelectMirror">
73+
<p>
74+
Other mirrors:
75+
<select name="Preferred">
76+
[if-any http]
77+
[for http]<option value="[http]">[http]</option>[end]
78+
[end]
79+
[if-any ftp]
80+
[for ftp]<option value="[ftp]">[ftp]</option>[end]
81+
[end]
82+
[if-any backup]
83+
[for backup]<option value="[backup]">[backup] (backup)</option>[end]
84+
[end]
85+
</select>
86+
<input type="submit" value="Change"></input>
87+
</p>
88+
</form>
89+
90+
<p>
91+
The <a href="http://www.apache.org/dist/commons/KEYS">KEYS</a>
92+
link links to the code signing keys used to sign the product.
93+
The <code>PGP</code> link downloads the OpenPGP compatible signature from our main site.
94+
The <code>MD5</code> link downloads the checksum from the main site.
95+
</p>
96+
</subsection>
97+
</section>
98+
<section name="Apache Commons CSV 1.0 ">
99+
<subsection name="Binaries">
100+
<table>
101+
<tr>
102+
<td><a href="[preferred]/commons/csv/binaries/commons-csv-1.0-bin.tar.gz">commons-csv-1.0-bin.tar.gz</a></td>
103+
<td><a href="http://www.apache.org/dist/commons/csv/binaries/commons-csv-1.0-bin.tar.gz.md5">md5</a></td>
104+
<td><a href="http://www.apache.org/dist/commons/csv/binaries/commons-csv-1.0-bin.tar.gz.asc">pgp</a></td>
105+
</tr>
106+
<tr>
107+
<td><a href="[preferred]/commons/csv/binaries/commons-csv-1.0-bin.zip">commons-csv-1.0-bin.zip</a></td>
108+
<td><a href="http://www.apache.org/dist/commons/csv/binaries/commons-csv-1.0-bin.zip.md5">md5</a></td>
109+
<td><a href="http://www.apache.org/dist/commons/csv/binaries/commons-csv-1.0-bin.zip.asc">pgp</a></td>
110+
</tr>
111+
</table>
112+
</subsection>
113+
<subsection name="Source">
114+
<table>
115+
<tr>
116+
<td><a href="[preferred]/commons/csv/source/commons-csv-1.0-src.tar.gz">commons-csv-1.0-src.tar.gz</a></td>
117+
<td><a href="http://www.apache.org/dist/commons/csv/source/commons-csv-1.0-src.tar.gz.md5">md5</a></td>
118+
<td><a href="http://www.apache.org/dist/commons/csv/source/commons-csv-1.0-src.tar.gz.asc">pgp</a></td>
119+
</tr>
120+
<tr>
121+
<td><a href="[preferred]/commons/csv/source/commons-csv-1.0-src.zip">commons-csv-1.0-src.zip</a></td>
122+
<td><a href="http://www.apache.org/dist/commons/csv/source/commons-csv-1.0-src.zip.md5">md5</a></td>
123+
<td><a href="http://www.apache.org/dist/commons/csv/source/commons-csv-1.0-src.zip.asc">pgp</a></td>
124+
</tr>
125+
</table>
126+
</subsection>
127+
</section>
128+
<section name="Archives">
129+
<p>
130+
Older releases can be obtained from the archives.
131+
</p>
132+
<ul>
133+
<li class="download"><a href="[preferred]/commons/csv/">browse download area</a></li>
134+
<li><a href="http://archive.apache.org/dist/commons/csv/">archives...</a></li>
135+
</ul>
136+
</section>
137+
</body>
138+
</document>

0 commit comments

Comments
 (0)