diff --git a/docs/libconfig_manual.html b/docs/libconfig_manual.html index 2b8da9e..009ceeb 100644 --- a/docs/libconfig_manual.html +++ b/docs/libconfig_manual.html @@ -55,6 +55,7 @@

libconfig

+
A Library For Processing Structured Configuration Files
Version 1.7
@@ -354,6 +355,7 @@

1.5 Internationalization Issues

1.6 Compiling Using pkg-config

+

On UNIX systems you can use the pkg-config utility (version 0.20 or later) to automatically select the appropriate compiler and linker switches for libconfig. Ensure that the environment variable @@ -512,7 +514,7 @@

2 Configuration Files

pos = { x = 350; y = 250; }; }; - list = ( ( "abc", 123, true ), 1.234, ( /* an empty list */) ); + list = ( ( "abc", 123, true ), 1.234, ( /* an empty list */ ) ); books = ( { title = "Treasure Island"; author = "Robert Louis Stevenson"; @@ -1538,6 +1540,7 @@

3 The C API

Since v1.7

+

These functions make it possible to attach arbitrary data to a configuration structure, for instance a “wrapper” or “peer” object written in another programming language. @@ -1548,6 +1551,7 @@

3 The C API

Function: void config_setting_set_hook (config_setting_t * setting, void * hook)
Function: void * config_setting_get_hook (const config_setting_t * setting)
+

These functions make it possible to attach arbitrary data to each setting structure, for instance a “wrapper” or “peer” object written in another programming language. The destructor function, if one has been @@ -1560,6 +1564,7 @@

3 The C API

Function: void config_set_destructor (config_t * config, void (* destructor)(void *))
+

This function assigns the destructor function destructor for the configuration config. This function accepts a single void * argument and has no return value. See @@ -1648,7 +1653,7 @@

4 The C++ API

Method on SettingException: const char * getPath () const
-

Returns the path to the setting associated with the exception, or +

This method returns the path to the setting associated with the exception, or NULL if there is no applicable path.

@@ -1728,7 +1733,7 @@

4 The C++ API

Method on Config: void setIncludeDir (const char *includeDir)
Method on Config: const char * getIncludeDir () const
-

setIncludeDir() specifies the include directory, +

The setIncludeDir() method specifies the include directory, includeDir, relative to which the files specified in ‘@include’ directives will be located for the configuration. By default, there is no include directory, and all include files are @@ -2157,7 +2162,7 @@

4 The C++ API

Method on Setting: Setting & lookup (const char * path) const
Method on Setting: Setting & lookup (const std::string &path) const
-

This function locates a setting by a path path relative to +

These methods locate a setting by a path path relative to this setting. If requested setting is not found, a SettingNotFoundException is thrown.

@@ -2415,7 +2420,7 @@

4 The C++ API

Method on Setting: const char * getSourceFile () const
-

This function returns the name of the file from which the setting was +

This method returns the name of the file from which the setting was read, or NULL if the setting was not read from a file. This information is useful for reporting application-level errors. Storage for the returned string is managed by the library and released @@ -2427,7 +2432,7 @@

4 The C++ API

Method on Setting: unsigned int getSourceLine () const
-

This function returns the line number of the configuration file or +

This method returns the line number of the configuration file or stream at which the setting setting was read, or 0 if no line number is available. This information is useful for reporting application-level errors. @@ -2609,11 +2614,15 @@

6.7 Python

with libconfig. It may be found at https://pypi.python.org/pypi/pylibconfig2/0.1.2.

+
+

Christian Aichinger’s libconf is another pure-Python implementation with a more permissive license. It may be found at https://pypi.python.org/pypi/libconf or on github at https://github.com/Grk0/python-libconf.

+
+

The python-libconfig wrapper provides Python bindings to libconfig. It may be found on github at https://github.com/cnangel/python-libconfig/.

@@ -2628,9 +2637,11 @@

6.8 Ruby

Christopher Mark Gore’s ruby-libconfig is a Ruby library that provides Ruby bindings for libconfig. It may be found at -https://rubygems.org/gems/libconfig/versions/0.0.1 or on github at +https://rubygems.org/gems/libconfig or on github at https://github.com/cgore/ruby-libconfig.

+
+

There is also another Ruby wrapper, libconfig-ruby, that is included in the libconfig git repository at https://github.com/hyperrealm/libconfig, in the contrib/libconfig-ruby subdirectory. @@ -3276,6 +3287,8 @@

Appendix B Configuration File Grammar

<float>([-+]?([0-9]*)?\.[0-9]*([eE][-+]?[0-9]+)?)|([-+]([0-9]+)(\.[0-9]*)?[eE][-+]?[0-9]+) +
+

Note that adjacent strings are automatically concatenated. Non-printable characters can be represented within strings using a sequence ‘\xx’, representing the ASCII value as two hex digits. @@ -3674,12 +3687,16 @@

Concept Index

  C   +D +   E   F   G   +H +   I   L @@ -3704,6 +3721,9 @@

Concept Index

comment: Comments configuration: Configuration Files
+D +destructor function: The C API +
E escape sequence: String Values
@@ -3713,6 +3733,10 @@

Concept Index

G group: Configuration Files
+H +hook: The C API +hook: The C API +
I include directive: Include Directives include function: Include Directives @@ -3723,6 +3747,7 @@

Concept Index

P path: Configuration Files +pkg-config: Compiling Using pkg-config
S scalar value: Configuration Files @@ -3740,12 +3765,16 @@

Concept Index

  C   +D +   E   F   G   +H +   I   L diff --git a/docs/libconfig_manual.pdf b/docs/libconfig_manual.pdf index c86e698..c3d8079 100644 Binary files a/docs/libconfig_manual.pdf and b/docs/libconfig_manual.pdf differ