From e4e54c3f7793b4ff05d17fe586406b79addd0bb2 Mon Sep 17 00:00:00 2001
From: Vladimir Prus <vladimir@codesourcery.com>
Date: Sun, 7 Dec 2014 21:18:06 +0300
Subject: [PATCH] Convert 'how to use this document' into 'dedication' element.

This makes the content appear in the top 'index.html' element,
and disappear form TOC. I could not find another way - disabling
chunking for the first section would almost work, but would retain
it in TOC.
---
 doc/src/howto.xml      | 36 +++++++++++++++++++++++-------------
 doc/src/standalone.xml | 18 ------------------
 doc/src/tutorial.xml   |  4 ++--
 doc/src/userman.xml    | 18 ------------------
 4 files changed, 25 insertions(+), 51 deletions(-)

diff --git a/doc/src/howto.xml b/doc/src/howto.xml
index de17a286a..8ba571ab0 100644
--- a/doc/src/howto.xml
+++ b/doc/src/howto.xml
@@ -2,33 +2,43 @@
 <!DOCTYPE chapter PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN"
   "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
 
-  <chapter id="bbv2.howto">
+  <dedication id="bbv2.howto">
+
     <title>How to use this document</title>
 
     <para>
-      If you've just found out about Boost.Build V2 and want to know
-      if it will work for you, start with <xref linkend=
-      "bbv2.tutorial" />. You can continue with <xref
-      linkend="bbv2.overview" />. When you're ready to try Boost.Build
+      Want to learn about Boost.Build features? Start with <xref linkend=
+      "bbv2.tutorial"/> and continue with <xref
+      linkend="bbv2.overview"/>. When you're ready to try Boost.Build
       in practice, go to <xref linkend="bbv2.installation"/>.
     </para>
 
     <para>
-      If you are about to use Boost.Build on your project, or already
-      using it and have a problem, look at <xref linkend=
-      "bbv2.overview"/>.
+      Building a project with Boost.Build? See <xref
+      linkend="bbv2.installation"/> and 
+      then read <xref linkend="bbv2.overview.invocation"/>.
     </para>
 
     <para>
-      If you're trying to build a project which uses Boost.Build,
-      see <xref linkend="bbv2.installation"/> and then read about
-      <xref linkend="bbv2.overview.invocation"/>.
+      Setting up Boost.Build on your project? Take a look at <xref
+      linkend="bbv2.overview"/> and <xref linkend="bbv2.extender"/>.
     </para>
 
     <para>
-      If you have questions, please post them to our mailing list (<ulink
+      If there's anything you find unclear in this documentation, report the
+      problem directly in the <ulink
+      url="https://github.com/boostorg/build/issues">issue tracker</ulink>.
+      For more general questions, please post them to our mailing list (<ulink
       url="http://boost.org/more/mailing_lists.htm#jamboost"/>). The mailing list is
       also mirrored to the newsgroup <ulink url="news://news.gmane.org/gmane.comp.lib.boost.build"/>.
     </para>
 
-  </chapter>
+    <para role="copyright">
+      Copyright 2006, 2014 <ulink url="http://vladimirprus.com">Vladimir
+      Prus</ulink>. Distributed under the Boost Software License, Version 1.0.
+      (See accompanying file <filename>LICENSE_1_0.txt</filename> or copy at 
+      <ulink
+      url="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</ulink>)
+    </para>
+
+  </dedication>
diff --git a/doc/src/standalone.xml b/doc/src/standalone.xml
index 34c7190ab..d6f856177 100644
--- a/doc/src/standalone.xml
+++ b/doc/src/standalone.xml
@@ -4,24 +4,6 @@
 
 <book xmlns:xi="http://www.w3.org/2001/XInclude"
       id="bbv2" last-revision="$Date$">
-  <bookinfo>
-    <copyright>
-      <year>2006</year>
-      <year>2007</year>
-      <year>2008</year>
-      <year>2009</year>
-      <year>2014</year>
-      <holder>Vladimir Prus</holder>
-    </copyright>
-
-    <legalnotice>
-      <para>Distributed under the Boost Software License, Version 1.0.
-      (See accompanying file <filename>LICENSE_1_0.txt</filename> or copy at 
-      <ulink
-      url="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</ulink>)
-      </para>
-    </legalnotice>  
-  </bookinfo>
 
   <title>Boost.Build User Manual</title>
 
diff --git a/doc/src/tutorial.xml b/doc/src/tutorial.xml
index 29a014393..e3cb41879 100644
--- a/doc/src/tutorial.xml
+++ b/doc/src/tutorial.xml
@@ -17,8 +17,8 @@
 -->
 
   <para>
-    This section will guide you though the most basic features of Boost.Build
-    V2. We will start with the &#x201C;Hello, world&#x201D; example, learn how
+    This section will guide you though the most basic features of Boost.Build.
+    We will start with the &#x201C;Hello, world&#x201D; example, learn how
     to use libraries, and finish with testing and installing features.
   </para>
 
diff --git a/doc/src/userman.xml b/doc/src/userman.xml
index 192153ede..396d85148 100644
--- a/doc/src/userman.xml
+++ b/doc/src/userman.xml
@@ -4,24 +4,6 @@
 
 <part xmlns:xi="http://www.w3.org/2001/XInclude"
       id="bbv2" last-revision="$Date$">
-  <partinfo>
-    <copyright>
-      <year>2006</year>
-      <year>2007</year>
-      <year>2008</year>
-      <year>2009</year>
-      <year>2014</year>
-      <holder>Vladimir Prus</holder>
-    </copyright>
-
-    <legalnotice>
-      <para>Distributed under the Boost Software License, Version 1.0.
-      (See accompanying file <filename>LICENSE_1_0.txt</filename> or copy at 
-      <ulink
-      url="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</ulink>)
-      </para>
-    </legalnotice>  
-  </partinfo>
 
   <title>Boost.Build User Manual</title>