plguins REFACTOR various smaller docs refactoring

Author: roman

src/context.h

@@ -212,7 +212,7 @@ struct ly_ctx;
 #define LY_CTX_STATIC_PLUGINS_ONLY 0x2000 /**< By default, external plugins from directories the path to which is obtained
                                         from the `LIBYANG_TYPES_PLUGINS_DIR` and `LIBYANG_EXTENSIONS_PLUGINS_DIR` environmental variables
                                         are loaded. This option prevents loading of all external plugins and only
-                                        the static (built-in) plugins are loaded. */
+                                        the static (libyang built-in) plugins are loaded. */
 
 /* 0x80000000 reserved for internal use */
 

src/plugins.c

@@ -176,9 +176,9 @@ lysc_get_ext_plugin(uintptr_t plugin_id)
 /**
  * @brief Iterate over list of loaded plugins of the given @p type.
  *
- * @param[in] ctx The context for which the plugin is searched for.
+ * @param[in] ctx Context for which the plugin is searched for.
  * @param[in] type Type of the plugins to iterate.
- * @param[in,out] index The iterator - set to 0 for the first call.
+ * @param[in,out] index Iterator - set to 0 for the first call.
  * @return The plugin records, NULL if no more record is available.
  */
 static struct lyplg_record *
@@ -222,6 +222,10 @@ lyplg_record_find(const struct ly_ctx *ctx, enum LYPLG type, const char *module,
     assert(module);
     assert(name);
 
+    if (record_idx) {
+        *record_idx = 0;
+    }
+
     while ((item = plugins_iter(ctx, type, &i)) != NULL) {
         if (!strcmp(item->module, module) && !strcmp(item->name, name)) {
             if (item->revision && revision && strcmp(item->revision, revision)) {

src/plugins_internal.h

@@ -49,7 +49,7 @@
  * Covers both the types and extensions plugins.
  *
  * @param[in] builtin_type_plugins_only Whether to load only built-in YANG type plugins and no included extension plugins.
- * @param[in] static_plugins_only Whether to load only static plugins, meaning no external directories with plugins.
+ * @param[in] static_plugins_only Whether to load only static (libyang built-in) plugins, meaning no external directories with plugins.
  * @return LY_SUCCESS in case of success
  * @return LY_EINT in case of internal error
  * @return LY_EMEM in case of memory allocation failure.

src/printer_context.c

@@ -1749,12 +1749,13 @@ ly_ctx_compiled_print_context(const struct ly_ctx *orig_ctx, struct ly_ctx *ctx,
     /* modules, referenced, 2 loops because of augments (forward reference), build the ht first */
     ctxp_set(&orig_ctx->modules, &ctx->modules, mem);
     for (i = 0; i < ctx->modules.count; ++i) {
+        /* build the address ht */
         ctx->modules.objs[i] = *mem;
         *mem = (char *)*mem + sizeof(struct lys_module);
-
         ly_ctx_compiled_addr_ht_add(addr_ht, orig_ctx->modules.objs[i], ctx->modules.objs[i]);
     }
     for (i = 0; i < ctx->modules.count; ++i) {
+        /* parse the modules */
         ctxp_module(orig_ctx->modules.objs[i], ctx->modules.objs[i], addr_ht, ptr_set, mem);
     }