Documentation/site errors in 1.33
Hello, First of all congratulations on new release, I've installed it and it looks good so far, albeit we are not using much of Boost functionality. Couple of typos/errors I spotted. First of all on main page, in 1.33 announcement, Program Options Library: * Option descriptions are now printed with word wrapping. * Command line parser can bypass unregistered options, _instread_ of throwing. I.e. "instread" should read "instead". Secondly, looks like Boost.Test library has been restructured quite heavily, but compilation page in online documentation has not been updated. For example unit testing framework compilation page states that framework consists of execution_monitor.cpp test_tools.cpp unit_test_parameters.cpp unit_test_log.cpp unit_test_main.cpp unit_test_monitor.cpp unit_test_result.cpp supplied_log_formatters.cpp unit_test_suite.cpp even though unit_test_result.cpp and supplied_log_formatters.cpp do not exist anymore. Proper list of files should be compiler_log_formatter execution_monitor framework plain_report_formatter progress_monitor results_collector results_reporter test_tools unit_test_log unit_test_main unit_test_monitor unit_test_parameters unit_test_suite xml_log_formatter xml_report_formatter Same applies to test execution monitor too. Regards, Kirill.
In addition, I just wanted to note that whole Boost.Test documentation seems to be not updated to 1.33. It has release notes for 1.32 only, and for example BOOST_CHECK_EQUAL_COLLECTIONS still shows old 3 argument syntax, which is invalid anymore, 1.33 required 4 arguments. Also Boost.Test updates have not been mentioned in 1.33 announcemnt. Cheers, Kirill
In addition, I just wanted to note that whole Boost.Test documentation seems to be not updated to 1.33. It has release notes for 1.32 only, and for example BOOST_CHECK_EQUAL_COLLECTIONS still shows old 3 argument syntax, which is invalid anymore, 1.33 required 4 arguments.
These both statements doesn't seems to be true. Both release notes and test tools documentation were updated.
Also Boost.Test updates have not been mentioned in 1.33 announcemnt.
That is true and I plan to remedy is at least on site. Gennadiy
Gennadiy Rozental wrote:
In addition, I just wanted to note that whole Boost.Test documentation seems to be not updated to 1.33. It has release notes for 1.32 only, and for example BOOST_CHECK_EQUAL_COLLECTIONS still shows old 3 argument syntax, which is invalid anymore, 1.33 required 4 arguments.
These both statements doesn't seems to be true. Both release notes and test tools documentation were updated.
Please accept my apologies. I double checked it, and information is correct on the boost.org. I swear I saw old pages yesterday, but maybe browser on my home machine was picking web pages from cache. I will investigate it tonight. Kirill
Secondly, looks like Boost.Test library has been restructured quite heavily, but compilation page in online documentation has not been updated. For example unit testing framework compilation page states that framework consists of
I should have some time soon to concentrate on docs update. If we will have 1.33.1 it could go there. Gennadiy
participants (2)
-
Gennadiy Rozental -
Kirill Lapshin