Rev 5768: Complement the stacks doc. in file:///home/vila/src/bzr/experimental/config/

[Vincent Ladeuil]

At file:///home/vila/src/bzr/experimental/config/

------------------------------------------------------------
revno: 5768
revision-id: v.ladeuil+lp at free.fr-20110408163042-b2kjlrqwj956g9rx
parent: v.ladeuil+lp at free.fr-20110408162653-vnzanyhe3fey8fge
committer: Vincent Ladeuil <v.ladeuil+lp at free.fr>
branch nick: config-concrete-stacks
timestamp: Fri 2011-04-08 18:30:42 +0200
message:
  Complement the stacks doc.
-------------- next part --------------
=== modified file 'doc/developers/configuration.txt'
--- a/doc/developers/configuration.txt	2011-04-08 16:26:18 +0000
+++ b/doc/developers/configuration.txt	2011-04-08 16:30:42 +0000
@@ -94,3 +94,9 @@
 mutable section when there is no ambiguity, if there is one, then the *user*
 should be able to decide and this case a new ``Stack`` can be created cheaply.
 
+Different stacks can be created for different purposes, the existing
+``Global.Stack``, ``LocationStack`` and ``BranchStack`` can be used as basis
+or examples. These classes are the only ones that should be used in code,
+``Stores`` can be used to build them but shouldn't be used otherwise, ditto
+for sections. Again, the associated tests could and should be used against the
+created stacks.