Commit #144

ChangeLog

@@ -2,6 +2,16 @@ Change Log {#changelog}
 =======================
 
 
+## 1.14.2 -- 2020-09-24
+
+Changes:
+
+* Improved re-implementation of `stdbool.h` in case of `--with-io-api=nolibc`
+* Documentation
+* Examples
+* General package maintenance
+
+
 ## 1.14.1 -- 2020-05-11
 
 Changes:

Makefile.am

@@ -31,7 +31,7 @@ dist_doc_DATA = \
 	AUTHORS \
 	COPYING
 
-OPTINSTALL =
+_am_installalso_ =
 
 _examples_insthook_ =
 
@@ -66,6 +66,7 @@ dist_examplesinifiles_DATA = \
 	examples/ini_files/bad_ini.conf \
 	examples/ini_files/delivery.conf \
 	examples/ini_files/extreme_ini.conf \
+	examples/ini_files/log.ini \
 	examples/ini_files/hash_table.conf \
 	examples/ini_files/pacman.conf \
 	examples/ini_files/self_explaining.conf \
@@ -76,6 +77,7 @@ dist_examplesinifiles_DATA = \
 examplesmiscdir = $(examplesdir)/miscellanea
 dist_examplesmisc_DATA = \
 	examples/miscellanea/colon_as_delimiter.c \
+	examples/miscellanea/cplusplus.cpp \
 	examples/miscellanea/disambiguate.c \
 	examples/miscellanea/dispatch_everything.c \
 	examples/miscellanea/glib_hash_table.c \
@@ -125,7 +127,7 @@ endif WANT_EXAMPLES
 
 if WANT_HTML
 
-OPTINSTALL += \
+_am_installalso_ += \
 	install-html;
 
 endif WANT_HTML
@@ -224,6 +226,10 @@ RUNJOB = $(INSTALLFLAVOR)
 # Sandbox default path (one word only allowed)
 SANDBOX = volatile
 
+GITFLAGS = \
+	--quiet \
+	--progress
+
 
 ###############################################################################
 ##    R E C I P E S   P A R T   I :   D E V E L O P M E N T   A N D   U S A G E
@@ -237,7 +243,7 @@ install-html-local: $(srcdir)/docs/html $(srcdir)/docs/index.html
 	$(INSTALL_DATA) {} '$(DESTDIR)$(htmldir)/{}' \;) && mv \
 	'$(DESTDIR)$(htmldir)/html' '$(DESTDIR)$(htmldir)/htmldoc';
 
-install-data-local: $(OPTINSTALL)
+install-data-local: $(_am_installalso_)
 
 install-data-hook:
 	$(_examples_insthook_)
@@ -413,7 +419,8 @@ CLEANFILES += \
 	echo; } 1>&2; exit 2; fi; case ' $(APPROVE) ' in *' revision '*) \
 	$(MKDIR_P) 'no-dist/.archived'; mv '$(rvdir)/$(nonportfile)' \
 	'$@'; rmdir '$(rvdir)' 2> /dev/null || :; echo \
-	'User'\''s revision has been accepted.'; ;; *) { echo; echo \
+	'User'\''s revision has been accepted. To undo this, launch `$(MAKE) reject-revision`.'; \
+	;; *) { echo; echo \
 	'There are pending revisions. Please revise the content of the `$(rvdir)`'; \
 	echo \
 	'subdirectory, then launch `$(MAKE) approve-revision` after you are done.'; \
@@ -535,9 +542,10 @@ sandbox-dist sandbox-distdir: sandbox-erase
 
 .PHONY: sandbox-source-release
 sandbox-source-release: sandbox-dist
