On 27/04/14 09:56, Andrew Gregory wrote: > Signed-off-by: Andrew Gregory <[email protected]> > --- > src/pacman/ini.c | 52 +++++++++++++++++----------------------------------- > 1 file changed, 17 insertions(+), 35 deletions(-) > > diff --git a/src/pacman/ini.c b/src/pacman/ini.c > index dc1fb7a..5c5232d 100644 > --- a/src/pacman/ini.c > +++ b/src/pacman/ini.c > @@ -27,20 +27,28 @@ > #include "util.h" > > /** > - * @brief INI parser backend. > + * @brief Parse a pacman-style INI config file. > * > * @param file path to the config file > * @param cb callback for key/value pairs > * @param data caller defined data to be passed to the callback > - * @param section_name the name of the current section > - * @param line buffer to read into, must be at least PATH_MAX long > * > * @return 0 on success, 1 on parsing errors, the callback return value > * otherwise > + * > + * @note The callback will be called at the beginning of each section with an > + * empty key and value, for each key/value pair, and when parsing is complete > + * with all arguments except @a data empty.
You removed the final callback in patch 4/9. The documentation should have been updated there.
