From 73e32af95d20a2f87884b7927f382b99fb9c4b05 Mon Sep 17 00:00:00 2001 From: gwen Date: Wed, 28 Aug 2013 09:22:44 +0200 Subject: [PATCH] update doc --- doc/conf.py | 2 +- doc/config.txt | 2 -- doc/consistency.txt | 6 +++--- doc/getting-started.txt | 2 +- doc/option.txt | 27 ++++----------------------- doc/status.txt | 2 +- 6 files changed, 10 insertions(+), 31 deletions(-) diff --git a/doc/conf.py b/doc/conf.py index cb97d7a..3a0147d 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -50,7 +50,7 @@ copyright = u'2013, tiramisu team' # The short X.Y version. version = '1' # The full version, including alpha/beta/rc tags. -release = '1.0RC1' +release = '1.0' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. diff --git a/doc/config.txt b/doc/config.txt index 17bddf3..9bce1cb 100644 --- a/doc/config.txt +++ b/doc/config.txt @@ -27,8 +27,6 @@ object is returned, and if no `Option` has been declared in the :: >>> gcdummy = BoolOption('dummy', 'dummy', default=False) - >>> gcdummy._name - 'dummy' >>> gcdummy.getdefault() False >>> descr = OptionDescription('tiramisu', '', [gcdummy]) diff --git a/doc/consistency.txt b/doc/consistency.txt index 7925fa3..79ecd6e 100644 --- a/doc/consistency.txt +++ b/doc/consistency.txt @@ -52,13 +52,13 @@ to carry out a dependencies calculation. For example, an option can ben hidden if another option has been set with some expected value. This is just an example, the possibilities are hudge. -A requirement is a list of dictionnaries that have fairly this form:: +A requirement is a list of dictionaries that have fairly this form:: [{'option': a, 'expected': False, 'action': 'disabled', 'inverse': True, 'transitive':True, 'same_action': True}] -Actually a transformation is made to this dictionnary during the validation of -this requires at the :class:`~option.Option()`'s init. The dictionnairy becomes +Actually a transformation is made to this dictionary during the validation of +this requires at the :class:`~option.Option()`'s init. The dictionairy becomes a tuple, wich is passed to the :meth:`~setting.Settings.apply_requires()` method. Take a look at the code to fully understand the exact meaning of the requirements: diff --git a/doc/getting-started.txt b/doc/getting-started.txt index b1484a7..e429b46 100644 --- a/doc/getting-started.txt +++ b/doc/getting-started.txt @@ -6,7 +6,7 @@ What is options handling ? ================================= Due to more and more available options required to set up an operating system, -to set up compiler options, vs... it became quite annoying to hand the +to set up compiler options, and so on. it became quite annoying to hand the necessary options to where they are actually used and even more annoying to add new options. To circumvent these problems the configuration management was introduced... diff --git a/doc/option.txt b/doc/option.txt index 981b05b..cdc5585 100644 --- a/doc/option.txt +++ b/doc/option.txt @@ -25,29 +25,10 @@ The `OptionDescription` class :members: -If you need to access an option object, you can do it with the OptionDescription -object. Not only the value of the option by attribute access, but the option -object itself that lives behind the scene. It can always be accessed internally -with the `impl_descr` attribute of the `config` objects. For example, with a -option named `name` in a `gc` group the `name` object can be accessed like -this:: - - conf._impl_descr.name - -of sub configs with :: - - conf.gc._impl_descr.name - -This is a binding. The option objects are in the `_children` config's attribute. - -Why accessing an option object ? It is possible for example freeze the -configuration option - -:: - - conf.gc._impl_descr.dummy.freeze() - -or to hide it, or disable it, or... anything. +If you need to access an option object, you can do it with the OptionDescription +object. Not only the value of the option by attribute access, but the option +object itself that lives behind the scene. It can always be accessed internally. +The option objects are in the `_children` `OptionDescription`'s attribute. The `Option` base class ------------------------- diff --git a/doc/status.txt b/doc/status.txt index 5fac59c..4e9217f 100644 --- a/doc/status.txt +++ b/doc/status.txt @@ -1,6 +1,6 @@ .. default-role:: literal -Local statuses and global setting +Local statuses and global settings ===================================== Available configuration statuses