... plugins also get the multi-source, priority-based config mechanism
Index: trunk/doc/conf/index_user.html
===================================================================
--- trunk/doc/conf/index_user.html (revision 5702)
+++ trunk/doc/conf/index_user.html (revision 5703)
@@ -18,7 +18,7 @@
carry out their tasks.
Config settings are imported from multiple sources: from different files,
-from environment vareiables, from command line arguments, from the .pcb
+from environment variables, from command line arguments, from the .pcb
files on load. Any source can define any part of the config tree.
When the configuration is processed, each source is read into a temporary
tree and then all the temporary trees are merged into the final
@@ -34,7 +34,7 @@
purpose of the source. The next
step is following the red arrows in two steps:
- - first merge all the role treesinto a flat list; this determines the value of each setting;
+
- first merge all the role trees into a flat list; this determines the value of each setting;
- then dispatch the values to the right component of the code.
Some components may change some of the settings run-time. The trivial example
@@ -43,7 +43,7 @@
to the design role tree directly, from where the new value is again merged
and dispatched along the red arrows. Changes in the design role are saved
with the .pcb file (thus the bidirectional black arrow between the source and
-the in-memory tree for the design role). Occassionally the user wants to
+the in-memory tree for the design role). Occasionally the user wants to
save parts of the setting as a project setting or
as an user setting - in this case, along the dashed blue lines, the
corresponding project or user roles are modified. This again results in updating
@@ -60,7 +60,7 @@
sets a given item).
overlaps
-Each setting in each source has a prioirty. The
+Each setting in each source has a priority. The
priority can be defined in the source, or if it is not defined, each source
inherits a fallback default priority. The fallback is designed to provide
the intuitive order: cli > design > project > user > system.
@@ -79,7 +79,7 @@
values. They are described in a lihata list item ("li:") in the config
files and are generally called lists in this document. How lists
are merged is controlled by the merging policy, which can be
-in each source, just like the prioirty is set. Check out the
+in each source, just like the priority is set. Check out the
list merging section for more details.
blind spots
Index: trunk/doc/conf/prio.html
===================================================================
--- trunk/doc/conf/prio.html (revision 5702)
+++ trunk/doc/conf/prio.html (revision 5703)
@@ -15,7 +15,7 @@
is a tie, role decides: the role closer to the CLI is stronger.
For lists and arrays, priority determines the
-order of merge, which changes the order of itmes in the final list as
+order of merge, which changes the order of items in the final list as
config roots prepend and append items.
Index: trunk/doc/conf/scalars.html
===================================================================
--- trunk/doc/conf/scalars.html (revision 5702)
+++ trunk/doc/conf/scalars.html (revision 5703)
@@ -26,7 +26,7 @@
2. | apply user | A | "not defined" doesn't mean "empty", so the list is not deleted - no change
|
3. | apply project | Q | replace the original output because of the overwrite policy
- Example scenario: system default overriden by a project setting.
+ Example scenario: system default overridden by a project setting.
user-forced value
Config sources append:
@@ -48,7 +48,7 @@
Example scenario: user preference enforced: even if the project file would use
'Q' for the given setting, the user prefers 'E'. This affects runtime
(the value of the setting after the merge, in other words how pcb-rnd works),
-but does nto change the project configuration. This allows the given user to
+but does not change the project configuration. This allows the given user to
always use 'E' for the given setting while lets other users working on the
same project use the value set in the project file.
Index: trunk/doc/conf/sources.html
===================================================================
--- trunk/doc/conf/sources.html (revision 5702)
+++ trunk/doc/conf/sources.html (revision 5703)
@@ -19,7 +19,7 @@
| 200
| /usr/share/pcb-rnd/pcb-conf.lht
| recommended
- | should hold system and installation specific settigns, e.g. path to the system-wise installed footprint library
+ | should hold system and installation specific settings, e.g. path to the system-wise installed footprint library
|
default.pcb
| 300
@@ -36,12 +36,12 @@
|
environment
| 500
| environment variables (TODO)
- | occassional
+ | occasional
| inject the same (temporary) settings in multiple pcb-rnd sessions without having to change config files
|
project
| 600
- | projdect.lht in the project directory
+ | project.lht in the project directory
| optional
| local project settings - useful for large projects with multiple design (.pcb) files
@@ -54,7 +54,7 @@
|
cli
| 800
| command line argument
- | occassional
+ | occasional
| inject/change a setting for a single session; useful in batch/automated processing
@@ -63,7 +63,7 @@
representation. If a setting is specified in multiple sources, the one
with the higher priority wins, except for lists where it is also possible
to prepend/append items. Default priorities are designed to result
-precedence in an intuitive way (e.g. design settigns overwrite user settings).
+precedence in an intuitive way (e.g. design settings overwrite user settings).
However, priority can be changed per setting, resulting
in weak settings ("use this value if it was not already set") or strong settings
("I always want to use mincut, so I enable it from my user's config with high
Index: trunk/doc/conf/syntax.html
===================================================================
--- trunk/doc/conf/syntax.html (revision 5702)
+++ trunk/doc/conf/syntax.html (revision 5703)
@@ -3,11 +3,11 @@
The new config system in pcb-rnd
Config file syntax
-The config file sytnax is lihata.
+The config file syntax is lihata.
Most users don't need to understand most of the syntax, just follow the
patterns seen in the examples. A few thumb of rules:
- - srtuctural nodes usually start with a ha: or li: prefix; which one needs to be used is pretty much tied to the node name; thus casual users don't need to care about what they are for, just remember them as part of the name
+
- structural nodes usually start with a ha: or li: prefix; which one needs to be used is pretty much tied to the node name; thus casual users don't need to care about what they are for, just remember them as part of the name
- non-structural nodes are usually given in the form of name = value; use braces around the value if it contains any non-alphanumeric, non-whitespace character
- list and array members should better be braced
- list and array separator should be semicolon (not comma)
@@ -22,7 +22,7 @@
Each config root is a partial description of the
config tree (which is the logical
-confgiuration of all possible settings). Config roots have a policy and
+configuration of all possible settings). Config roots have a policy and
a priority attached. This is done in the name
of the config root, which must be of the form of policy-priority,
e.g. "overwrite-300" or "append-125". The priority part (with the dash)
@@ -31,7 +31,7 @@
Under the config root, a tree of sections (hashes) and setting values
(text nodes) are built. These structures and values are in 1:1
-correspondance with the config tree. Excess
+correspondence with the config tree. Excess
(unknown) keys are considered a warning (except in the plugin/ and
utils/ subtrees). Missing keys or missing subtrees is normal because a config
root can be partial.
Index: trunk/doc/conf/tree/editor_selection.html
===================================================================
--- trunk/doc/conf/tree/editor_selection.html (revision 5702)
+++ trunk/doc/conf/tree/editor_selection.html (revision 5703)
@@ -3,6 +3,6 @@
subtree: editor/selection
node name | type | flags | description
- |
---|
disable_negative | boolean | 0 | selection box behaviour: diable the negative-direction selection - any selection box will select only what's fully within the box
+ | disable_negative | boolean | 0 | selection box behaviour: disable the negative-direction selection - any selection box will select only what's fully within the box
| symmetric_negative | boolean | 0 | selection box behaviour: when set, the selection direction is considered negative only if the box has negative size in the X direction
| |