commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From brit...@apache.org
Subject svn commit: r1609554 - in /commons/proper/csv/trunk: RELEASE-NOTES.txt src/changes/release-notes.vm src/site/site.xml src/site/xdoc/download_csv.xml src/site/xdoc/downloads.xml src/site/xdoc/index.xml
Date Thu, 10 Jul 2014 19:15:53 GMT
Author: britter
Date: Thu Jul 10 19:15:53 2014
New Revision: 1609554

URL: http://svn.apache.org/r1609554
Log:
Prepare website for 1.0 release

Added:
    commons/proper/csv/trunk/RELEASE-NOTES.txt   (with props)
    commons/proper/csv/trunk/src/changes/release-notes.vm   (with props)
    commons/proper/csv/trunk/src/site/xdoc/download_csv.xml   (with props)
Removed:
    commons/proper/csv/trunk/src/site/xdoc/downloads.xml
Modified:
    commons/proper/csv/trunk/src/site/site.xml
    commons/proper/csv/trunk/src/site/xdoc/index.xml

Added: commons/proper/csv/trunk/RELEASE-NOTES.txt
URL: http://svn.apache.org/viewvc/commons/proper/csv/trunk/RELEASE-NOTES.txt?rev=1609554&view=auto
==============================================================================
--- commons/proper/csv/trunk/RELEASE-NOTES.txt (added)
+++ commons/proper/csv/trunk/RELEASE-NOTES.txt Thu Jul 10 19:15:53 2014
@@ -0,0 +1,89 @@
+                        Apache Commons CSV
+                           Version 1.0
+                          Release Notes
+
+
+INTRODUCTION:
+
+This document contains the release notes for the 1.0 version of Apache Commons CSV.
+Commons CSV reads and writes files in variations of the Comma Separated Value (CSV) format.
+
+CSV requires at least Java 5.0.
+
+The Apache Commons CSV library provides a simple interface for reading and writing
+CSV files of various types.
+
+First release
+
+Changes in this version include:
+
+NEW FEATURES
+==============
+
+o CSV-121:  IllegalArgumentException thrown when the header contains duplicate names when
the column names are empty.
+            Thanks to Sebastian Hardt.
+o CSV-120:  CSVFormat#withHeader doesn't work with CSVPrinter Thanks to Sergei Lebedev.
+o CSV-119:  CSVFormat is missing a print(...) method Thanks to Sergei Lebedev.
+o CSV-105:  Add Map conversion API to CSVRecord
+o CSV-52:   Keep track of record number
+o CSV-92:   Need a way to extract parsed headers, e.g. for use in formatting
+            output
+o CSV-65:   Header support
+o CSV-48:   Predefined format for MYSQL
+
+FIXED BUGS
+============
+
+o CSV-118:  CSVRecord.toMap() throws NPE on formats with no
+            headers. Thanks to Enrique Lara.
+o CSV-113:  Check whether ISE/IAE are being used appropriately
+o CSV-114:  CSVFormat constructor should reject a header array with duplicate
+            entries
+o CSV-112:  HeaderMap is inconsistent when it is parsed from an input with
+            duplicate columns names
+o CSV-111:  CSVRecord.toMap() fails if row length shorter than header length
+o CSV-106:  CSVFormat.format allways append null
+o CSV-100:  CSVParser: getHeaderMap throws NPE
+o CSV-53:   CSVRecord does not verify that the length of the header mapping
+            matches the number of values
+o CSV-54:   Confusing semantic of the ignore leading/trailing spaces parameters
+o CSV-34:   CSVFormat describes itself as immutable, but it is not - in
+            particular it is not thread-safe
+o CSV-36:   Endless loops in CSV parser
+o CSV-13:   NullPointerException in CSVPrinter.print()/println()
+o CSV-23:   Excel strategy uses wrong separator
+
+CHANGES
+=========
+
+o CSV-117:  Validate format parameters in constructor
+o CSV-42:   Lots of possible changes Thanks to Bob Smith.
+o CSV-78:   Use Character instead of char for char fields except delimiter
+o CSV-99:   Revert Builder implementation in CSVFormat
+o CSV-93:   Allow the handling of NULL values
+o CSV-68:   Use the Builder pattern for CSVFormat
+o CSV-84:   Clarify comment handling
+o CSV-25:   CSVParser.nextValue() seems pointless
+o CSV-97:   Allow the String value for null to be customized for the CSV
+            printer
+o CSV-88:   Not possible to create a CSVFormat from scratch
+o CSV-94:   Lexer should only use char fields
+o CSV-71:   Add convenience methods to CSVLexer
+o CSV-59:   Is CharBuffer really needed, now that StringBuilder is available?
+o CSV-55:   Replace while(true)-loop in CSVParser.getRecord with do-while-loop
+o CSV-45:   CSVPrinter overhaul
+o CSV-49:   CSVStrategy has modifiable public static variables Thanks to Bob Smith.
+o CSV-46:   Reduce visibility of methods in internal classes
+o CSV-26:   ExtendedBufferedReader does too much
+o CSV-27:   Decide whether to keep the csv.writer subpackage
+
+
+Historical list of changes: http://commons.apache.org/proper/commons-csv/changes-report.html
+
+For complete information on Apache Commons CSV, including instructions on how to submit bug
reports,
+patches, or suggestions for improvement, see the Apache Apache Commons CSV website:
+
+http://commons.apache.org/proper/commons-csv/
+
+Have fun!
+-Apache Commons CSV team
\ No newline at end of file

