annotate docs/index.rst @ 358:70fead908abe

add info re: assembla page
author catherine@Drou
date Thu, 18 Feb 2010 00:10:25 -0500
parents 49bea7cab179
children 5b95dacca46e
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
358
70fead908abe add info re: assembla page
catherine@Drou
parents: 332
diff changeset
6 cmd2
70fead908abe add info re: assembla page
catherine@Drou
parents: 332
diff changeset
7 ====
70fead908abe add info re: assembla page
catherine@Drou
parents: 332
diff changeset
8
70fead908abe add info re: assembla page
catherine@Drou
parents: 332
diff changeset
9 `cmd2 project page`_
70fead908abe add info re: assembla page
catherine@Drou
parents: 332
diff changeset
10
70fead908abe add info re: assembla page
catherine@Drou
parents: 332
diff changeset
11 `project bug tracker`_
70fead908abe add info re: assembla page
catherine@Drou
parents: 332
diff changeset
12
70fead908abe add info re: assembla page
catherine@Drou
parents: 332
diff changeset
13 .. _`cmd2 Project page`: http://www.assembla.com/wiki/show/python-cmd2
70fead908abe add info re: assembla page
catherine@Drou
parents: 332
diff changeset
14 .. _`project bug tracker`: http://trac-hg.assembla.com/python-cmd2/report/1
314
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
15
324
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
16 The basic use of ``cmd2`` is identical to that of cmd_.
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
17
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
18 1. Create a subclass of ``cmd2.Cmd``. Define attributes and
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
19 ``do_*`` methods to control its behavior. Throughout this documentation,
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
20 we will assume that you are naming your subclass ``App``::
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
21
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
22 from cmd2 import Cmd
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
23 class App(Cmd):
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
24 # customized attributes and methods here
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
25
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
26 2. Instantiate ``App`` and start the command loop::
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
27
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
28 app = App()
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
29 app.cmdloop()
332
49bea7cab179 doc refreshing refresh.bash
cat@eee
parents: 324
diff changeset
30
49bea7cab179 doc refreshing refresh.bash
cat@eee
parents: 324
diff changeset
31 These docs will refer to ``App`` as your ``cmd2.Cmd``
49bea7cab179 doc refreshing refresh.bash
cat@eee
parents: 324
diff changeset
32 subclass, and ``app`` as an instance of ``App``. Of
49bea7cab179 doc refreshing refresh.bash
cat@eee
parents: 324
diff changeset
33 course, in your program, you may name them whatever
49bea7cab179 doc refreshing refresh.bash
cat@eee
parents: 324
diff changeset
34 you want.
324
21584174d865 make SHOW TABLES work
catherine@dellzilla
parents: 315
diff changeset
35
314
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
36 Contents:
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
37
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
38 .. toctree::
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
39 :maxdepth: 2
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
40
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
41 overview
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
42 example
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
43 freefeatures
315
a08c50b7d3d3 doc skeleton
cat@eee
parents: 314
diff changeset
44 settingchanges
a08c50b7d3d3 doc skeleton
cat@eee
parents: 314
diff changeset
45 unfreefeatures
314
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
46
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
47 Indices and tables
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
48 ==================
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
49
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
50 * :ref:`genindex`
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
51 * :ref:`modindex`
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
52 * :ref:`search`
0687bb650118 begin new docs
catherine@dellzilla
parents:
diff changeset
53