-	@for _FILE in $$(cd '$(SANDBOX)' && $(FIND) -L . ! -name '.'); do ! \
-	test -L '$(srcdir)/'"$${_FILE}" || (rm -rf '$(SANDBOX)/'"$${_FILE}" \
-	&& cp -d '$(srcdir)/'"$${_FILE}" '$(SANDBOX)/'"$${_FILE}"); done;
+	@case ' $(DISTFLAGS) ' in *' no-symlinks '*) : ;; *) for _FILE in \
+	$$(cd '$(SANDBOX)' && $(FIND) -L . ! -name '.'); do ! test -L \
+	'$(srcdir)/'"$${_FILE}" || (rm -rf '$(SANDBOX)/'"$${_FILE}" && cp -d \
+	'$(srcdir)/'"$${_FILE}" '$(SANDBOX)/'"$${_FILE}"); done ;; esac;
 
 .PHONY: sandbox-authors-copy
 sandbox-authors-copy: sandbox-source-release
@@ -556,7 +564,7 @@ sandbox-snapshot:
 
 .PHONY: sandbox-git-clone
 sandbox-git-clone: sandbox-erase
-	@git clone --quiet --progress \
+	@git clone $(GITFLAGS) \
 	'@GIT_HTTP_SERVER@/@PUBLISHER_ID@/@PACKAGE_TARNAME@.git' '$(SANDBOX)';
 
 # Non-phony targets with names editable on the fly (mostly `Makefile` glue, but
@@ -730,7 +738,7 @@ snapshot:
 	@if test 'x$(DEST)' != x; then rm -rf '$(DEST)' && $(MAKE) "$$(expr \
 	'BAKPATH=$(DEST)' : '\(.*\)\($(_re_archive_allow_)\)' || \
 	echo BAKPATH='$(DEST)')" '$(DEST)'; else \
-	_STAMP="$$(date '+%Y-%m-%d-%H.%M.%S')" && rm -rf \
+	_STAMP="$$(date '+%Y-%m-%d-%H-%M-%S')" && rm -rf \
 	'$(BAKPATH)-'"$${_STAMP}"'.$(ZIPTYPE)' && $(MAKE) \
 	BAKPATH='$(BAKPATH)-'"$${_STAMP}" \
 	'$(BAKPATH)-'"$${_STAMP}"'.$(ZIPTYPE)'; fi;

README

@@ -19,9 +19,9 @@ simple to use.
 
 With **libconfini** you will find in INI files the same serialization power you
 would normally find in other heavily structured formats (such as JSON, YAML,
-TOML), but with the advantage of using the most human-readable configuration
+TOML), but with the advantage of using the most human-friendly configuration
 format ever invented (thanks to their informal status, INI files are indeed
-more fluid, expressive and human-readable than formats explicitly designed with
+more fluid, expressive and human-friendly than formats explicitly designed with
 the same purpose, such as YAML and TOML). The library's main goal is to be
 uncommonly powerful in the most tedious and error-prone task when parsing a
 text file in C: string handling. Thanks to this the the programmer is left free

autostuff/chunks/revision-warning.c

@@ -5,6 +5,7 @@
     ever revised this content, although someone should have. If you are instead
     that human appointed to review this code before it is pasted to the public
     header, please remove this text.
+
     If a "standard" header providing these objects is available for your
     platform, please replace the entire section below with the following
     content:

autostuff/doxygen/doxyfile.conf

@@ -1,4 +1,4 @@
-# Doxyfile 1.8.17
+# Doxyfile 1.8.20
 
 # This file describes the settings to be used by the documentation system
 # doxygen (www.doxygen.org) for a project.
@@ -227,6 +227,14 @@ QT_AUTOBRIEF           = NO
 
 MULTILINE_CPP_IS_BRIEF = NO
 
+# By default Python docstrings are displayed as preformatted text and doxygen's
+# special commands cannot be used. By setting PYTHON_DOCSTRING to NO the
+# doxygen's special commands can be used and the contents of the docstring
+# documentation blocks is shown as doxygen documentation.
+# The default value is: YES.
+
+PYTHON_DOCSTRING       = YES
+
 # If the INHERIT_DOCS tag is set to YES then an undocumented member inherits the
 # documentation from any documented member that it re-implements.
 # The default value is: YES.
