summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGravatar Miika Turkia <miika.turkia@gmail.com>2015-01-05 10:53:25 +0200
committerGravatar Dirk Hohndel <dirk@hohndel.org>2015-01-05 09:14:08 -0800
commit27bfbee4e8c3644dedea61f67338dcb2b83ffbed (patch)
tree935b81f1a3bae7d3ccf03e1b7e7628fa02a4ac7e
parent4dff1e7b93878627739d87e487d816637c7193e8 (diff)
downloadsubsurface-27bfbee4e8c3644dedea61f67338dcb2b83ffbed.tar.gz
Caveats of CSV import added to documentation
Signed-off-by: Miika Turkia <miika.turkia@gmail.com> Signed-off-by: Dirk Hohndel <dirk@hohndel.org>
-rw-r--r--Documentation/user-manual.txt10
1 files changed, 10 insertions, 0 deletions
diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt
index d8b559ea3..9cbc4cca3 100644
--- a/Documentation/user-manual.txt
+++ b/Documentation/user-manual.txt
@@ -1091,6 +1091,16 @@ image::images/Divelogs1.jpg["FIGURE:Download from Divelogs.de",align="center"]
A comma-separated file (.csv) can be used to import dive information either as dive profiles (as in the case of the APD Inspiration and Evolution closed circuit rebreathers) or as dive metadata (in case the user keeps dive data in a spreadsheet). For
an introduction to CSV-formatted files see xref:S_CSV_Intro[A Diver's Introduction To CSV Files].
+[icon="images/icons/important.png"]
+[IMPORTANT]
+The CSV import has a couple of caveats. You should avoid some special characters
+like ampersand (&) and double quotes ("), the latter if quoting text cells. The
+file should use UTF-8 character set, if having non-ASCII characters. Also the
+size of the CSV file might cause problems. Importing 100 dives at a time
+(without dive profile) has worked previously, but larger files might exceed
+limits of the parser used. When having problems with CSV imports, try first with
+a smaller sample to make sure everything works.
+
[[S_ImportingCSVDives]]
===== Importing dives in CSV format from dive computers or other dive log software