Sorry, for the maybe unclear example. Here is one that I edited
with VIM, which is emphasizes the idea of the proposed grammar
better (due to constant character width). This is how the TOC
file for some python documentation might look like. As I said:
All in one place and everything is transparent:
-- itoctree::
(*) Command line and environment ...........
CommandLineAndEnvironment.txt
(**) Command line ...................... CommandLine.txt
(***) Interface options ........... InterfaceOptions.txt
(***) Generic options ............. GenericOptions.txt
(***) Miscellaneous options .......
MiscellaneousOptions.txt
(**) Environment variables .............
EnvironmentVariables.txt
(***) Debug-mode variables ........ DebugModeVariables.txt
(*) Using Python on Unix platforms ......... UsingPythonOnUnix.txt
(**) Getting and installing the latest
version of Python .................
GettingAndInstalling.txt
(***) On Linux .................... OnLinux.txt
(***) On FreeBSD and OpenBSD ...... OnFreeBSDAndOpenBSD.txt
(***) On OpenSolaris .............. OnOpenSolaris.txt
(**) Building Python ................... BuildingPython.txt
(**) Python-related paths and files .... Python-relatedPaths.txt
(**) Miscellaneous ..................... Miscellaneous.txt
(**) Editors ........................... Editors.txt
(*) Using Python on Windows .......................
PythonWindows.txt
(**) Installing Python ........................
InstallingPython.txt
(**) Alternative bundles ...................... Alternative.txt
(**) Configuring Python .......................
ConfiguringPython.txt
(***) Excursus: Setting environment
variables ..........................
ExcursusSettingEnv.txt
(***) Finding the Python executable ......
FindingThePythonExe.txt
(***) Finding modules ....................
FindingModules.txt
(***) Executing scripts ..................
ExecutingScripts.txt
(**) Additional modules .......................
AdditionalModules.txt
(***) PyWin32 ............................ PyWin32.txt
(***) Py2exe ............................. Py2exe.txt
(***) WConi(**) ......................... WConio.txt
(**) Compiling Python on Windows ..............
CompilingPythonOnWin.txt
(**) Other resources ..........................
OtherResources.txt
(*) Using Python on a Macintosh ................... UsingPythonOnA
Mac.txt
(**) Getting and Installing MacPython .........
GettingAndInstallingMac.txt
(***) How t(**) run a Python script ......
HowToRunAPythonScript.txt
(***) Running scripts with a GUI .........
RunningScriptsGUI.txt
(***) Configuration ......................
Configuration.txt
(**) The IDE .................................. TheIDE.txt
(**) Installing Additional Python Packages ....
InstallingAddPythonPacks.txt
(**) GUI Programming on the Mac ...............
GUIProgrammingOnTheMac.txt
(**) Distributing Python Applications on
the Mac ..................................
DistributingPythonApplMac.txt
(**) Application Scripting ....................
ApplicationScripting.txt
(**) Other Resources ..........................
OtherResources.txt
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"sphinx-dev" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to
[email protected]
For more options, visit this group at
http://groups.google.com/group/sphinx-dev?hl=en
-~----------~----~----~----~------~----~------~--~---
