[program_options] good work
I am really excited to see program_options progress. From my limited testing so far it looks really good, and I have been looking forward to using it in my code. I hope we can add it to boost soon, because I'm reluctant to rely on unreleased boost code. The doc needs work. It was hard for me to find the doc for the function parse_environment for example. There needs to be links from the top-level html page. Also, how can I build the html docs myself from the distributed xml? It looks like I need the "boost v2" build stuff, but I don't know what that means.
Hi Neal,
I am really excited to see program_options progress. From my limited testing so far it looks really good, and I have been looking forward to using it in my code. I hope we can add it to boost soon, because I'm reluctant to rely on unreleased boost code.
Thanks for your encouragement! I, too, hope that the library will be added to CVS soon -- the only issue that was specifically requested as needed before inclusion is Unicode support. I've already made up my mind how to best add it, but it might take a couple of weeks to discuss the approach and really implement it.
The doc needs work. It was hard for me to find the doc for the function parse_environment for example. There needs to be links from the top-level html page.
I though there should be annotated list of symbols: a table with a name of symbols (classes/functions) and a brief description. Maybe, it can be a full table for all symbols, or maybe several tables for each component. What do you think?
Also, how can I build the html docs myself from the distributed xml? It looks like I need the "boost v2" build stuff, but I don't know what that means.
In fact, "boost build v2" is the simplest thing of all, because it's already in boost. You'd need to get XSLT processor and Docbook and configure them as described in http://www.boost.org/regression-logs/cs-win32_metacomm/doc/html/boostbook.ge... After that, running "bjam --v2" in the "doc" directory should produce a bunch of html files. - Volodya
Also, how can I build the html docs myself from the distributed xml? It looks like I need the "boost v2" build stuff, but I don't know what that means.
In fact, "boost build v2" is the simplest thing of all, because it's already in boost. You'd need to get XSLT processor and Docbook and configure them as described in
http://www.boost.org/regression-logs/cs-win32_metacomm/doc/html/boostbook.ge...
After that, running "bjam --v2" in the "doc" directory should produce a bunch of html files.
1. Had to build new bjam from boost_1_31_0 jam-src. 2. Try it: [nbecker@rpppc1 /usr/local/src/boost_1_31_0/libs/program_options/doc]$ PATH=/usr/local/src/boost_1_31_0/tools/build/jam_src/bin.linuxx86:$PATH bjam --v2 /usr/local/src/boost_1_31_0/tools/build/v2/build/project.jam:213: in load-jamfile from module project error: Unable to load Jamfile. Could not find a Jamfile in directory '.'. Attempted to find it with pattern '[Jj]amfile.v2'. Please consult the documentation at 'http://www.boost.org'. /usr/local/src/boost_1_31_0/tools/build/v2/build/project.jam:67: in project.load from module project /usr/local/src/boost_1_31_0/tools/build/v2/build-system.jam:75: in load from module build-system /usr/local/src/boost_1_31_0/tools/build/v2/kernel/modules.jam:259: in import from module modules /usr/local/src/boost_1_31_0/tools/build/v2/kernel/bootstrap.jam:120: in boost-build from module /usr/local/src/boost_1_31_0/boost-build.jam:12: in module scope from module
Neal D. Becker wrote:
1. Had to build new bjam from boost_1_31_0 jam-src. 2. Try it: [nbecker@rpppc1 /usr/local/src/boost_1_31_0/libs/program_options/doc]$ PATH=/usr/local/src/boost_1_31_0/tools/build/jam_src/bin.linuxx86:$PATH bjam --v2 /usr/local/src/boost_1_31_0/tools/build/v2/build/project.jam:213: in load-jamfile from module project error: Unable to load Jamfile. Could not find a Jamfile in directory '.'. Attempted to find it with pattern '[Jj]amfile.v2'.
Could you rename "Jamfile" to "Jamfile.v2" and try again. If it works for you, I'll make the change. - Volodya
Vladimir Prus wrote:
Neal D. Becker wrote:
1. Had to build new bjam from boost_1_31_0 jam-src. 2. Try it: [nbecker@rpppc1 /usr/local/src/boost_1_31_0/libs/program_options/doc]$ PATH=/usr/local/src/boost_1_31_0/tools/build/jam_src/bin.linuxx86:$PATH bjam --v2 /usr/local/src/boost_1_31_0/tools/build/v2/build/project.jam:213: in load-jamfile from module project error: Unable to load Jamfile. Could not find a Jamfile in directory '.'. Attempted to find it with pattern '[Jj]amfile.v2'.
Could you rename "Jamfile" to "Jamfile.v2" and try again. If it works for you, I'll make the change.
Definately helps. Now I get some errors. I'll attach the messages (a bit long)
Neal D. Becker wrote:
Definately helps. Now I get some errors. I'll attach the messages (a bit long)
There are some things than can be done. First, you'd need to get boost/tools/boostbook from the CVS. A number of enhancements and fixes were made to BoostBook during the time I was documenting the library. Second, the 'project-root.jam' in program_options package contains my local setup, I think it should be removed or replaced with more proper initialization, see BoostBook docs for that. When you do that, don't forget to remove 'catalog.xml' in the doc directory. The remaining warnings are about undocumented members, I'll look at them. Hope everything will work after that. Actually, when I run bjam I get a error from BoostBook, but HTML is generated just fine. I hope BoostBook maintainers will solve that soon. - Volodya
participants (2)
-
Neal D. Becker -
Vladimir Prus