diff options
author | Stuart Rackham <srackham@methods.co.nz> | 2009-03-14 11:35:16 +1300 |
---|---|---|
committer | Stuart Rackham <srackham@methods.co.nz> | 2009-03-14 11:35:16 +1300 |
commit | 5d8105342bec0b9ccd5f6f33e4bd63ebca1008f1 (patch) | |
tree | 5a19393dcf1751ec68dcde94b0fd1bc86b457aeb /doc/asciidocapi.txt | |
parent | aa7669423bed940116a053352f25bfe2f05bb5d6 (diff) | |
download | asciidoc-git-5d8105342bec0b9ccd5f6f33e4bd63ebca1008f1.tar.gz |
Minor documentation updates.
Diffstat (limited to 'doc/asciidocapi.txt')
-rw-r--r-- | doc/asciidocapi.txt | 18 |
1 files changed, 10 insertions, 8 deletions
diff --git a/doc/asciidocapi.txt b/doc/asciidocapi.txt index 1c40cd8..8a8385f 100644 --- a/doc/asciidocapi.txt +++ b/doc/asciidocapi.txt @@ -30,8 +30,8 @@ installed -- simple, no setuptools to run, no Eggs to install, no non-standard library dependencies. You can find `asciidocapi.py` in the AsciiDoc -link:downloads.html#X2[distribution archives] (version 8.4.1 or -better). +http://www.methods.co.nz/asciidoc/downloads.html#X2[distribution +archives] (version 8.4.1 or better). Once you have `asciidocapi.py` Verify everything is working by running the module doctests: @@ -53,7 +53,7 @@ The next interactive example uses file-like objects for input and output: ------------------------------------------------------------------------------- $ python -Python 2.5.2 (r252:60911, Jul 31 2008, 17:28:52) +Python 2.5.2 (r252:60911, Jul 31 2008, 17:28:52) [GCC 4.2.3 (Ubuntu 4.2.3-2ubuntu7)] on linux2 Type "help", "copyright", "credits" or "license" for more information. >>> from asciidocapi import AsciiDocAPI @@ -116,7 +116,7 @@ Instance attributes The imported `asciidoc.py` module. `attributes`:: -A dictionary of AsciiDoc attribute values. +A dictionary of AsciiDoc attribute values passed to AsciiDoc. `cmd`:: The file path of the `asciidoc.py` script. Set by the `__init__` @@ -127,8 +127,8 @@ A chronologically ordered list of message strings generated during AsciiDoc execution (last message at the end of the list). `options`:: -An instance of the <<X1,Options class>>. Contains a list of -AsciiDoc command options. +An instance of the <<X1,Options class>>. Contains a list of command +options passed to AsciiDoc. Instance methods ^^^^^^^^^^^^^^^^ @@ -166,12 +166,14 @@ Instance methods `__call__(self, name, value=None)`:: A shortcut for the `append` method. Example: - options('--verbose') + opts = Options() + opts('--verbose') `append(self, name, value=None)`:: Append `(name,value)` to the options list. Example: - options.append('--conf-file', 'blog.conf') + opts = Options() + opts.append('--conf-file', 'blog.conf') Class `AsciiDocError(Exception)` |