Index: lists.html
===================================================================
--- lists.html (nonexistent)
+++ lists.html (revision 2109)
@@ -0,0 +1,25 @@
+
+
+ The new config system in pcb-rnd
+ Lists and arrays
+
+Non-scalar settings are arrays or lists. Arrays can be explicitly indexed
+
+The default policy is always overwrite.
+
+There are three active policies: overwrite, prepend and append.
+When dealing with lists:
+
+ - step 1: the output list is reset to empty
+
- step 2: all sources that describe the list are sorted by priority
+
- step 3: sources are applied in order
+
+Step 3 is straight-forward: if policy is overwrite, reset the output
+list and copy the source's list into the output list. If policy is
+prepend (or append), keep the current output list and prepend
+(or append) the list provided by the source.
+
+In practice this means the user can replace, prepend or append ordered lists
+from various sources. A common example is setting the library search paths.
+
+TODO: EXAMPLES