From 6cf4a36a4e2e4b69ed59b6f9637bebf11eea053e Mon Sep 17 00:00:00 2001
From: Emmanuel Bourg <ebourg@apache.org>
Date: Tue, 6 Mar 2012 11:20:36 +0000
Subject: [PATCH] Added a note in the Javadoc explaining the issue with the
 value separator for the Excel format (SANDBOX-263)

git-svn-id: https://svn.apache.org/repos/asf/commons/sandbox/csv/trunk@1297429 13f79535-47bb-0310-9956-ffa450edef68
---
 src/main/java/org/apache/commons/csv/CSVFormat.java | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/src/main/java/org/apache/commons/csv/CSVFormat.java b/src/main/java/org/apache/commons/csv/CSVFormat.java
index bc61cef0..2a776c32 100644
--- a/src/main/java/org/apache/commons/csv/CSVFormat.java
+++ b/src/main/java/org/apache/commons/csv/CSVFormat.java
@@ -51,7 +51,17 @@ public class CSVFormat implements Cloneable, Serializable {
     /** Standard comma separated format as defined by <a href="http://tools.ietf.org/html/rfc4180">RFC 4180</a>. */
     public static final CSVFormat DEFAULT = new CSVFormat(',', '"', DISABLED, DISABLED, true, true, false, true);
 
-    /** Excel file format (using a comma as the value delimiter). */
+    /**
+     * Excel file format (using a comma as the value delimiter).
+     * Note that the actual value delimiter used by Excel is locale dependent,
+     * it might be necessary to customize this format to accomodate to your
+     * regional settings.
+     * <p/>
+     * For example for parsing or generating a CSV file on a French system
+     * the following format will be used:
+     * 
+     * <pre>CSVFormat fmt = CSVFormat.EXCEL.withDelimiter(';');</pre>
+     */
     public static final CSVFormat EXCEL = new CSVFormat(',', '"', DISABLED, DISABLED, false, false, false, false);
 
     /** Tabulation delimited format. */