-This handbook presumes you have :doc:`installed <admin/install>` HTSQL
-and have had a chance to skim our :doc:`overview <overview>` to get a
-taste of HTSQL. We also assume that you have a GNU/Linux based system,
-although Cygwin, OSX or FreeBSD might work with only a few tweaks.
-If you need help, please see our `HTSQL Community
-<http://htsql.org/community/>`_ page for assistance.
+This handbook presumes you have :doc:`installed <admin/install>` HTSQL.
+It also assumes that you have a GNU/Linux based system, although other
+systems might also work. If you need help, please see our `HTSQL
+Community <http://htsql.org/community/>`_ page for assistance.
-In this section we work through the basics of ``htsql-ctl``. For
-starters, you should be able to print the ``version`` information
+To verify your installation, try the ``htsql-ctl`` command line
+utility's ``version`` or ``help`` routine::
-If ``htsql-ctl`` isn't found or it doesn't work, then you have an
-installation issue and should fix that first.
+If ``htsql-ctl`` isn't found or it doesn't work, you have an
-The HTSQL interpreter requires a database, passed as a database URI on
-the command line. The built-in SQLite database adapter has an empty,
-in-memory database, called ``:memory:``. You could connect to it, and
-then type ``/'Hello World'`` to run your first query::
+The HTSQL interpreter requires a database to be useful. You could test
+things out with our ``htsql_demo`` regression test database::
- $ htsql-ctl shell sqlite::memory:
- :memory:$ /'Hello World'
-The next step might be to download the ``htsql_demo`` database so that
-you could walk through :doc:`overview` and :doc:`tutorial <tutorial>`
-examples as you might wish::
- $ fetch http://htsql.org/dist/htsql_demo.sqlite
+ $ wget http://htsql.org/dist/htsql_demo.sqlite
$ htsql-ctl shell sqlite:htsql_demo.sqlite
- htsql_demo.sqlite$ /school
+ htsql_demo.sqlite$ /school
-The command ``shell`` has limited schema-based completion. So, you
-could type ``/s<TAB>`` to see tables that start with ``'s'`` which
-include ``school``, ``semester``, and ``student``.
+This command ``shell`` has limited schema-based completion. So, you
+could type ``/s`` then the TAB character to list tables that start
+with ``s``. At this point, you should be able to walk through our
+:doc:`overview <overview>` and/or :doc:`tutorial <tutorial>` with your