[asterisk-commits] tilghman: branch 1.4 r118052 - in /branches/1.4/doc: 00README.1st cli.txt

[SVN commits to the Asterisk project]

Author: tilghman
Date: Fri May 23 07:59:16 2008
New Revision: 118052

URL: http://svn.digium.com/view/asterisk?view=rev&rev=118052
Log:
Add information on using the Asterisk console, including tab command line
completion.  (Closes issue #12681)

Added:
    branches/1.4/doc/cli.txt   (with props)
Modified:
    branches/1.4/doc/00README.1st

Modified: branches/1.4/doc/00README.1st
URL: http://svn.digium.com/view/asterisk/branches/1.4/doc/00README.1st?view=diff&rev=118052&r1=118051&r2=118052
==============================================================================
--- branches/1.4/doc/00README.1st (original)
+++ branches/1.4/doc/00README.1st Fri May 23 07:59:16 2008
@@ -8,6 +8,7 @@
 ----------
 security.txt		IMPORTANT INFORMATION ABOUT ASTERISK SECURITY
 hardware.txt		Hardware supported by Asterisk
+cli.txt			Information on using the Asterisk console
 
 Configuration
 -------------

Added: branches/1.4/doc/cli.txt
URL: http://svn.digium.com/view/asterisk/branches/1.4/doc/cli.txt?view=auto&rev=118052
==============================================================================
--- branches/1.4/doc/cli.txt (added)
+++ branches/1.4/doc/cli.txt Fri May 23 07:59:16 2008
@@ -1,0 +1,33 @@
+In addition to being the console for Asterisk, the CLI also sports several
+features that make it very helpful to use for obtaining information and
+affecting system configuration.  The console can also be seen by starting
+a remote console, which connects to the running daemon and shows much of
+the same information as if using the daemon in foreground mode.
+
+Connecting a remote console is as easy as using the -r or -R flags.  The only
+difference between these flags is that the uppercase variation (-R) will
+automatically reconnect to the daemon (or at least retry) if the daemon
+restarts.  To exit a remote console, simply type 'quit' or 'exit'.  Please note
+that you can differentiate between a remote console and the Asterisk console,
+as 'quit' or 'exit' will not function on the main console, which prevents an
+accidental shutdown of the daemon.  If you would like to shutdown the Asterisk
+daemon, you can use the 'stop' set of commands, such as 'stop now',
+'stop gracefully', or 'stop when convenient'.
+
+Once on the console, the 'help' command may be used to see a list of commands
+available for use.  Note that in addition to the 'help' command, the Asterisk
+CLI sports tab command line completion on all commands, including many
+arguments.  To use tab command line completion, simply press the <Tab> key at
+any time while entering the beginning of any command.  If the command can be
+completed unambiguously, it will do so, otherwise it will complete as much of
+the command as possible.  Additionally, Asterisk will print a list of all
+possible matches, if possible.
+
+The 'help' command may also be used to obtain more detailed information on
+how to use a particular command.  For example, if you type 'help core show',
+Asterisk will respond with a list of all commands that start with that string.
+If you type 'help core show version', specifying a complete command, Asterisk
+will respond with a usage message which describes how to use that command.  As
+with other commands on the Asterisk console, the help command also responds to
+tab command line completion.
+

Propchange: branches/1.4/doc/cli.txt
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: branches/1.4/doc/cli.txt
------------------------------------------------------------------------------
    svn:keywords = Id Author Date Revision

Propchange: branches/1.4/doc/cli.txt
------------------------------------------------------------------------------
    svn:mime-type = text/plain