Propchange: commons/proper/csv/trunk/RELEASE-NOTES.txt
------------------------------------------------------------------------------
    svn:eol-style = native

Added: commons/proper/csv/trunk/src/changes/release-notes.vm
URL: http://svn.apache.org/viewvc/commons/proper/csv/trunk/src/changes/release-notes.vm?rev=1609554&view=auto
==============================================================================
--- commons/proper/csv/trunk/src/changes/release-notes.vm (added)
+++ commons/proper/csv/trunk/src/changes/release-notes.vm Thu Jul 10 19:15:53 2014
@@ -0,0 +1,126 @@
+## Licensed to the Apache Software Foundation (ASF) under one
+## or more contributor license agreements.  See the NOTICE file
+## distributed with this work for additional information
+## regarding copyright ownership.  The ASF licenses this file
+## to you under the Apache License, Version 2.0 (the
+## "License"); you may not use this file except in compliance
+## with the License.  You may obtain a copy of the License at
+##
+##  http://www.apache.org/licenses/LICENSE-2.0
+##
+## Unless required by applicable law or agreed to in writing,
+## software distributed under the License is distributed on an
+## "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+## KIND, either express or implied.  See the License for the
+## specific language governing permissions and limitations
+## under the License.
+##
+                        ${project.name}
+                            Version ${version}
+                           Release Notes
+
+
+INTRODUCTION:
+
+This document contains the release notes for the ${version} version of Apache Commons CSV.
+Commons CSV reads and writes files in variations of the Comma Separated Value (CSV) format.
+
+CSV requires at least Java 5.0.
+
+$introduction.replaceAll("(?<!\015)\012", "
+").replaceAll("(?m)^ +","")
+
+## N.B. the available variables are described here:
+## http://maven.apache.org/plugins/maven-changes-plugin/examples/using-a-custom-announcement-template.html
+##
+## Hack to improve layout: replace all pairs of spaces with a single new-line
+$release.description.replaceAll("  ", "
+")
+
+## set up indent sizes. Only change indent1
+#set($props=${project.properties})
+#set($jiralen=$props.get("commons.jira.id").length())
+## indent1 =   POOL-nnnn:
+#set($blanklen=$jiralen+6)## +6 for "-nnnn:"
+## must be at least as long as the longest JIRA id
+#set($blanks="                                  ")
+#set($indent1=$blanks.substring(0,$blanklen))
+## indent2 allows for issue wrapper
+#set($indent2="$indent1   ")
+##
+#macro ( processaction )
+## Use replaceAll to fix up LF-only line ends on Windows.
+#set($action=$actionItem.getAction().replaceAll("\n","
+"))
+## Fix up indentation for multi-line action descriptions
+#set($action=$action.replaceAll("(?m)^  +",$indent2))
+#if ($actionItem.getIssue())
+#set($issue="$actionItem.getIssue():")
+## Pad shorter issue numbers
+#if ($issue.length() < $indent1.length())#set ($issue="$issue ")#end
+#if ($issue.length() < $indent1.length())#set ($issue="$issue ")#end
+#if ($issue.length() < $indent1.length())#set ($issue="$issue ")#end
+#else
+#set($issue=$indent1)
+#end
+#if ($actionItem.getDueTo())
+#set($dueto=" Thanks to $actionItem.getDueTo().")
+#else
+#set($dueto="")
+#end
+o $issue ${action}$dueto
+#set($action="")
+#set($issue="")
+#set($dueto="")
+#end
+##
+#if ($release.getActions().size() == 0)
+No changes defined in this version.
+#else
+Changes in this version include:
+
+#if ($release.getActions('add').size() !=0)
+NEW FEATURES
+==============
+
+#foreach($actionItem in $release.getActions('add'))
+#processaction()
+#end 
+#end
+
+#if ($release.getActions('fix').size() !=0)
+FIXED BUGS
+============
+
+#foreach($actionItem in $release.getActions('fix'))
+#processaction()
+#end
+#end
+
+#if ($release.getActions('update').size() !=0)
+CHANGES
+=========
+
+#foreach($actionItem in $release.getActions('update'))
+#processaction()
+#end
+#end
+
+#if ($release.getActions('remove').size() !=0)
+Removed:
+#foreach($actionItem in $release.getActions('remove'))
+#processaction()
+#end
+#end
+## End of main loop
+#end
+
+Historical list of changes: ${project.url}changes-report.html
+
+For complete information on ${project.name}, including instructions on how to submit bug
reports,
+patches, or suggestions for improvement, see the Apache ${project.name} website:
+
+${project.url}
+
+Have fun!
+-Apache Commons CSV team
\ No newline at end of file

Propchange: commons/proper/csv/trunk/src/changes/release-notes.vm
------------------------------------------------------------------------------
    svn:eol-style = native

Modified: commons/proper/csv/trunk/src/site/site.xml
URL: http://svn.apache.org/viewvc/commons/proper/csv/trunk/src/site/site.xml?rev=1609554&r1=1609553&r2=1609554&view=diff
==============================================================================
--- commons/proper/csv/trunk/src/site/site.xml (original)
+++ commons/proper/csv/trunk/src/site/site.xml Thu Jul 10 19:15:53 2014
@@ -28,7 +28,7 @@
 
     <menu name="Commons CSV">
       <item name="Overview"    href="/index.html"/>
-      <item name="Download"    href="/downloads.html"/>
+      <item name="Download"    href="/download_csv.cgi"/>
       <item name="Wiki"        href="http://wiki.apache.org/commons/CSV"/>
     </menu>
 

Added: commons/proper/csv/trunk/src/site/xdoc/download_csv.xml
URL: http://svn.apache.org/viewvc/commons/proper/csv/trunk/src/site/xdoc/download_csv.xml?rev=1609554&view=auto
==============================================================================
--- commons/proper/csv/trunk/src/site/xdoc/download_csv.xml (added)
+++ commons/proper/csv/trunk/src/site/xdoc/download_csv.xml Thu Jul 10 19:15:53 2014
@@ -0,0 +1,138 @@
+<?xml version="1.0"?>
+<!--
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<!--
+ +======================================================================+
+ |****                                                              ****|
+ |****      THIS FILE IS GENERATED BY THE COMMONS BUILD PLUGIN      ****|
+ |****                    DO NOT EDIT DIRECTLY                      ****|
+ |****                                                              ****|
+ +======================================================================+
+ | TEMPLATE FILE: download-page-template.xml                            |
+ | commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates |
+ +======================================================================+
+ |                                                                      |
+ | 1) Re-generate using: mvn commons:download-page                      |
+ |                                                                      |
+ | 2) Set the following properties in the component's pom:              |
+ |    - commons.componentid (required, alphabetic, lower case)          |
+ |    - commons.release.version (required)                              |
+ |    - commons.binary.suffix (optional)                                |
+ |      (defaults to "-bin", set to "" for pre-maven2 releases)         |
+ |                                                                      |
+ | 3) Example Properties                                                |
+ |                                                                      |
+ |  <properties>                                                        |
+ |    <commons.componentid>math</commons.componentid>                   |
+ |    <commons.release.version>1.2</commons.release.version>            |
+ |  </properties>                                                       |
+ |                                                                      |
+ +======================================================================+
+-->
+<document>
+  <properties>
+    <title>Download Apache Commons CSV</title>
+    <author email="dev@commons.apache.org">Commons Documentation Team</author>
+  </properties>
+  <body>
+    <section name="Download Apache Commons CSV">
+    <subsection name="Using a Mirror">
+      <p>
+        We recommend you use a mirror to download our release
+        builds, but you <strong>must</strong> verify the integrity of
+        the downloaded files using signatures downloaded from our main
+        distribution directories. Recent releases (48 hours) may not yet
+        be available from the mirrors.
+      </p>
+
+      <p>
+        You are currently using <b>[preferred]</b>.  If you
+        encounter a problem with this mirror, please select another
+        mirror.  If all mirrors are failing, there are <i>backup</i>
+        mirrors (at the end of the mirrors list) that should be
+        available.
+        <br></br>
+        [if-any logo]<a href="[link]"><img align="right" src="[logo]" border="0"></img></a>[end]
+      </p>
+
+      <form action="[location]" method="get" id="SelectMirror">
+        <p>
+          Other mirrors:
+          <select name="Preferred">
+          [if-any http]
+            [for http]<option value="[http]">[http]</option>[end]
+          [end]
+          [if-any ftp]
+            [for ftp]<option value="[ftp]">[ftp]</option>[end]
+          [end]
+          [if-any backup]
+            [for backup]<option value="[backup]">[backup] (backup)</option>[end]
+          [end]
+          </select>
+          <input type="submit" value="Change"></input>
+        </p>
+      </form>
+
+      <p>
+        The <a href="http://www.apache.org/dist/commons/KEYS">KEYS</a>
+        link links to the code signing keys used to sign the product.
+        The <code>PGP</code> link downloads the OpenPGP compatible signature
from our main site.
+        The <code>MD5</code> link downloads the checksum from the main site.
+      </p>
+    </subsection>
+    </section>
+    <section name="Apache Commons CSV 1.0 ">
+      <subsection name="Binaries">
+        <table>
+          <tr>
+              <td><a href="[preferred]/commons/csv/binaries/commons-csv-1.0-bin.tar.gz">commons-csv-1.0-bin.tar.gz</a></td>
+              <td><a href="http://www.apache.org/dist/commons/csv/binaries/commons-csv-1.0-bin.tar.gz.md5">md5</a></td>
+              <td><a href="http://www.apache.org/dist/commons/csv/binaries/commons-csv-1.0-bin.tar.gz.asc">pgp</a></td>
+          </tr>
+          <tr>
+              <td><a href="[preferred]/commons/csv/binaries/commons-csv-1.0-bin.zip">commons-csv-1.0-bin.zip</a></td>
+              <td><a href="http://www.apache.org/dist/commons/csv/binaries/commons-csv-1.0-bin.zip.md5">md5</a></td>
+              <td><a href="http://www.apache.org/dist/commons/csv/binaries/commons-csv-1.0-bin.zip.asc">pgp</a></td>
+          </tr>
+        </table>
+      </subsection>
+      <subsection name="Source">
+        <table>
+          <tr>
+              <td><a href="[preferred]/commons/csv/source/commons-csv-1.0-src.tar.gz">commons-csv-1.0-src.tar.gz</a></td>
+              <td><a href="http://www.apache.org/dist/commons/csv/source/commons-csv-1.0-src.tar.gz.md5">md5</a></td>
+              <td><a href="http://www.apache.org/dist/commons/csv/source/commons-csv-1.0-src.tar.gz.asc">pgp</a></td>
+          </tr>
+          <tr>
+              <td><a href="[preferred]/commons/csv/source/commons-csv-1.0-src.zip">commons-csv-1.0-src.zip</a></td>
+              <td><a href="http://www.apache.org/dist/commons/csv/source/commons-csv-1.0-src.zip.md5">md5</a></td>
+              <td><a href="http://www.apache.org/dist/commons/csv/source/commons-csv-1.0-src.zip.asc">pgp</a></td>
+          </tr>
+        </table>
+      </subsection>
+    </section>
+    <section name="Archives">
+        <p>
+          Older releases can be obtained from the archives.
+        </p>
+        <ul>
+          <li class="download"><a href="[preferred]/commons/csv/">browse download
area</a></li>
+          <li><a href="http://archive.apache.org/dist/commons/csv/">archives...</a></li>
+        </ul>
+    </section>
+  </body>
+</document>

