update changelog for version 2.6.2 (#1297)

update changelog and readme for release 2.6.2

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Henry Schreiner <henry.fredrick.schreiner@cern.ch>

Author: 3 people

CHANGELOG.md

@@ -2,6 +2,71 @@
 
 ## Unreleased
 
+## Version 2.6.2
+
+This version adds C++20 modules support, additional controls for help output and
+finer grained control for extras handling and prefix command operation. Fixes
+compatibility issues with C++26 and Windows and a number of small issue with
+help output and specific combinations of options and conditions.
+
+### Added
+
+- Added C++20 modules support with new module files and tests. [#1286][]
+- Added configuration modes for extras handling: `AssumeMultipleArguments` and
+  `AssumeSingleArgument`. [#1270][]
+- Added option for full install including impl headers with precompiled option.
+  [#1252][]
+- Added improvements to prefix commands including `PrefixCommandMode` and
+  separator specification. [#1266][]
+- Added controls for option name formatting in help output, allowing disabling
+  of default values, flags, and type names. [#1247][]
+- Added refactor of Meson build system with updated version and new options.
+  [#1280][]
+- Added support for Bazel 9. [#1287][]
+- Added module testing infrastructure. [#1255][]
+
+### Changed
+
+- Changed default to install impl headers even when precompiled option is
+  selected. [#1291][]
+- Updated copyright dates to 2026. [#1283][]
+- Updated CI pipelines including Azure Pipelines and GitHub workflows.
+  [#1267][], [#1283][]
+- Updated documentation and book chapters. [#1250][]
+
+### Fixed
+
+- Fixed extra spaces in option and app descriptions. [#1295][]
+- Fixed option searching to use fallthrough in parent apps. [#1292][]
+- Fixed C++26 template ambiguity for `std::complex`. [#1278][]
+- Fixed UTF-8 config filenames not supported on Windows. [#1273][]
+- Fixed enumeration stream output generating unconvertible strings if certain a
+  user supplied stream conversion method was supplied [#1261][]
+- Fixed code simplification issues by removing use of `static std::string` which
+  was causing some heap allocation issues when using CLI11 as part of DLL on
+  certain operating systems [#1244][]
+- Fixed MISRACPP2023-25_5_2-a-1 rule violation [#1299][]
+
+[#1299]: https://github.com/CLIUtils/CLI11/pull/1299
+[#1286]: https://github.com/CLIUtils/CLI11/pull/1286
+[#1270]: https://github.com/CLIUtils/CLI11/pull/1270
+[#1252]: https://github.com/CLIUtils/CLI11/pull/1252
+[#1266]: https://github.com/CLIUtils/CLI11/pull/1266
+[#1247]: https://github.com/CLIUtils/CLI11/pull/1247
+[#1280]: https://github.com/CLIUtils/CLI11/pull/1280
+[#1287]: https://github.com/CLIUtils/CLI11/pull/1287
+[#1255]: https://github.com/CLIUtils/CLI11/pull/1255
+[#1291]: https://github.com/CLIUtils/CLI11/pull/1291
+[#1283]: https://github.com/CLIUtils/CLI11/pull/1283
+[#1267]: https://github.com/CLIUtils/CLI11/pull/1267
+[#1250]: https://github.com/CLIUtils/CLI11/pull/1250
+[#1295]: https://github.com/CLIUtils/CLI11/pull/1295
+[#1292]: https://github.com/CLIUtils/CLI11/pull/1292
+[#1278]: https://github.com/CLIUtils/CLI11/pull/1278
+[#1273]: https://github.com/CLIUtils/CLI11/pull/1273
+[#1261]: https://github.com/CLIUtils/CLI11/pull/1261
+[#1244]: https://github.com/CLIUtils/CLI11/pull/1244
+
 ## Version 2.6.1
 
 Patch fixing some compile issues in specific situations in the recent release,
@@ -21,7 +86,6 @@ and a potential segmentation fault from specially crafted config files
   potential memory issues when CLI11 is used with shared libraries, this likely
   isn't a bug but the fix did result in smaller code size so was kept. [#1244][]
 
-[#1244]: https://github.com/CLIUtils/CLI11/pull/1244
 [#1238]: https://github.com/CLIUtils/CLI11/pull/1238
 [#1239]: https://github.com/CLIUtils/CLI11/pull/1239
 

LICENSE

@@ -1,4 +1,4 @@
-CLI11 2.6 Copyright (c) 2017-2026 University of Cincinnati, developed by Henry
+CLI11 2.6.2 Copyright (c) 2017-2026 University of Cincinnati, developed by Henry
 Schreiner under NSF AWARD 1414736. All rights reserved.
 
 Redistribution and use in source and binary forms of CLI11, with or without

README.md

@@ -72,16 +72,16 @@ Features that were added in the last released minor version are marked with
 ### Introduction
 
 CLI11 provides all the features you expect in a powerful command line parser,
-with a beautiful, minimal syntax and no dependencies beyond C++11. It is header
-only, and comes in a single file form for easy inclusion in projects. It is easy
-to use for small projects, but powerful enough for complex command line
+with a beautiful, minimal syntax and no dependencies beyond C++11. It is
+header-only, and comes in a single file form for easy inclusion in projects. It
+is easy to use for small projects, but powerful enough for complex command line
 projects, and can be customized for frameworks. It is tested on [Azure][] and
 [GitHub Actions][actions-link], and was originally used by the [GooFit GPU
 fitting framework][goofit]. It was inspired by [`plumbum.cli`][plumbum] for
-Python. CLI11 has a user friendly introduction in this README, a more in-depth
+Python. CLI11 has a user-friendly introduction in this README, a more in-depth
 tutorial [GitBook][], as well as [API documentation][api-docs] generated by
 Travis. See the [changelog](./CHANGELOG.md) or [GitHub Releases][] for details
-for current and past releases. Also see the [Version 1.0 post][], [Version 1.3
+on current and past releases. Also see the [Version 1.0 post][], [Version 1.3
 post][], [Version 1.6 post][], or [Version 2.0 post][] for more information.
 
 You can be notified when new releases are made by subscribing to
@@ -115,7 +115,7 @@ An acceptable CLI parser library should be all of the following:
 - Ability to add a configuration file (`TOML`, `INI`, or custom format), and
   produce it as well.
 - Produce real values that can be used directly in code, not something you have
-  pay compute time to look up, for HPC applications.
+  to pay compute time to look up, for HPC applications.
 - Work with common types, simple custom types, and extensible to exotic types.
 - Permissively licensed.
 
@@ -172,20 +172,20 @@ this library:
   suggested close matches.
 - Autocomplete: This might eventually be added to both Plumbum and CLI11, but it
   is not supported yet.
-- While not recommended, CLI11 does now support non standard option names such
+- While not recommended, CLI11 does now support non-standard option names such
   as `-option`. This is enabled through `allow_non_standard_option_names()`
   modifier on an app.
 
 ## Install
 
-To use, the most common methods are described here additional methods and
+To use, the most common methods are described here, additional methods and
 details are available at [installation][]:
 
 - All-in-one local header: Copy `CLI11.hpp` from the [most recent
   release][github releases] into your include directory, and you are set. This
   is combined from the source files for every release. This includes the entire
   command parser library, but does not include separate utilities (like `Timer`,
-  `AutoTimer`). The utilities are completely self contained and can be copied
+  `AutoTimer`). The utilities are completely self-contained and can be copied
   separately.
 - All-in-one global header: Like above, but copying the file to a shared folder
   location like `/opt/CLI11`. Then, the C++ include path has to be extended to
@@ -1126,8 +1126,8 @@ option_groups. These are:
   executes after the first argument of an application is processed. See
   [Subcommand callbacks](#callbacks) for some additional details.
 - `.allow_extras()`: Do not throw an error if extra arguments are left over.
-- `.allow_extras(CLI::ExtrasMode)`: Specify the method of handling unrecognized
-  arguments.
+- `.allow_extras(CLI::ExtrasMode)`: 🆕 Specify the method of handling
+  unrecognized arguments.
   - `CLI::ExtrasMode::Error`: generate an error on unrecognized argument. Same
     as `.allow_extras(false)`.
   - `CLI::ExtrasMode::ErrorImmediately`: generate an error immediately on
@@ -1151,8 +1151,8 @@ option_groups. These are:
   remaining_arg list. It is ideal for allowing your app or subcommand to be a
   "prefix" to calling another app. Can be called with a `bool` value to turn on
   or off
-- `.prefix_command(CLI::PrefixCommandMode)`: specify the prefix_command mode to
-  use. `PrefixCommandMode::on` and `PrefixCommandMode::off` are the same as
+- `.prefix_command(CLI::PrefixCommandMode)`: 🆕 specify the prefix_command mode
+  to use. `PrefixCommandMode::on` and `PrefixCommandMode::off` are the same as
   `prefix_command(true)` or `prefix_command(false)`. Calling with
   `PrefixCommandMode::separator_only` will only trigger prefix command mode by
   the use of the subcommand separator `--` other unrecognized arguments would be

include/CLI/Version.hpp

@@ -12,7 +12,7 @@
 
 #define CLI11_VERSION_MAJOR 2
 #define CLI11_VERSION_MINOR 6
-#define CLI11_VERSION_PATCH 1
-#define CLI11_VERSION "2.6.1"
+#define CLI11_VERSION_PATCH 2
+#define CLI11_VERSION "2.6.2"
 
 // [CLI11:version_hpp:end]