@@ -266,12 +274,6 @@ ALIASES                = "startfnlist=\page fnoverview ^^<dl>" \
                          "utility{1}=\page fnoverview ^^<dt>`\1()`</dt><dd>\copybrief \1 </dd>" \
                          "alias{1}=\utility{\1}^^^^\var \1^^\brief "
 
-# This tag can be used to specify a number of word-keyword mappings (TCL only).
-# A mapping has the form "name=value". For example adding "class=itcl::class"
-# will allow you to use the command class in the itcl::class meaning.
-
-TCL_SUBST              =
-
 # Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C sources
 # only. Doxygen will then generate output that is more tailored for C. For
 # instance, some of the names that are used will be different. The list of all
@@ -313,13 +315,13 @@ OPTIMIZE_OUTPUT_SLICE  = NO
 # extension. Doxygen has a built-in mapping, but you can override or extend it
 # using this tag. The format is ext=language, where ext is a file extension, and
 # language is one of the parsers supported by doxygen: IDL, Java, JavaScript,
-# Csharp (C#), C, C++, D, PHP, md (Markdown), Objective-C, Python, Slice,
+# Csharp (C#), C, C++, D, PHP, md (Markdown), Objective-C, Python, Slice, VHDL,
 # Fortran (fixed format Fortran: FortranFixed, free formatted Fortran:
 # FortranFree, unknown formatted Fortran: Fortran. In the later case the parser
 # tries to guess whether the code is fixed or free formatted code, this is the
-# default for Fortran type files), VHDL, tcl. For instance to make doxygen treat
-# .inc files as Fortran files (default is PHP), and .f files as C (default is
-# Fortran), use: inc=Fortran f=C.
+# default for Fortran type files). For instance to make doxygen treat .inc files
+# as Fortran files (default is PHP), and .f files as C (default is Fortran),
+# use: inc=Fortran f=C.
 #
 # Note: For files without extension you can use no_extension as a placeholder.
 #
@@ -458,6 +460,19 @@ TYPEDEF_HIDES_STRUCT   = NO
 
 LOOKUP_CACHE_SIZE      = 0
 
+# The NUM_PROC_THREADS specifies the number threads doxygen is allowed to use
+# during processing. When set to 0 doxygen will based this on the number of
+# cores available in the system. You can set it explicitly to a value larger
+# than 0 to get more control over the balance between CPU load and processing
+# speed. At this moment only the input processing can be done using multiple
+# threads. Since this is still an experimental feature the default is set to 1,
+# which efficively disables parallel processing. Please report any issues you
+# encounter. Generating dot graphs in parallel is controlled by the
+# DOT_NUM_THREADS setting.
+# Minimum value: 0, maximum value: 32, default value: 1.
+
+NUM_PROC_THREADS       = 1
+
 #---------------------------------------------------------------------------
 # Build related configuration options
 #---------------------------------------------------------------------------
@@ -562,7 +577,7 @@ INTERNAL_DOCS          = NO
 # names in lower-case letters. If set to YES, upper-case letters are also
 # allowed. This is useful if you have classes or files whose names only differ
 # in case and if your file system supports case sensitive file names. Windows
-# (including Cygwin) ands Mac users are advised to set this option to NO.
+# (including Cygwin) and Mac users are advised to set this option to NO.
 # The default value is: system dependent.
 
 CASE_SENSE_NAMES       = YES
@@ -865,7 +880,7 @@ INPUT_ENCODING         = UTF-8
 # *.hh, *.hxx, *.hpp, *.h++, *.cs, *.d, *.php, *.php4, *.php5, *.phtml, *.inc,
 # *.m, *.markdown, *.md, *.mm, *.dox (to be provided as doxygen C comment),
 # *.doc (to be provided as doxygen C comment), *.txt (to be provided as doxygen
-# C comment), *.py, *.pyw, *.f90, *.f95, *.f03, *.f08, *.f, *.for, *.tcl, *.vhd,
+# C comment), *.py, *.pyw, *.f90, *.f95, *.f03, *.f08, *.f18, *.f, *.for, *.vhd,
 # *.vhdl, *.ucf, *.qsf and *.ice.
 
 FILE_PATTERNS          = *.c \
