annotate docs/index.rst @ 328:7b2bca3951a7

locals_in_py
author cat@eee
date Fri, 12 Feb 2010 15:35:48 -0500
parents 21584174d865
children 49bea7cab179
rev   line source
314
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
1 .. cmd2 documentation master file, created by
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
2 sphinx-quickstart on Wed Feb 10 12:05:28 2010.
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
3 You can adapt this file completely to your liking, but it should at least
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
4 contain the root `toctree` directive.
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
5
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
6 Welcome to cmd2's documentation!
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
7 ================================
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
8
324
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
9 The basic use of ``cmd2`` is identical to that of cmd_.
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
10
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
11 1. Create a subclass of ``cmd2.Cmd``. Define attributes and
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
12 ``do_*`` methods to control its behavior. Throughout this documentation,
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
13 we will assume that you are naming your subclass ``App``::
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
14
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
15 from cmd2 import Cmd
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
16 class App(Cmd):
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
17 # customized attributes and methods here
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
18
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
19 2. Instantiate ``App`` and start the command loop::
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
20
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
21 app = App()
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
22 app.cmdloop()
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
23
314
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
24 Contents:
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
25
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
26 .. toctree::
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
27 :maxdepth: 2
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
28
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
29 overview
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
30 example
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
31 freefeatures
315
a08c50b7d3d3 doc skeleton
cat@eee
parents: 314
diff changeset
32 settingchanges
a08c50b7d3d3 doc skeleton
cat@eee
parents: 314
diff changeset
33 unfreefeatures
314
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
34
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
35 Indices and tables
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
36 ==================
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
37
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
38 * :ref:`genindex`
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
39 * :ref:`modindex`
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
40 * :ref:`search`
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
41