id	summary	reporter	owner	description	type	status	milestone	component	version	severity	resolution	keywords	cc
6114	Program options help message do not align across multiple groups	Leo Goodstadt <boost@…>	Vladimir Prus	"libs/program_options/src/options_description.cpp contains code to line up the description strings if the length of the options column > 23.

However, this does not take different groups into account.
The patch gets the column lengths from the subgroups as well.

Current situation:
{{{
Overall:

Option group 1:
  --opt1                Short option 1
  --option 2            Short option 2
                        ^
                        Aligned here

Option group 2:
  --much_longer_option arg Misaligned description in 2nd group if option column
                           length > magic 23 character limit
                           ^
                           Aligned here
}}}

Patched:
{{{
Overall:

Option group 1:
  --opt1                    Short option 1
  --option 2                Short option 2
                            ^
                            Aligned here

Option group 2:
  --much_longer_option arg  Misaligned description in 2nd group if option 
                            column length > magic 23 character limit
                            ^
                            Aligned here

}}}

is produced by this minimal program
{{{#!cpp
#include <iostream>
#include <boost/program_options.hpp>
namespace po = boost::program_options;

int main (int argc, char *argv[])
{
    // 1st group
    po::options_description groups1 (""Option group 1"");
    groups1.add_options()
        (""opt1"",     ""Short option 1"")
        (""option 2"", ""Short option 2\n^\nAligned here"");

    // 2nd group
    po::options_description groups2 (""Option group 2"");
    groups2.add_options()
      (""much_longer_option"", po::value<int>(), 
	   ""Misaligned description in 2nd group if option ""
	   ""column length > magic 23 character limit\n^\n""
	   ""Aligned here"");


    po::options_description cmdline_args(""Overall"");
    cmdline_args.add(groups1);
    cmdline_args.add(groups2);
    std::cerr << cmdline_args << ""\n"";

    return 0;
}
}}}"	Patches	closed	To Be Determined	program_options	Boost 1.47.0	Problem	fixed	Program options help description