Doxygen: Various fixes.

diff --git a/Doxyfile b/Doxyfile
index c0e73118ecb713e1ce873792d6eb9f57421f69a6..abb589b2de67453e02149e0c1614122c882eb5a4 100644 (file)
--- a/Doxyfile
+++ b/Doxyfile
@@ -687,7 +687,7 @@ RECURSIVE              = YES
 # Note that relative paths are relative to the directory from which doxygen is
 # run.
 
-EXCLUDE                = config.h sigrokdecode-internal.h exception.c \
+EXCLUDE                = config.h libsigrokdecode-internal.h exception.c \
                          module_sigrokdecode.c type_decoder.c type_logic.c \
                          util.c
 
@@ -706,7 +706,7 @@ EXCLUDE_SYMLINKS       = NO
 #
 # Ignore the following files and directories (see also EXCLUDE above):
 #  - config.h: Non-public stuff, the file doesn't get installed.
-#  - sigrokdecode-internal.h: Non-public stuff, the file doesn't get installed.
+#  - libsigrokdecode-internal.h: Non-public stuff, the file isn't installed.
 #  - decoders/*: The decoders themselves don't contain public API.
 #  - exception.c: No public API stuff in there currently.
 #  - module_sigrokdecode.c: No public API stuff in there currently.

diff --git a/controller.c b/controller.c
index c9825b95cfc70c8fd6448f9001e851bd6957be3b..9b8d35bd389b13c896be8af73cf9a0112b6eded3 100644 (file)
--- a/controller.c
+++ b/controller.c
@@ -112,10 +112,10 @@ extern SRD_PRIV PyTypeObject srd_logic_type;
  * This initializes the Python interpreter, and creates and initializes
  * a "sigrokdecode" Python module.
  *
- * Then, it searches for sigrok protocol decoder files (*.py) in the
- * "decoders" subdirectory of the the sigrok installation directory.
+ * Then, it searches for sigrok protocol decoders in the "decoders"
+ * subdirectory of the the libsigrokdecode installation directory.
  * All decoders that are found are loaded into memory and added to an
- * internal list of decoders, which can be queried via srd_decoders_list().
+ * internal list of decoders, which can be queried via srd_decoder_list().
  *
  * The caller is responsible for calling the clean-up function srd_exit(),
  * which will properly shut down libsigrokdecode and free its allocated memory.
@@ -124,12 +124,12 @@ extern SRD_PRIV PyTypeObject srd_logic_type;
  * are not allowed.
  *
  * @param path Path to an extra directory containing protocol decoders
- *             which will be added to the Python sys.path, or NULL.
+ *             which will be added to the Python sys.path. May be NULL.
  *
  * @return SRD_OK upon success, a (negative) error code otherwise.
- *         Upon Python errors, return SRD_ERR_PYTHON. If the sigrok decoders
- *         directory cannot be accessed, return SRD_ERR_DECODERS_DIR.
- *         If not enough memory could be allocated, return SRD_ERR_MALLOC.
+ *         Upon Python errors, SRD_ERR_PYTHON is returned. If the decoders
+ *         directory cannot be accessed, SRD_ERR_DECODERS_DIR is returned.
+ *         If not enough memory could be allocated, SRD_ERR_MALLOC is returned.
  *
  * @since 0.1.0
  */

diff --git a/decoder.c b/decoder.c
index 21e24c471d6178610dacd5bdc3885d17221a9e99..a7e582278662b91bd34fea37363cb887257f6176 100644 (file)
--- a/decoder.c
+++ b/decoder.c
@@ -448,7 +448,7 @@ static void free_probes(GSList *probelist)
 }
 
 /**
- * Unload decoder module.
+ * Unload the specified protocol decoder.
  *
  * @param dec The struct srd_decoder to be unloaded.
  *