Boost C++ Libraries: Ticket #7789: Integrate building of html docs into boost's doc build https://svn.boost.org/trac10/ticket/7789 <p> Boost.Range uses Quickbook for its documentation. The generated HTML files are currently checked into the repository. </p> <p> According to Eric Niebler (<a class="ext-link" href="http://permalink.gmane.org/gmane.comp.lib.boost.devel/236447"><span class="icon">​</span>http://permalink.gmane.org/gmane.comp.lib.boost.devel/236447</a>): </p> <p> "[I]t's generally discouraged to check in generated files. This goes for html that's generated from quickbook. The preferred thing for docs is to integrate your library's doc build with the overall boost doc build by editing $BOOST/doc/Jamfile.v2." </p> <p> We should do this for the Boost.Range docs. </p> en-us Boost C++ Libraries /htdocs/site/boost.png https://svn.boost.org/trac10/ticket/7789 Trac 1.4.3 Michel Morin Wed, 19 Dec 2012 21:38:56 GMT <link>https://svn.boost.org/trac10/ticket/7789#comment:1 </link> <guid isPermaLink="false">https://svn.boost.org/trac10/ticket/7789#comment:1</guid> <description> <p> ATM, let's delete <code>libs/range/doc/html/quickbook_HTML.manifest</code>. This file is completely unnecessary for the end users. </p> </description> <category>Ticket</category> </item> <item> <dc:creator>Nathan Ridge</dc:creator> <pubDate>Fri, 21 Dec 2012 08:20:48 GMT</pubDate> <title/> <link>https://svn.boost.org/trac10/ticket/7789#comment:2 </link> <guid isPermaLink="false">https://svn.boost.org/trac10/ticket/7789#comment:2</guid> <description> <p> Replying to <a class="ticket" href="https://svn.boost.org/trac10/ticket/7789#comment:1" title="Comment 1">michel</a>: </p> <blockquote class="citation"> <p> ATM, let's delete <code>libs/range/doc/html/quickbook_HTML.manifest</code>. This file is completely unnecessary for the end users. </p> </blockquote> <p> Unnecessary, yes, but does it hurt to leave it there? I find this file useful because the diff to it tells me which HTML files to "svn add" or "svn remove" after re-generating docs. </p> </description> <category>Ticket</category> </item> <item> <dc:creator>Michel Morin</dc:creator> <pubDate>Fri, 21 Dec 2012 08:36:19 GMT</pubDate> <title/> <link>https://svn.boost.org/trac10/ticket/7789#comment:3 </link> <guid isPermaLink="false">https://svn.boost.org/trac10/ticket/7789#comment:3</guid> <description> <blockquote class="citation"> <p> Unnecessary, yes, but does it hurt to leave it there? </p> </blockquote> <p> No, it doesn't hurt any thing; if that file is useful, it is not necessary to svn-delete it. </p> <p> I pointed this out just because Boost.Range is the only library that commits <code>quickbook_HTML.manifest</code>. </p> </description> <category>Ticket</category> </item> <item> <dc:creator>Nathan Ridge</dc:creator> <pubDate>Fri, 21 Dec 2012 08:40:57 GMT</pubDate> <title/> <link>https://svn.boost.org/trac10/ticket/7789#comment:4 </link> <guid isPermaLink="false">https://svn.boost.org/trac10/ticket/7789#comment:4</guid> <description> <p> Replying to <a class="ticket" href="https://svn.boost.org/trac10/ticket/7789#comment:3" title="Comment 3">michel</a>: </p> <blockquote class="citation"> <blockquote class="citation"> <p> Unnecessary, yes, but does it hurt to leave it there? </p> </blockquote> <p> No, it doesn't hurt any thing; if that file is useful, it is not necessary to svn-delete it. </p> <p> I pointed this out just because Boost.Range is the only library that commits <code>quickbook_HTML.manifest</code>. </p> </blockquote> <p> OK. I will leave it in for now, then when the doc build is integrated into the boost doc build, it will be gone along with whole html folder. </p> </description> <category>Ticket</category> </item> <item> <dc:creator>Neil Groves</dc:creator> <pubDate>Sat, 08 Mar 2014 20:58:39 GMT</pubDate> <title>status changed; resolution set https://svn.boost.org/trac10/ticket/7789#comment:5 https://svn.boost.org/trac10/ticket/7789#comment:5 <ul> <li><strong>status</strong> <span class="trac-field-old">new</span> → <span class="trac-field-new">closed</span> </li> <li><strong>resolution</strong> → <span class="trac-field-new">fixed</span> </li> </ul> <p> The work was actually done by Daniel, but this is completed :-) </p> Ticket