|
|
Boost-Commit : |
Subject: [Boost-commit] svn:boost r83954 - in branches/release/tools/bcp: . doc doc/html
From: john_at_[hidden]
Date: 2013-04-18 08:33:24
Author: johnmaddock
Date: 2013-04-18 08:33:24 EDT (Thu, 18 Apr 2013)
New Revision: 83954
URL: http://svn.boost.org/trac/boost/changeset/83954
Log:
Merge doc formatting fix.
Fixes #8377.
Properties modified:
branches/release/tools/bcp/ (props changed)
Text files modified:
branches/release/tools/bcp/doc/bcp.qbk | 1
branches/release/tools/bcp/doc/html/index.html | 61 ++++++++++++++++++++++-----------------
2 files changed, 36 insertions(+), 26 deletions(-)
Modified: branches/release/tools/bcp/doc/bcp.qbk
==============================================================================
--- branches/release/tools/bcp/doc/bcp.qbk (original)
+++ branches/release/tools/bcp/doc/bcp.qbk 2013-04-18 08:33:24 EDT (Thu, 18 Apr 2013)
@@ -175,6 +175,7 @@
* HTML files are scanned for immediate dependencies (images and style sheets, but not links).
It should be noted that in practice bcp can produce a rather "fat" list of dependencies, reasons for this include:
+
* It searches for library names first, so using "regex" as a name will give you everything in the
libs/regex directory and everything that depends on. This can be a long list as all the regex test and example
programs will get scanned for their dependencies. If you want a more minimal list, then try using the
Modified: branches/release/tools/bcp/doc/html/index.html
==============================================================================
--- branches/release/tools/bcp/doc/html/index.html (original)
+++ branches/release/tools/bcp/doc/html/index.html 2013-04-18 08:33:24 EDT (Thu, 18 Apr 2013)
@@ -3,7 +3,7 @@
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>BCP</title>
<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
<link rel="home" href="index.html" title="BCP">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -50,7 +50,7 @@
</dl></dd>
</dl>
</div>
-<div class="section">
+<div class="section bcp_overview">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="bcp.overview"></a><a class="link" href="index.html#bcp.overview" title="Overview">Overview</a>
</h2></div></div></div>
@@ -64,7 +64,7 @@
what licences are used by those dependencies.
</p>
</div>
-<div class="section">
+<div class="section bcp_examples">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="bcp.examples"></a><a class="link" href="index.html#bcp.examples" title="Examples">Examples</a>
</h2></div></div></div>
@@ -111,7 +111,7 @@
The report contains license information, author details, and file dependencies.
</p>
</div>
-<div class="section">
+<div class="section bcp_syntax">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="bcp.syntax"></a><a class="link" href="index.html#bcp.syntax" title="Syntax">Syntax</a>
</h2></div></div></div>
@@ -122,7 +122,7 @@
<dt><span class="section">output-path</span></dt>
<dt><span class="section">Dependencies</span></dt>
</dl></div>
-<div class="section">
+<div class="section bcp_syntax_main">
<div class="titlepage"><div><div><h3 class="title">
<a name="bcp.syntax.main"></a><a class="link" href="index.html#bcp.syntax.main" title="Behaviour Selection">Behaviour Selection</a>
</h3></div></div></div>
@@ -141,7 +141,7 @@
<p>
Outputs a html report file containing:
</p>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
<li class="listitem">
All the licenses in effect, plus the files using each license, and the
copyright holders using each license.
@@ -163,7 +163,7 @@
</li>
</ul></div>
</div>
-<div class="section">
+<div class="section bcp_syntax_options">
<div class="titlepage"><div><div><h3 class="title">
<a name="bcp.syntax.options"></a><a class="link" href="index.html#bcp.syntax.options" title="Options">Options</a>
</h3></div></div></div>
@@ -211,7 +211,7 @@
Make sure that all copied files use Unix style line endings.
</p>
</div>
-<div class="section">
+<div class="section bcp_syntax_module">
<div class="titlepage"><div><div><h3 class="title">
<a name="bcp.syntax.module"></a><a class="link" href="index.html#bcp.syntax.module" title="module-list">module-list</a>
</h3></div></div></div>
@@ -243,7 +243,7 @@
copied/listed.
</p>
</div>
-<div class="section">
+<div class="section bcp_syntax_output">
<div class="titlepage"><div><div><h3 class="title">
<a name="bcp.syntax.output"></a><a class="link" href="index.html#bcp.syntax.output" title="output-path">output-path</a>
</h3></div></div></div>
@@ -251,14 +251,14 @@
The path to which files will be copied (this path must exist).
</p>
</div>
-<div class="section">
+<div class="section bcp_syntax_dependencies">
<div class="titlepage"><div><div><h3 class="title">
<a name="bcp.syntax.dependencies"></a><a class="link" href="index.html#bcp.syntax.dependencies" title="Dependencies">Dependencies</a>
</h3></div></div></div>
<p>
File dependencies are found as follows:
</p>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
<li class="listitem">
C++ source files are scanned for #includes, all #includes present in
the boost source tree will then be scanned for their dependencies and
@@ -280,27 +280,36 @@
</ul></div>
<p>
It should be noted that in practice bcp can produce a rather "fat"
- list of dependencies, reasons for this include: * It searches for library
- names first, so using "regex" as a name will give you everything
- in the libs/regex directory and everything that depends on. This can be a
- long list as all the regex test and example programs will get scanned for
- their dependencies. If you want a more minimal list, then try using the names
- of the headers you are actually including, or use the --scan option to scan
- your source code. * If you include the header of a library with separate
- source, then you get that libraries source and all it's dependencies. This
- is deliberate and in general those extra dependencies are needed. * When
- you include a header, bcp doesn't know what compiler you're using, so it
- follows all possible preprocessor paths. If you're distributing a subset
- of Boost with you're application then that is what you want to have happen
- in general.
+ list of dependencies, reasons for this include:
</p>
+<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
+<li class="listitem">
+ It searches for library names first, so using "regex" as a
+ name will give you everything in the libs/regex directory and everything
+ that depends on. This can be a long list as all the regex test and example
+ programs will get scanned for their dependencies. If you want a more
+ minimal list, then try using the names of the headers you are actually
+ including, or use the --scan option to scan your source code.
+ </li>
+<li class="listitem">
+ If you include the header of a library with separate source, then you
+ get that libraries source and all it's dependencies. This is deliberate
+ and in general those extra dependencies are needed.
+ </li>
+<li class="listitem">
+ When you include a header, bcp doesn't know what compiler you're using,
+ so it follows all possible preprocessor paths. If you're distributing
+ a subset of Boost with you're application then that is what you want
+ to have happen in general.
+ </li>
+</ul></div>
<p>
The last point above can result in a substantial increase in the number of
headers found compared to most peoples expectations. For example bcp finds
274 header dependencies for boost/shared_ptr.hpp: by running bcp in report
mode we can see why all these headers have been found as dependencies:
</p>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
<li class="listitem">
All of the Config library headers get included (52 headers, would be
about 6 for one compiler only).
@@ -338,7 +347,7 @@
</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
-<td align="left"><p><small>Last revised: November 22, 2012 at 08:56:37 GMT</small></p></td>
+<td align="left"><p><small>Last revised: April 18, 2013 at 12:30:13 GMT</small></p></td>
<td align="right"><div class="copyright-footer"></div></td>
</tr></table>
<hr>
Boost-Commit list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk