Update docs for csvsql. Rev version number (overdue).

Author: onyxfish

README

@@ -7,4 +7,5 @@ Important links:
 * Repository:    https://github.com/onyxfish/csvkit
 * Issues:        https://github.com/onyxfish/csvkit/issues
 * Documentation: http://csvkit.rtfd.org/
-* Schemas:       https://github.com/onyxfish/ffs
+* Schemas:       https://github.com/onyxfish/ffs
+* Buildbot:      http://travis-ci.org/#!/onyxfish/csvkit

docs/conf.py

@@ -54,9 +54,9 @@
 # built documents.
 #
 # The short X.Y version.
-version = '0.4.3'
+version = '0.4.4'
 # The full version, including alpha/beta/rc tags.
-release = '0.4.3 (beta)'
+release = '0.4.4 (beta)'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

docs/index.rst

@@ -130,6 +130,11 @@ License
 
 .. include:: ../COPYING
 
+Changelog
+=========
+
+.. include:: ../CHANGELOG
+
 Indices and tables
 ==================
 

docs/scripts/csvsql.rst

@@ -20,7 +20,7 @@ Generate SQL statements for a CSV file or create execute those statements direct
     Generate a SQL CREATE TABLE statement for a CSV file.
 
     positional arguments:
-      FILE                  The CSV file to operate on. If omitted, will accept
+      FILE                  The CSV file(s) to operate on. If omitted, will accept
                             input on STDIN.
 
     optional arguments:
@@ -41,6 +41,9 @@ Generate SQL statements for a CSV file or create execute those statements direct
                             omitted, the filename (minus extension) will be used.
       --no-constraints      Generate a schema without length limits or null
                             checks. Useful when sampling big tables.
+      --no-create           Skip creating a table. Only valid when --insert is
+                            specified.
+      --blanks              Do not coerce empty strings to NULL values.
 
 Also see: :doc:`common_arguments`.
 
@@ -62,3 +65,8 @@ For large tables it may not be practical to process the entire table. One soluti
     
     $ head -n 20 examples/realdata/FY09_EDU_Recipients_by_State.csv | csvsql --no-constraints --table fy09
 
+Create tables for an entire folder of CSVs and import data from those files directly into Postgres::
+
+    $ createdb test
+    $ csvsql --db postgresql:///test --insert examples/*.csv
+

docs/scripts/in2csv.rst

@@ -50,6 +50,12 @@ Convert the 2000 census geo headers file from fixed-width to CSV and from latin-
 
     $ in2csv -e iso-8859-1 -f fixed -s examples/realdata/census_2000/census2000_geo_schema.csv examples/realdata/census_2000/usgeo_excerpt.upl > usgeo.csv
 
+.. note::
+
+    A library of fixed-width schemas is maintained in the ``ffs`` project:
+
+    https://github.com/onyxfish/ffs
+
 Convert an Excel .xls file::
 
     $ in2csv examples/test.xls

setup.py

@@ -4,7 +4,7 @@
 
 setup(
     name='csvkit',
-    version='0.4.3',
+    version='0.4.4',
     description='A library of utilities for working with CSV, the king of tabular file formats.',
     long_description=open('README').read(),
     author='Christopher Groskopf',