]> git.phdru.name Git - sqlconvert.git/blobdiff - docs/index.rst
Rename mysql2sql -> sqlconvert
[sqlconvert.git] / docs / index.rst
index 49cb311151e8825fa19315cc6b91e54dcf2e4a1d..46e6c4592324f04f88b8327e118745759792b220 100644 (file)
@@ -1,53 +1,26 @@
-.. mysql2sql documentation master file, created by
+.. sqlconvert documentation master file, created by
    sphinx-quickstart on Fri Jul 22 19:32:24 2016.
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-Welcome to mysql2sql's documentation!
+Welcome to sqlconvert's documentation!
 =====================================
 
-This is mysql2sql, a mysql to sql converter. It is primary intended to
-convert mysqldump (especially with extended INSERT syntax) to standard
-SQL to load at least to PostgreSQL or SQLite.
-
-It uses `sqlparse <https://github.com/andialbrecht/sqlparse>`_ to parse
-SQL.
+This is sqlconvert, a library to implenet SQL converters. It uses `sqlparse
+<https://github.com/andialbrecht/sqlparse>`_ to parse SQL.
 
 The program is in its initial phase and currently cannot do much.
 
-.. highlight:: none
-
-Command line
-------------
-
-mysql-to-sql.py
-~~~~~~~~~~~~~~~
-
-Usage::
-
-    mysql-to-sql.py [-e encoding] [-E output_encoding] [infile] [[-o] outfile]
-
-Options::
-
-   -e ENCODING, --encoding ENCODING
-                           input/output encoding, default is utf-8
-   -E OUTPUT_ENCODING, --output-encoding OUTPUT_ENCODING
-                           separate output encoding, default is the same as
-                           `-e` except for console; for console output charset
-                           from the current locale is used
-    infile                 Input file, stdin if absent or '-'
-    -o, --outfile outfile  Output file, stdout if absent or '-'
-
-Option `-o` is useful when infile is absent (input is redirected), for
-example::
+The first goal is to implemet `mysq2sql <mysq2sql.html>`_, a script intended
+primarily to convert mysqldump (especially with extended INSERT syntax) to
+standard SQL to load at least to PostgreSQL or SQLite.
 
-    mysql-to-sql.py -o outfile.sql < infile.sql
-    cat infile.sql | mysql-to-sql.py -o outfile.sql
+Contents:
 
-But of course it simple can be::
+.. toctree::
+   :maxdepth: 2
 
-    mysql-to-sql.py - outfile.sql < infile.sql
-    cat infile.sql | mysql-to-sql.py - outfile.sql
+   mysq2sql
 
 
 Indices and tables