Using dylan-compiler interactively
==================================

The interactive mode of :program:`dylan-compiler` allows you to carry out
multiple development tasks over a period of time without having to restart the
console compiler each time.  To start the console environment in interactive
mode, enter :program:`dylan-compiler` without any arguments at a shell. For
example::

    $ dylan-compiler
    Welcome to Open Dylan!

    For documentation on Open Dylan, see https://opendylan.org.
    See https://opendylan.org/getting-started-cli/ for an introduction to the command line tools.

    Type "help" for more information.
    >

If you've used the Open Dylan IDE on Windows, note that using
``dylan-compiler`` interactively is similar to working in the IDE's
interactor.

You can find a list of command groups by entering the command
``help``. The command groups in the console compiler are:

+------------------+----------------------------+
| Command Group    | Description                |
+==================+============================+
| *BASIC*          | basic commands             |
+------------------+----------------------------+
| *BROWSING*       | browsing commands          |
+------------------+----------------------------+
| *BUILD*          | project building commands  |
+------------------+----------------------------+
| *INTERNAL*       | internal commands          |
+------------------+----------------------------+
| *LIBRARY-PACKS*  | library packs commands     |
+------------------+----------------------------+
| *PROJECT*        | project commands           |
+------------------+----------------------------+
| *PROPERTY*       | property handling commands |
+------------------+----------------------------+
| *REGISTRY*       | registry commands          |
+------------------+----------------------------+
| *REPORTS*        | report commands            |
+------------------+----------------------------+
| *SYSTEM*         | operating system commands  |
+------------------+----------------------------+

You can use ``help -group group-name`` to view the available commands
and properties of a specific group.  You can also use ``help
command-name`` to view the full documentation of a command. We can see
the kind of information available by looking at the help entry for the
``help`` command::

    > help help
    Usage: :HELP [options*] [command]

    If specified with no arguments, HELP shows a list of all commands
    with a one line description. Help can display command options by
    specifying the name of the command. Additionally, it can display
    group or property help by specifying the GROUP or PROPERTY option.

    Arguments:
      COMMAND - the command to describe

    Options:
      -GROUP group - the command group to describe
      -PROPERTY property - the property to describe

Therefore, to find out what commands exist within the *PROJECT* command
group, type::

    > help -group project

    PROJECT:

    Commands applying to projects.

    Commands:
      CLOSE   closes the specified project
      IMPORT  imports a LID file
      OPEN    opens the specified project

    Properties:
      PROJECT   Current project
      PROJECTS  Open projects

    For documentation on a group, use:    HELP -GROUP group.
    For documentation on a command, use:  HELP command
    For a complete list of commands, use: SHOW COMMANDS

Then, to examine the ``OPEN`` command, type::

    > help open
    Usage: OPEN file

    Opens the specified project.

    Arguments:

      FILE - the filename of the project

Properties can be displayed via the ``show`` command.  For example to
see the value of the "projects" property listed previously, use ``show
projects``.

To exit the console environment, use the ``exit`` command.