@@ -1389,7 +1404,7 @@ CHM_FILE               =
 HHC_LOCATION           =
 
 # The GENERATE_CHI flag controls if a separate .chi index file is generated
-# (YES) or that it should be included in the master .chm file (NO).
+# (YES) or that it should be included in the main .chm file (NO).
 # The default value is: NO.
 # This tag requires that the tag GENERATE_HTMLHELP is set to YES.
 
@@ -1551,6 +1566,17 @@ TREEVIEW_WIDTH         = 250
 
 EXT_LINKS_IN_WINDOW    = NO
 
+# If the HTML_FORMULA_FORMAT option is set to svg, doxygen will use the pdf2svg
+# tool (see https://github.com/dawbarton/pdf2svg) or inkscape (see
+# https://inkscape.org) to generate formulas as SVG images instead of PNGs for
+# the HTML output. These images will generally look nicer at scaled resolutions.
+# Possible values are: png (the default) and svg (looks nicer but requires the
+# pdf2svg or inkscape tool).
+# The default value is: png.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_FORMULA_FORMAT    = png
+
 # Use this tag to change the font size of LaTeX formulas included as images in
 # the HTML documentation. When you change the font size after a successful
 # doxygen run you need to manually remove any form_*.png images from the HTML
@@ -1606,7 +1632,7 @@ MATHJAX_FORMAT         = HTML-CSS
 # Content Delivery Network so you can quickly see the result without installing
 # MathJax. However, it is strongly recommended to install a local copy of
 # MathJax from https://www.mathjax.org before deployment.
-# The default value is: https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/.
+# The default value is: https://cdn.jsdelivr.net/npm/mathjax@2.
 # This tag requires that the tag USE_MATHJAX is set to YES.
 
 MATHJAX_RELPATH        = http://cdn.mathjax.org/mathjax/latest
@@ -1845,9 +1871,11 @@ LATEX_EXTRA_FILES      =
 
 PDF_HYPERLINKS         = YES
 
-# If the USE_PDFLATEX tag is set to YES, doxygen will use pdflatex to generate
-# the PDF file directly from the LaTeX files. Set this option to YES, to get a
-# higher quality PDF documentation.
+# If the USE_PDFLATEX tag is set to YES, doxygen will use the engine as
+# specified with LATEX_CMD_NAME to generate the PDF file directly from the LaTeX
+# files. Set this option to YES, to get a higher quality PDF documentation.
+#
+# See also section LATEX_CMD_NAME for selecting the engine.
 # The default value is: YES.
 # This tag requires that the tag GENERATE_LATEX is set to YES.
 

autostuff/doxygen/dpi.dox

@@ -35,8 +35,10 @@ Here follows the list of public functions available with **libconfini**. Almost
 each of them is independent, therefore if you are compiling the library you may
 decide to remove the functions listed below from the code according to your
 needs, with the only exceptions of `ini_string_match_ii()`, required by
-`ini_array_match()`, and `strip_ini_cache()`, required by both
-`load_ini_file()` and `load_ini_path()`.
+`ini_array_match()` (you could still remove both though), and
+`strip_ini_cache()`, required by both `load_ini_file()` and `load_ini_path()`
+(you could remove these three functions altogether as well, but you would make
+the library virtually useless).
 
 
 

autostuff/m4/not-autotools.m4

@@ -315,7 +315,7 @@ AC_DEFUN_ONCE([NC_CONFIG_SHADOW_DIR], [
 			changes only and not on the state of this machine; possible values
 			for MODE are: omitted or "yes" or "merge" for updating these files
 			immediately, "sandbox" for safely putting their updated version
-			into the ]m4_quote(NC_CONFNEW_SUBDIR)[ directory without modifying
+			into the `]m4_quote(NC_CONFNEW_SUBDIR)[` directory without modifying
 			the package tree, or "no" for doing nothing @<:@default=no@:>@])],
 			[AS_IF([test "x${enableval}" = x -o "x${enableval}" = xyes],
 					[AS_VAR_SET([enable_extended_config], ['merge'])],