Merge pull request #242 from schmouk/dev

Dev --> Main

Author: schmouk

README.md

@@ -1,4 +1,4 @@
-<img src="banner-image.jpg" width="512" height="454" alt="Library banner">
+<img src="./banner-image.jpg" width="512" height="454" alt="[Library banner]">
 
  [![license](http://img.shields.io/github/license/schmouk/pythonic-cpp-strings.svg?style=plastic&labelColor=blueviolet&color=lightblue)](https://github.com/schmouk/pythonic-cpp-strings/license)  [![Latest release](http://img.shields.io/github/release/schmouk/pythonic-cpp-strings.svg?style=plastic&labelColor=blueviolet&color=success)](https://github.com/schmouk/pythonic-cpp-strings/releases)  [![code_coverage](https://img.shields.io/badge/code_coverage-100%25-success?style=plastic&labelColor=blueviolet)]()  [![tests](https://img.shields.io/badge/tests-passing-success?style=plastic&labelColor=blueviolet)]()
 
@@ -75,9 +75,9 @@ This `.cpp` file is a great place to see **cpp-strings** code in action. Each st
 
 
 ---
-## Latest Release - Release 1.0 (1.0.2.232) 2025/07
+## Latest Release - Release 1.0 (1.0.4 - 2025/10)
 
-The coding of this project started by March 2023 and had been put in standby mode for some months - no time to work on it. The very first release is now availble (since July 2025), as **Release 1.0.2**.
+The coding of this project started by March 2023 and had been put in standby mode for some months - no time to work on it. The very first release is now availble (since July 2025), as **Release 1.0.4**.
 
 This release has been fully tested. Code coverage is 100%.
 
@@ -100,7 +100,7 @@ N.B. "*planned for a next release*" does not imply that a fixed date is planned
 ---
 ## Documentation
 
-The **cpp-strings** HTML documentation is available in subdirectory `cpp-strings/html`. Click on file `index.html` there from your local file manager to browse its content.
+The **cpp-strings** HTML documentation is available in subdirectory `./documentation`. Click on file `index.html` there from your local file manager to browse its content.
 
 It has then been produced with the great utility **doxygen** developed by Vicente Hernando (the doxygen Github repository can be accessed [here](https://github.com/doxygen/doxygen), and the utility can be downloaded from there: [https://www.doxygen.nl/download.html](https://www.doxygen.nl/download.html)).
 

cpp-strings/cpp-strings.cfg renamed to cpp-strings.cfg

@@ -27,7 +27,7 @@
 # Project related configuration options
 #---------------------------------------------------------------------------
 PROJECT_NAME           = "cpp-strings"
-PROJECT_NUMBER         = "1.0.0"
+PROJECT_NUMBER         = "1.0.4"
 PROJECT_BRIEF          = "Pythonic c++ strings"
 OUTPUT_DIRECTORY       = 
 
@@ -58,9 +58,9 @@ WARN_NO_PARAMDOC       = NO
 #---------------------------------------------------------------------------
 # Configuration options related to the input files
 #---------------------------------------------------------------------------
-INPUT                  = ./ ../
+INPUT                  = ./cpp-strings
 INPUT_ENCODING         = UTF-8
-USE_MDFILE_AS_MAINPAGE = ../README.md
+USE_MDFILE_AS_MAINPAGE = ./README.md
 
 #---------------------------------------------------------------------------
 # Configuration options related to source browsing
@@ -72,7 +72,7 @@ REFERENCES_RELATION    = YES
 # Configuration options related to the HTML output
 #---------------------------------------------------------------------------
 GENERATE_HTML          = YES
-HTML_OUTPUT            = html
+HTML_OUTPUT            = ./documentation
 HTML_FILE_EXTENSION    = .html
 HTML_COLORSTYLE_HUE    = 220
 HTML_COLORSTYLE_SAT    = 100
@@ -89,6 +89,11 @@ EXT_LINKS_IN_WINDOW    = NO
 SEARCHENGINE           = YES
 SERVER_BASED_SEARCH    = NO
 EXTERNAL_SEARCH        = NO
+SORT_GROUP_NAMES       = YES
+SOURCE_BROWSER         = NO
+VERBATIM_HEADERS       = NO
+WARN_IF_INCOMPLETE_DOC = NO
+WARN_IF_UNDOCUMENTED   = NO
 
 #---------------------------------------------------------------------------
 # Configuration options related to the LaTeX output

cpp-strings/cppstrings.h

@@ -835,7 +835,7 @@ namespace pcs // i.e. "pythonic c++ strings"
         *
         * Decimal characters are those that can be used to form numbers  in
         * base 10, e.g. U+0660, ARABIC-INDIC DIGIT ZERO. Formally a decimal
-        * character is a character in the Unicode General Category “Nd”.
+        * character is a character in the Unicode General Category �Nd�.
         */
         [[nodiscard]]
         inline const bool isdecimal() const noexcept
@@ -883,7 +883,7 @@ namespace pcs // i.e. "pythonic c++ strings"
         * the currently implemented rule is this simpler one:
         *
         *    identifier   ::= ID_Start id_continue*
-        *    id_continue  ::= ID_Start | <decimal number>
+        *    id_continue  ::= ID_Start | decimal_number
         */
         [[nodiscard]]
         inline const bool isidentifier() const noexcept
@@ -1654,18 +1654,18 @@ namespace pcs // i.e. "pythonic c++ strings"
         * Line breaks are not included in the resulting list unless keepends is given and true.
         *
         * This method splits on the following line boundaries. In particular, the boundaries are a superset of universal newlines:
-        * \n 	        Line Feed
-        * \r 	        Carriage Return
-        * \r\n 	        Carriage Return + Line Feed
-        * \v or \x0b 	Line Tabulation
-        * \f or \x0c 	Form Feed
-        * \x1c 	        File Separator
-        * \x1d 	        Group Separator
-        * \x1e 	        Record Separator
+        * '\n' 	            Line Feed
+        * '\r' 	            Carriage Return
+        * '\r\n' 	        Carriage Return + Line Feed
+        * '\v' or '\x0b' 	Line Tabulation
+        * '\f' or '\x0c' 	Form Feed
+        * '\x1c' 	        File Separator
+        * '\x1d' 	        Group Separator
+        * '\x1e' 	        Record Separator
         * Next separators values, detected by Python method splitlines(), are currently NOT detected by CppStrings
-        * \x85 	        Next Line (C1 Control Code)
-        * \u2028 	    Line Separator
-        * \u2029 	    Paragraph Separator
+        * '\x85' 	        Next Line (C1 Control Code)
+        * '\u2028' 	        Line Separator
+        * '\u2029' 	        Paragraph Separator
         */
         [[nodiscard]]
         std::vector<CppStringT> splitlines(const bool keep_end = false) const noexcept