Re: [boost] [iterator] [documentation] need help generating

Subject: Re: [boost] [iterator] [documentation] need help generating
From: Steven Watanabe (watanabesj_at_[hidden])
Date: 2012-10-13 18:34:23

AMDG

On 10/13/2012 03:07 PM, Jeffrey Lee Hellrung, Jr. wrote:
> I'm a n00b regarding Boost's documentation generation. I've gone through
> 
> https://svn.boost.org/trac/boost/wiki/BoostDocs/GettingStarted
> 
> to set up my system (Windows 7, MSVC9, try to do everything from the
> Windows command line). I then navigate to
> 
> trunk\libs\iterator\doc
> 
> and run b2 (the b2 I have from the 1.51.0 release; would that matter?).

It does matter, but not that much.  (trunk b2 fixes the
"can't make" problem).  I didn't notice this originally,
so I still need to update the version number in the trunk
to account for it.

> I get
> 
> --------
> don't know how to make
> <p..\..\..\bin.v2\libs\iterator\doc\msvc-9.0\debug\threading-multi-object(xinclude-scanner)@987>iterator.xml
> <snip>
> --------
> 
> Then I run it again:
> 
> --------
> <snip>
> --------
> 
> This seems to throw everything into trunk\libs\iterator\doc\html. However,
> these generated html documents don't seem to be the same as those in the
> Boost releases. For example, the table of contents is deeper in the
> generated index.html than the 1.51.0 release one (which looks be identical
> to trunk/libs/iterator/doc/index.html), and it lacks documentation for
> function_input_iterator. It seems like I'm doing something wrong, and I'm
> not really sure what to make of the various errors and warnings I'm getting.
> 
> Would anyone be kind of enough to help me out here?
> 

It looks like the the quickbook port of the
iterator docs is incomplete.  The docs in
the release are built from the rst sources.

> Oh, my user-config.jam file, located in "C:/Users/Jeffrey/", looks like
> 
> --------
> using xsltproc
>     : C:/Users/Jeffrey/boost-tools/libxslt-1.1.26.win32/bin/xsltproc.exe
>     ;
> 
> using boostbook
>     : C:/Users/Jeffrey/boost-tools/xml/docbook-xsl-1.77.1
>     : C:/Users/Jeffrey/boost-tools/xml/docbook-xml-4.2
>     ;
> 
> using quickbook
>     : %BOOST_ROOT%/dist/bin/quickbook
>     ;
> --------
> 
> BOOST_ROOT refers to my Boost 1.51.0 installation, and
> C:/Users/Jeffrey/boost-tools/bin is part of my path. Let me know if other
> information is needed.
> 

In Christ,
Steven Watanabe