Generating documentation
Hi, Just curious, has anyone been able to get the documentation generated (on a linux platform) by following the instructions in http://www.boost.org/doc/libs/1_58_0/doc/html/boostbook/getting/started.html ?? Alternatively, is there a place where the documentation is generated for develop and/or master branch ? Thanks Not that the error messages make much sense, but FWIW, right now, I'm stuck with: [alainm@tagir doc]$ ../../../b2 html Performing configuration checks - 32-bit : no (cached) - 64-bit : yes (cached) - arm : no (cached) - mips1 : no (cached) - power : no (cached) - sparc : no (cached) - x86 : yes (cached) - symlinks supported : yes (cached) /gpfs/scratch/alainm/view/modular-boost/tools/build/src/tools/boostbook.jam:683: in construct warning: object is empty /gpfs/scratch/alainm/view/modular-boost/tools/build/src/build/targets.jam:1336: in class@basic-target.generate /gpfs/scratch/alainm/view/modular-boost/tools/build/src/build/targets.jam:757: in generate-really /gpfs/scratch/alainm/view/modular-boost/tools/build/src/build/targets.jam:729: in class@main-target.generate /gpfs/scratch/alainm/view/modular-boost/tools/build/src/build/targets.jam:272: in class@project-target.generate /gpfs/scratch/alainm/view/modular-boost/tools/build/src/build-system.jam:707: in load /gpfs/scratch/alainm/view/modular-boost/tools/build/src/kernel/modules.jam:289: in import /gpfs/scratch/alainm/view/modular-boost/tools/build/src/kernel/bootstrap.jam:139: in boost-build /gpfs/scratch/alainm/view/modular-boost/boost-build.jam:17: in module scope /gpfs/scratch/alainm/view/modular-boost/tools/build/src/tools/boostbook.jam:693: in construct warning: object is empty /gpfs/scratch/alainm/view/modular-boost/tools/build/src/build/targets.jam:1336: in class@basic-target.generate /gpfs/scratch/alainm/view/modular-boost/tools/build/src/build/targets.jam:757: in generate-really /gpfs/scratch/alainm/view/modular-boost/tools/build/src/build/targets.jam:729: in class@main-target.generate /gpfs/scratch/alainm/view/modular-boost/tools/build/src/build/targets.jam:272: in class@project-target.generate /gpfs/scratch/alainm/view/modular-boost/tools/build/src/build-system.jam:707: in load /gpfs/scratch/alainm/view/modular-boost/tools/build/src/kernel/modules.jam:289: in import /gpfs/scratch/alainm/view/modular-boost/tools/build/src/kernel/bootstrap.jam:139: in boost-build /gpfs/scratch/alainm/view/modular-boost/boost-build.jam:17: in module scope /gpfs/scratch/alainm/view/modular-boost/tools/build/src/tools/boostbook.jam:707: in construct warning: object is empty /gpfs/scratch/alainm/view/modular-boost/tools/build/src/build/targets.jam:1336: in class@basic-target.generate /gpfs/scratch/alainm/view/modular-boost/tools/build/src/build/targets.jam:757: in generate-really /gpfs/scratch/alainm/view/modular-boost/tools/build/src/build/targets.jam:729: in class@main-target.generate /gpfs/scratch/alainm/view/modular-boost/tools/build/src/build/targets.jam:272: in class@project-target.generate /gpfs/scratch/alainm/view/modular-boost/tools/build/src/build-system.jam:707: in load /gpfs/scratch/alainm/view/modular-boost/tools/build/src/kernel/modules.jam:289: in import /gpfs/scratch/alainm/view/modular-boost/tools/build/src/kernel/bootstrap.jam:139: in boost-build /gpfs/scratch/alainm/view/modular-boost/boost-build.jam:17: in module scope ...found 1 target... [alainm@tagir doc]$ -- --- Alain
Just curious, has anyone been able to get the documentation generated (on a linux platform) by following the instructions in http://www.boost.org/doc/libs/1_58_0/doc/html/boostbook/getting/started.html
Yes, but the setup process isn't straightforward: it is documented here though: https://svn.boost.org/trac/boost/wiki/BoostDocs/GettingStarted There is also a test project under /doc/test/ that you can use to verify you have everything setup correctly before proceeding further. HTH, John.
Thanks, A few more questions: On 20/04/2015 19:50, John Maddock wrote:
Just curious, has anyone been able to get the documentation generated (on a linux platform) by following the instructions in http://www.boost.org/doc/libs/1_58_0/doc/html/boostbook/getting/started.html
Yes, but the setup process isn't straightforward: it is documented here though: https://svn.boost.org/trac/boost/wiki/BoostDocs/GettingStarted
There is also a test project under /doc/test/ that you can use to verify you have everything setup correctly before proceeding further.
As such, the test fails with: [alainm@tagir test]$ ../../b2 -d2 Jamfile.v2:71: in modules.load ERROR: rule "doxygen" unknown in module "Jamfile". ... Things go better if I replace "import doxygen ;" with "using doxygen ;" in the test's Jamfile. Is it a typo in the Jamfile or am I missing something ? After that "fix/modification", I get: [alainm@tagir test]$ ../../b2 Performing configuration checks - 32-bit : no (cached) - 64-bit : yes (cached) - arm : no (cached) - mips1 : no (cached) - power : no (cached) - sparc : no (cached) - x86 : yes (cached) - symlinks supported : yes (cached) warn: Unable to construct ./standalone <========= PROBLEM ?? ...patience... ...patience... ...found 4373 targets... ... But eventually the doc (or at least some doc) is generated. Thanks again Alain Thanks,
HTH, John.
_______________________________________________ Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
-- --- Alain
And, in addition to the "missing doxygen ;" issue, please note that the
warn: Unable to construct ./standalone goes away if I add a "using boostbook ;" statement. Also, more stuff get générated.
Regards Alain On 21/04/2015 14:51, Alain Miniussi wrote:
Thanks,
A few more questions:
On 20/04/2015 19:50, John Maddock wrote:
Just curious, has anyone been able to get the documentation generated (on a linux platform) by following the instructions in http://www.boost.org/doc/libs/1_58_0/doc/html/boostbook/getting/started.html
Yes, but the setup process isn't straightforward: it is documented here though: https://svn.boost.org/trac/boost/wiki/BoostDocs/GettingStarted
There is also a test project under /doc/test/ that you can use to verify you have everything setup correctly before proceeding further.
As such, the test fails with:
[alainm@tagir test]$ ../../b2 -d2 Jamfile.v2:71: in modules.load ERROR: rule "doxygen" unknown in module "Jamfile". ...
Things go better if I replace "import doxygen ;" with "using doxygen ;" in the test's Jamfile. Is it a typo in the Jamfile or am I missing something ?
After that "fix/modification", I get: [alainm@tagir test]$ ../../b2 Performing configuration checks
- 32-bit : no (cached) - 64-bit : yes (cached) - arm : no (cached) - mips1 : no (cached) - power : no (cached) - sparc : no (cached) - x86 : yes (cached) - symlinks supported : yes (cached) warn: Unable to construct ./standalone <========= PROBLEM ?? ...patience... ...patience... ...found 4373 targets... ...
But eventually the doc (or at least some doc) is generated.
Thanks again
Alain
Thanks,
HTH, John.
_______________________________________________ Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
-- --- Alain
On 21/04/2015 15:42, Alain Miniussi wrote:
And, in addition to the "missing doxygen ;" issue, please note that the
warn: Unable to construct ./standalone goes away if I add a "using boostbook ;" statement. Also, more stuff get generated.
And while looking through the "git diff" output, I noticed that a lot of stuff is git controlled in doc/html/ while it seems to be generated documentation. Is that intentional ?
Regards
Alain
On 21/04/2015 14:51, Alain Miniussi wrote:
Thanks,
A few more questions:
On 20/04/2015 19:50, John Maddock wrote:
Just curious, has anyone been able to get the documentation generated (on a linux platform) by following the instructions in http://www.boost.org/doc/libs/1_58_0/doc/html/boostbook/getting/started.html
Yes, but the setup process isn't straightforward: it is documented here though: https://svn.boost.org/trac/boost/wiki/BoostDocs/GettingStarted
There is also a test project under /doc/test/ that you can use to verify you have everything setup correctly before proceeding further.
As such, the test fails with:
[alainm@tagir test]$ ../../b2 -d2 Jamfile.v2:71: in modules.load ERROR: rule "doxygen" unknown in module "Jamfile". ...
Things go better if I replace "import doxygen ;" with "using doxygen ;" in the test's Jamfile. Is it a typo in the Jamfile or am I missing something ?
After that "fix/modification", I get: [alainm@tagir test]$ ../../b2 Performing configuration checks
- 32-bit : no (cached) - 64-bit : yes (cached) - arm : no (cached) - mips1 : no (cached) - power : no (cached) - sparc : no (cached) - x86 : yes (cached) - symlinks supported : yes (cached) warn: Unable to construct ./standalone <========= PROBLEM ?? ...patience... ...patience... ...found 4373 targets... ...
But eventually the doc (or at least some doc) is generated.
Thanks again
Alain
Thanks,
HTH, John.
_______________________________________________ Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
-- --- Alain
participants (2)
-
Alain Miniussi -
John Maddock