Propchange: commons/proper/csv/trunk/src/site/xdoc/download_csv.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Modified: commons/proper/csv/trunk/src/site/xdoc/index.xml
URL: http://svn.apache.org/viewvc/commons/proper/csv/trunk/src/site/xdoc/index.xml?rev=1609554&r1=1609553&r2=1609554&view=diff
==============================================================================
--- commons/proper/csv/trunk/src/site/xdoc/index.xml (original)
+++ commons/proper/csv/trunk/src/site/xdoc/index.xml Thu Jul 10 19:15:53 2014
@@ -56,10 +56,29 @@ try {
 }</source>
 </section>
 
-<section name="Getting the code">
-  <p>There are currently no official downloads, and will not be until version 1.0 is
released.</p>
-  <p>The latest code can be checked out from our Subversion repository at <a href="http://svn.apache.org/repos/asf/commons/proper/csv/trunk/">http://svn.apache.org/repos/asf/commons/proper/csv/trunk/</a>.
</p>
-  <p>You can build the component using Apache Maven. For example: mvn clean package.</p>
+<!-- ================================================== -->
+<section name="Release Information">
+<p>The latest stable release of csv is 1.0. You may: </p>
+<ul>
+  <li>Download <a href="http://commons.apache.org/csv/download_csv.cgi">1.0</a></li>
+  <li>Read the <a href="release-notes/RELEASE-NOTES-1.0.txt">1.0 release notes</a></li>
+</ul>
+<p>
+  Alternatively you can pull it from the central Maven repositories:
+  <pre>
+    &lt;groupId&gt;org.apache.commons&lt;/groupId&gt;
+    &lt;artifactId&gt;commons-csv&lt;/artifactId&gt;
+    &lt;version&gt;1.0&lt;/version&gt;
+  </pre>
+</p>
+</section>
+
+<section name="Building from sources">
+  <p>The latest code can be checked out from our Subversion repository at <a href="http://svn.apache.org/repos/asf/commons/proper/csv/trunk/">http://svn.apache.org/repos/asf/commons/proper/csv/trunk/</a>.
+    You can build the component using Apache Maven using <code>mvn clean package</code>.
+  </p>
+  <p>Note that building the website currently does not work when building with JDK
8.
+    This is due to incompatibilities between JDK 8 and the <a href="http://mojo.codehaus.org/findbugs-maven-plugin/">maven-findbugs-plugin</a>.</p>
 </section>
 <!-- ================================================== -->
 <section name="Getting Involved">



Mime
View raw message