Commits

Clark C. Evans committed bd7eb9a

only very first step of handbook

  • Participants
  • Parent commits b819db2

Comments (0)

Files changed (1)

    :depth: 1
    :local:
 
-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.
 
 Up & Running
 =============
 
-In this section we work through the basics of ``htsql-ctl``.  For
-starters, you should be able to print the ``version`` information 
-and then ``help``::
+To verify your installation, try the ``htsql-ctl`` command line
+utility's ``version`` or ``help`` routine::
 
   $ htsql-ctl version
   ...
 
-  $ htsql-ctl help
-  ...
-
-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
+installation issue.
 
 First Steps
 -----------
 
-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'
-  ...
-  :memory:$ quit
-
-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$ /count(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
+local installation.
 
-