-The lists consist of the following five tokens: `user', `password',
-`database', `server', and `port'. The order in which they appear is
-the order in which they are prompted. The tokens symbols can be
-replaced by a sublist starting with the token and followed by a plist
-which control the prompting for values. The tokens `user',
-`database', and `server' each can take a property of :default which
-specifies the value to be used if no value is entered. The
-`database', `server', and `port' tokens handle the :completion
-property which restricts the entry to either one of the values in the
-list or to one of the values returned by the function provided as the
-property value. The `database' and `server' tokens also accept the
-:file property whose value is a regexp to identify useful file names.
-
- (user :default DEF)
- (database :default DEF
- :file FILEPAT
- :completion COMPLETE)
- (server :default DEF
- :file FILEPAT
- :completion COMPLETE)
-
-The FILEPAT when :file is specified is a regexp that will match valid
-file names (without the directory portion). Generally these strings
-will be of the form ".+\.SUF" where SUF is the desired file suffix.
-
-When :completion is specified, the COMPLETE corresponds to the
-PREDICATE argument to the `completing-read' function (a list of
-possible values or a function returning such a list).
-
-*** Added `sql-connection-alist' to record login parameter values.
-An alist for recording different username, database and server
-values. If there are multiple databases that you connect to the
-parameters needed can be stored in this alist.
-
-For example, the following might be set in the user's init.el:
-
- (setq sql-connection-alist
- '((dev (sql-product 'sqlite)
- (sql-database "/home/mmaug/dev.db"))
- (prd (sql-product 'oracle)
- (sql-user "mmaug")
- (sql-database "iprd2a"))))
-
-This defines two connections named "dev" and "prd".
-
-*** Added `sql-connect' to use predefined connections.
-Sets the login parameters based on the values in the
-`sql-connection-alist' and start a SQL interactive session. Any
-values specified in the connection will not be prompted for.
-
-In the example above, if the user were to invoke M-x sql-connect, they
-would be prompted for the connection. The user can respond with
-either "dev" or "prd". The "dev" connection would connect to the
-SQLite database without prompting; the "prd" connection would prompt
-for the users password and then connect to the Oracle database.
-
-**** Added SQL->Start... submenu when connections are defined.
-When connections have been defined, there is a submenu available that
-allows the user to select one to start a SQLi session. The "Start
-SQLi Session" item moves to the "Start..." submenu when cnnections
-have been defined.
-
-**** Added "Save Connection" menu item in SQLi buffers.
-When a SQLi session is not started by a connection then
-`sql-save-connection' will gather the login params specified for the
-session and save them as a new connection.
-
-*** List database objects and details.
-Once a SQL interactive session has been started, you can get a list of
-the objects in the database and see details of those objects. The
-objects shown and the details available are product specific.
-
-**** List all objects.
-Using `M-x sql-list-all', `C-c C-l a' or selecting "SQL->List all
-objects" will list all the objects in the database. At a minimum it
-lists the tables and views in the database. Preceding the command by
-universal argument may provide additional details or extend the
-listing to include other schemas objects. The list will appear in a
-separate window in view-mode.
-
-**** List Table details.
-Using `M-x sql-list-table', `C-c C-l t' or selecting "SQL->List Table
-details" will ask for the name of a database table or view and display
-the list of columns in the relation. Preceding the command with the
-universal argument may provide additional details about each column.
-The list will appear in a separate window in view-mode.
-
-*** Added option `sql-send-terminator'.
-When set makes sure that each command sent with `sql-send-*' commands
-are properly terminated and submitted to the SQL processor.
-
-*** Added option `sql-oracle-scan-on'.
-When set commands sent to Oracle's SQL*Plus are scanned for strings
-starting with an ampersand and the user is asked for replacement text.
-In general, the SQL*Plus option SCAN should always be set OFF under
-SQL interactive mode and this option used in its place.
-
-*** SQL interactive mode will replace tabs with spaces.
-This prevents the command interpreter for MySQL and Postgres from
-listing object name completions when being sent text via
-`sql-send-*' functions.