📝 update README.rst

Author: techouse

docs/README.rst

@@ -1,43 +1,54 @@
 Usage
 -----
 
-Transfer SQLite to MySQL using the provided CLI options.
+The command line options for the ``sqlite3mysql`` tool are as follows:
+
+.. code-block:: bash
+
+   sqlite3mysql [OPTIONS]
 
 Options
 ^^^^^^^
 
-SQLite Options
-~~~~~~~~~~~~~~
+Required Options
+""""""""""""""""
 
 - ``-f, --sqlite-file PATH``: SQLite3 database file  [required]
+- ``-d, --mysql-database TEXT``: MySQL database name  [required]
+- ``-u, --mysql-user TEXT``: MySQL user  [required]
+
+Password Options
+""""""""""""""""
+
+- ``-p, --prompt-mysql-password``: Prompt for MySQL password
+- ``--mysql-password TEXT``: MySQL password
+
+Table Options
+""""""""""""""
+
 - ``-t, --sqlite-tables TUPLE``: Transfer only these specific tables (space separated table names). Implies ``--without-foreign-keys`` which inhibits the transfer of foreign keys.
 - ``-X, --without-foreign-keys``: Do not transfer foreign keys.
 - ``-W, --ignore-duplicate-keys``: Ignore duplicate keys. The default behavior is to create new ones with a numerical suffix, e.g. 'existing_key' -> 'existing_key_1'
+- ``-E, --mysql-truncate-tables``: Truncates existing tables before inserting data.
 
-MySQL Options
-~~~~~~~~~~~~~
+Transfer Options
+""""""""""""""""
+
+- ``-i, --mysql-insert-method [UPDATE|IGNORE|DEFAULT]``: MySQL insert method. DEFAULT will throw errors when encountering duplicate records; UPDATE will update existing rows; IGNORE will ignore insert errors. Defaults to IGNORE.
+- ``--with-rowid``: Transfer rowid columns.
+- ``-c, --chunk INTEGER``: Chunk reading/writing SQL records
+
+Connection Options
+""""""""""""""""""
 
-- ``-d, --mysql-database TEXT``: MySQL database name  [required]
-- ``-u, --mysql-user TEXT``: MySQL user  [required]
-- ``-p, --prompt-mysql-password``: Prompt for MySQL password
-- ``--mysql-password TEXT``: MySQL password
 - ``-h, --mysql-host TEXT``: MySQL host. Defaults to localhost.
 - ``-P, --mysql-port INTEGER``: MySQL port. Defaults to 3306.
 - ``-S, --skip-ssl``: Disable MySQL connection encryption.
-- ``-i, --mysql-insert-method [UPDATE|IGNORE|DEFAULT]``: MySQL insert method. DEFAULT will throw errors when encountering duplicate records; UPDATE will update existing rows; IGNORE will ignore insert errors. Defaults to IGNORE.
-- ``-E, --mysql-truncate-tables``: Truncates existing tables before inserting data.
-- ``--mysql-integer-type TEXT``: MySQL default integer field type. Defaults to INT(11).
-- ``--mysql-string-type TEXT``: MySQL default string field type. Defaults to VARCHAR(255).
-- ``--mysql-text-type [MEDIUMTEXT|TEXT|TINYTEXT|LONGTEXT]``: MySQL default text field type. Defaults to TEXT.
-- ``--mysql-charset TEXT``: MySQL database and table character set [default: utf8mb4]
-- ``--mysql-collation TEXT``: MySQL database and table collation
 
 Other Options
-~~~~~~~~~~~~~
+""""""""""""""
 
 - ``-T, --use-fulltext``: Use FULLTEXT indexes on TEXT columns. Will throw an error if your MySQL version does not support InnoDB FULLTEXT indexes!
-- ``--with-rowid``: Transfer rowid columns.
-- ``-c, --chunk INTEGER``: Chunk reading/writing SQL records
 - ``-l, --log-file PATH``: Log file
 - ``-q, --quiet``: Quiet. Display only errors.
 - ``--debug``: Debug mode. Will throw exceptions.