CPP-AP: version 3.0.0

CMakeLists.txt

@@ -7,7 +7,7 @@ else()
 endif()
 
 project(cpp-ap
-    VERSION 2.7.0
+    VERSION 3.0.0
     DESCRIPTION "Command-line argument parser for C++20"
     HOMEPAGE_URL "https://github.com/SpectraL519/cpp-ap"
     LANGUAGES CXX

Doxyfile

@@ -48,7 +48,7 @@ PROJECT_NAME           = CPP-AP
 # could be handy for archiving the generated documentation or if some version
 # control system is used.
 
-PROJECT_NUMBER         = 2.7.0
+PROJECT_NUMBER         = 3.0.0
 
 # Using the PROJECT_BRIEF tag one can provide an optional one line description
 # for a project that appears at the top of each page and should give viewer a
@@ -989,7 +989,7 @@ INPUT_FILE_ENCODING    =
 # be provided as doxygen C comment), *.py, *.pyw, *.f90, *.f95, *.f03, *.f08,
 # *.f18, *.f, *.for, *.vhd, *.vhdl, *.ucf, *.qsf and *.ice.
 
-FILE_PATTERNS          = *.c *.cpp *.h *.hpp *.md *.py
+FILE_PATTERNS          = *.c *.cpp *.h *.hpp *.md *.py *.dox
 
 # The RECURSIVE tag can be used to specify whether or not subdirectories should
 # be searched for input files as well.

MODULE.bazel

@@ -1,4 +1,4 @@
 module(
     name = "cpp-ap",
-    version = "2.7.0",
+    version = "3.0.0",
 )

README.md

@@ -34,7 +34,7 @@ Command-line argument parser for C++20
 
 > [!NOTE]
 >
-> [v1.0](https://github.com/SpectraL519/cpp-ap/commit/9a9e5360766b732f322ae2efe3cf5ec5f9268eef) of the library has been developed for the *Team Programming* course at the *Wrocław University of Science and Technology*.
+> [v1.0](https://github.com/SpectraL519/cpp-ap/releases/tag/v1.0) of the library has been developed for the *Team Programming* course at the *Wrocław University of Science and Technology*.
 >
 > Faculty: *W04N - Faculty of Information and Communication Technology*
 >
@@ -53,14 +53,33 @@ Command-line argument parser for C++20
     - [Downloading the Library](/docs/tutorial.md#downloading-the-library)
   - [The Parser Class](/docs/tutorial.md#the-parser-class)
   - [Adding Arguments](/docs/tutorial.md#adding-arguments)
+    - [Syntax](/docs/tutorial.md#syntax)
+    - [Names](/docs/tutorial.md#names)
+    - [Value Types](/docs/tutorial.md#value-types)
+    - [Boolean Flags](/docs/tutorial.md#boolean-flags)
   - [Argument Parameters](/docs/tutorial.md#argument-parameters)
+    - [Common Parameters](/docs/tutorial.md#common-parameters)
+    - [Parameters Specific for Optional Arguments](/docs/tutorial.md#parameters-specific-for-optional-arguments)
   - [Default Arguments](/docs/tutorial.md#default-arguments)
+  - [Argument Groups](/docs/tutorial.md#argument-groups)
+    - [Creating New Groups](/docs/tutorial.md#creating-new-groups)
+    - [Adding Arguments to Groups](/docs/tutorial.md#adding-arguments-to-groups)
+    - [Group Attributes](/docs/tutorial.md#group-attributes)
+    - [Complete Example](/docs/tutorial.md#complete-example)
+    - [Suppressing Argument Group Checks](/docs/tutorial.md#suppressing-argument-group-checks)
   - [Parsing Arguments](/docs/tutorial.md#parsing-arguments)
-    - [Argument Parsing Rules](/docs/tutorial.md#argument-parsing-rules)
+    - [Basic Argument Parsing Rules](/docs/tutorial.md#basic-argument-parsing-rules)
     - [Compound Arguments](/docs/tutorial.md#compound-arguments)
     - [Parsing Known Arguments](/docs/tutorial.md#parsing-known-arguments)
   - [Retrieving Argument Values](/docs/tutorial.md#retrieving-argument-values)
+  - [Subparsers](/docs/tutorial.md#subparsers)
+    - [Creating Subparsers](/docs/tutorial.md#creating-subparsers)
+    - [Using Multiple Subparsers](/docs/tutorial.md#using-multiple-subparsers)
+    - [Parsing Arguments with Subparsers](/docs/tutorial.md#parsing-arguments-with-subparsers)
+    - [Tracking Parser State](/docs/tutorial.md#tracking-parser-state)
+    - [Suppressing Argument Group Checks](/docs/tutorial.md#suppressing-argument-group-checks)
   - [Examples](/docs/tutorial.md#examples)
+  - [Common Utility](/docs/tutorial.md#common-utility)
 - [Dev notes](/docs/dev_notes.md#dev-notes)
   - [Building and testing](/docs/dev_notes.md#building-and-testing)
   - [Formatting](/docs/dev_notes.md#formatting)

docs/groups.dox

@@ -0,0 +1,9 @@
+/**
+ * @file groups.dox
+ * @brief Defines custom groups for documentation.
+ */
+
+/**
+ * @defgroup util Utility
+ * @brief Helper functions, types, concepts, etc.
+ */