From bd1c23f10f36c3be891b1a63f733c3464746b0f8 Mon Sep 17 00:00:00 2001 From: "Malte S. Stretz" Date: Thu, 13 Aug 2009 11:46:03 +0000 Subject: [PATCH] libs/uci: more detailed api docs --- libs/uci/luasrc/model/uci.lua | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/libs/uci/luasrc/model/uci.lua b/libs/uci/luasrc/model/uci.lua index 5b8cf6774..c927b4ca5 100644 --- a/libs/uci/luasrc/model/uci.lua +++ b/libs/uci/luasrc/model/uci.lua @@ -34,6 +34,12 @@ local error, pairs, ipairs, tostring = error, pairs, ipairs, tostring local require, getmetatable, type = require, getmetatable, type --- LuCI UCI model library. +-- The typical workflow for UCI is: Get a cursor instance from the +-- cursor factory, modify data (via Cursor.add, Cursor.delete, etc.), +-- save the changes to the staging area via Cursor.save and finally +-- Cursor.commit the data to the actual config files. +-- LuCI then needs to Cursor.apply the changes so deamons etc. are +-- reloaded. -- @cstyle instance module "luci.model.uci" @@ -226,18 +232,20 @@ end -- @param type UCI section type -- @return Name of created section ---- Get a table of unsaved changes. +--- Get a table of saved but uncommitted changes. -- @class function -- @name Cursor.changes -- @param config UCI config -- @return Table of changes +-- @see Cursor.save ---- Commit unsaved changes. +--- Commit saved changes. -- @class function -- @name Cursor.commit -- @param config UCI config -- @return Boolean whether operation succeeded -- @see Cursor.revert +-- @see Cursor.save --- Deletes a section or an option. -- @class function @@ -278,12 +286,13 @@ end -- @see Cursor.save -- @see Cursor.unload ---- Revert unsaved changes. +--- Revert saved but uncommitted changes. -- @class function -- @name Cursor.revert -- @param config UCI config -- @return Boolean whether operation succeeded -- @see Cursor.commit +-- @see Cursor.save --- Saves changes made to a config to make them committable. -- @class function -- 2.25.1