Merge pull request #689 from stweil/master
[project/luci.git] / documentation / api / modules / luci.model.uci.html
index 9e50d99..c84d1eb 100644 (file)
@@ -903,7 +903,8 @@ Get an option or list and return values as table.
 
 
 <h3>Return value:</h3>
-UCI value
+table.  If the option was not found, you will simply get 
+               an empty table.
 
 
 
@@ -1119,6 +1120,12 @@ Name of created section
 
  
 Set a value or create a named section. 
+When invoked with three arguments <code>config</code>, <code>sectionname</code>, <code>sectiontype</code>, 
+then a named section of the given type is created. 
+When invoked with four arguments <code>config</code>, <code>sectionname</code>, <code>optionname</code> and 
+<code>optionvalue</code> then the value of the specified option is set to the given value. 
 
 
 
@@ -1138,7 +1145,7 @@ Set a value or create a named section.
        </li>
        
        <li>
-         value: UCI value or nil if you want to create a section
+         value: UCI value or nothing if you want to create a section
        </li>
        
 </ul>
@@ -1194,7 +1201,8 @@ Boolean whether operation succeeded
 <dd>
 
  
-Set given values as list. 
+Set given values as list. Setting a list option to an empty list 
+has the same effect as deleting the option. 
 
 
 
@@ -1214,7 +1222,7 @@ Set given values as list.
        </li>
        
        <li>
-         value: UCI value
+         value: value or table. Raw values will become a single item table.
        </li>
        
 </ul>