Update of
/cvsroot/boost/boost/tools/quickbook/doc/html/quickbook/installation_and_configuration
In directory
sc8-pr-cvs3.sourceforge.net:/tmp/cvs-serv8457/html/quickbook/installation_and_configuration
Modified Files:
windows_2000__xp__2003__vista.html
Added Files:
debian__ubuntu.html
Log Message:
Add the debian installation instructions to the generated quickbook
documentation.
--- NEW FILE: debian__ubuntu.html ---
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Debian, Ubuntu</title>
<link rel="stylesheet" href="../../boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
<link rel="start" href="../../index.html" title="Quickbook 1.4">
<link rel="up" href="../installation_and_configuration.html"
title="Installation and configuration">
<link rel="prev" href="windows_2000__xp__2003__vista.html" title="Windows 2000,
XP, 2003, Vista">
<link rel="next" href="../ref.html" title=" Quick Reference">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"
alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86"
src="../../../../../../boost.png"></td>
<td align="center"><a href="../../../../../../index.htm">Home</a></td>
<td align="center"><a
href="../../../../../../libs/libraries.htm">Libraries</a></td>
<td align="center"><a href="../../../../../../people/people.htm">People</a></td>
<td align="center"><a href="../../../../../../more/faq.htm">FAQ</a></td>
<td align="center"><a href="../../../../../../more/index.htm">More</a></td>
</tr></table>
<hr>
<div class="spirit-nav">
<a accesskey="p" href="windows_2000__xp__2003__vista.html"><img
src="../../images/prev.png" alt="Prev"></a><a accesskey="u"
href="../installation_and_configuration.html"><img src="../../images/up.png"
alt="Up"></a><a accesskey="h" href="../../index.html"><img
src="../../images/home.png" alt="Home"></a><a accesskey="n"
href="../ref.html"><img src="../../images/next.png" alt="Next"></a>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
<a name="quickbook.installation_and_configuration.debian__ubuntu"></a>Debian,
Ubuntu</h3></div></div></div>
<p>
The following instructions apply to Debian and its derivatives. It is
based
on a Ubuntu Edgy install, but it should work on other Debian based
systems.
</p>
<div class="orderedlist"><ol type="1"><li>
First install the <code class="computeroutput"><span
class="identifier">bjam</span></code>,
<code class="computeroutput"><span
class="identifier">xsltproc</span></code>, <code class="computeroutput"><span
class="identifier">docbook</span><span class="special">-</span><span
class="identifier">xsl</span></code> and <code class="computeroutput"><span
class="identifier">docbook</span><span class="special">-</span><span
class="identifier">xml</span></code>
packages. If you're planning on building boost's documentation, you'll
also want to install the <code class="computeroutput"><span
class="identifier">doxygen</span></code>
package as well. For example, using <code
class="computeroutput"><span class="identifier">apt</span><span
class="special">-</span><span class="identifier">get</span></code>:
</li></ol></div>
<pre class="programlisting">
<span class="identifier">sudo</span> <span class="identifier">apt</span><span
class="special">-</span><span class="identifier">get</span> <span
class="identifier">install</span> <span class="identifier">xsltprc</span> <span
class="identifier">docbook</span><span class="special">-</span><span
class="identifier">xsl</span> <span class="identifier">docbook</span><span
class="special">-</span><span class="identifier">xml</span> <span
class="identifier">doxygen</span>
</pre>
<div class="orderedlist"><ol type="1"><li>
Add the following to your <code class="computeroutput"><span
class="identifier">user</span><span class="special">-</span><span
class="identifier">config</span><span class="special">.</span><span
class="identifier">jam</span></code>
file, which should be in your home directory. If you don't have one
create
a text file containing just this text.
</li></ol></div>
<pre class="programlisting">
<span class="identifier">using</span> <span class="identifier">xsltproc</span>
<span class="special">;</span>
<span class="identifier">using</span> <span class="identifier">boostbook</span>
<span class="special">:</span> <span class="special">/</span><span
class="identifier">usr</span><span class="special">/</span><span
class="identifier">share</span><span class="special">/</span><span
class="identifier">xml</span><span class="special">/</span><span
class="identifier">docbook</span><span class="special">/</span><span
class="identifier">stylesheet</span><span class="special">/</span><span
class="identifier">nwalsh</span>
<span class="special">:</span> <span class="special">/</span><span
class="identifier">usr</span><span class="special">/</span><span
class="identifier">share</span><span class="special">/</span><span
class="identifier">xml</span><span class="special">/</span><span
class="identifier">docbook</span><span class="special">/</span><span
class="identifier">schema</span><span class="special">/</span><span
class="identifier">dtd</span><span class="special">/</span><span
class="number">4.2</span>
<span class="special">;</span>
<span class="comment"># Remove this line if you're not using doxygen
</span><span class="identifier">using</span> <span
class="identifier">doxygen</span> <span class="special">;</span>
</pre>
<div class="orderedlist"><ol type="1">
<li>
Go to Quickbook's source directory (<code
class="computeroutput"><span class="identifier">BOOST_ROOT</span><span
class="special">/</span><span class="identifier">tools</span><span
class="special">/</span><span class="identifier">quickbook</span></code>).
</li>
<li>
Build the utility by issuing <code class="computeroutput"><span
class="identifier">bjam</span> <span class="special">--</span><span
class="identifier">v2</span></code>.
</li>
<li>
Copy the resulting <code class="computeroutput"><span
class="identifier">quickbook</span></code>
binary (located at <code class="computeroutput"><span
class="identifier">BOOST_ROOT</span><span class="special">/</span><span
class="identifier">dist</span><span class="special">/</span><span
class="identifier">bin</span><span class="special">/</span><span
class="identifier">quickbook</span></code>
hierarchy) to a safe place. The traditional location would be <code
class="computeroutput"><span class="special">/</span><span
class="identifier">usr</span><span class="special">/</span><span
class="identifier">local</span><span class="special">/</span><span
class="identifier">bin</span></code>,
but anywhere sensible will do.
</li>
<li>
Add the following to your <code class="computeroutput"><span
class="identifier">user</span><span class="special">-</span><span
class="identifier">config</span><span class="special">.</span><span
class="identifier">jam</span></code>
file (using the path where you placed the quickbook executable):
</li>
</ol></div>
<pre class="programlisting">
<span class="identifier">using</span> <span class="identifier">quickbook</span>
<span class="special">:</span> <span class="special">/</span><span
class="identifier">usr</span><span class="special">/</span><span
class="identifier">local</span><span class="special">/</span><span
class="identifier">bin</span><span class="special">/</span><span
class="identifier">quickbook</span>
<span class="special">;</span>
</pre>
</div>
<table width="100%"><tr>
<td align="left"></td>
<td align="right"><small>Copyright © 2002, 2004, 2006 Joel de Guzman,
Eric Niebler</small></td>
</tr></table>
<hr>
<div class="spirit-nav">
<a accesskey="p" href="windows_2000__xp__2003__vista.html"><img
src="../../images/prev.png" alt="Prev"></a><a accesskey="u"
href="../installation_and_configuration.html"><img src="../../images/up.png"
alt="Up"></a><a accesskey="h" href="../../index.html"><img
src="../../images/home.png" alt="Home"></a><a accesskey="n"
href="../ref.html"><img src="../../images/next.png" alt="Next"></a>
</div>
</body>
</html>
Index: windows_2000__xp__2003__vista.html
===================================================================
RCS file:
/cvsroot/boost/boost/tools/quickbook/doc/html/quickbook/installation_and_configuration/windows_2000__xp__2003__vista.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5
--- windows_2000__xp__2003__vista.html 2 Oct 2006 21:18:44 -0000 1.4
+++ windows_2000__xp__2003__vista.html 7 Oct 2006 09:15:44 -0000 1.5
@@ -1,39 +1,35 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Windows
- 2000, XP, 2003, Vista</title>
+<title>Windows 2000, XP, 2003, Vista</title>
<link rel="stylesheet" href="../../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.66.1">
+<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
<link rel="start" href="../../index.html" title="Quickbook 1.4">
-<link rel="up" href="../installation_and_configuration.html"
title="Installation
- and configuration">
-<link rel="prev" href="../installation_and_configuration.html"
title="Installation
- and configuration">
-<link rel="next" href="debian__ubuntu.html" title="Debian,
- Ubuntu">
+<link rel="up" href="../installation_and_configuration.html"
title="Installation and configuration">
+<link rel="prev" href="../installation_and_configuration.html"
title="Installation and configuration">
+<link rel="next" href="debian__ubuntu.html" title="Debian, Ubuntu">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"
alink="#0000FF">
-<table cellpadding="2" width="100%">
+<table cellpadding="2" width="100%"><tr>
<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86"
src="../../../../../../boost.png"></td>
<td align="center"><a href="../../../../../../index.htm">Home</a></td>
<td align="center"><a
href="../../../../../../libs/libraries.htm">Libraries</a></td>
<td align="center"><a
href="../../../../../../people/people.htm">People</a></td>
<td align="center"><a href="../../../../../../more/faq.htm">FAQ</a></td>
<td align="center"><a href="../../../../../../more/index.htm">More</a></td>
-</table>
+</tr></table>
<hr>
<div class="spirit-nav">
<a accesskey="p" href="../installation_and_configuration.html"><img
src="../../images/prev.png" alt="Prev"></a><a accesskey="u"
href="../installation_and_configuration.html"><img src="../../images/up.png"
alt="Up"></a><a accesskey="h" href="../../index.html"><img
src="../../images/home.png" alt="Home"></a><a accesskey="n"
href="debian__ubuntu.html"><img src="../../images/next.png" alt="Next"></a>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a
name="quickbook.installation_and_configuration.windows_2000__xp__2003__vista"></a><a
href="windows_2000__xp__2003__vista.html" title="Windows
- 2000, XP, 2003, Vista">Windows
- 2000, XP, 2003, Vista</a></h3></div></div></div>
-<p class="blurb">
- Section contributed by Julio M. Merino Vidal
- </p>
+<a
name="quickbook.installation_and_configuration.windows_2000__xp__2003__vista"></a>Windows
2000, XP, 2003, Vista</h3></div></div></div>
+<div class="informaltable"><table class="table">
+<colgroup><col></colgroup>
+<tbody><tr><td class="blurb"> Section contributed by Julio M. Merino
Vidal</td></tr></tbody>
+</table></div>
<p>
The following instructions apply to any Windows system based on
Windows 2000,
including Windows XP, Windows 2003 Server and Windows Vista. The paths
shown
@@ -42,39 +38,39 @@
</p>
<div class="orderedlist"><ol type="1">
<li>
- First of all you need to have a copy of <tt
class="computeroutput"><span class="identifier">xsltproc</span></tt>
+ First of all you need to have a copy of <code
class="computeroutput"><span class="identifier">xsltproc</span></code>
for Windows. There are many ways to get this tool, but to keep
things simple,
use the <a href="http://www.zlatkovic.com/pub/libxml/";
target="_top">binary packages</a>
made by Igor Zlatkovic. At the very least, you need to download the
following
- packages: <tt class="computeroutput"><span
class="identifier">iconv</span></tt>, <tt class="computeroutput"><span
class="identifier">zlib</span></tt>, <tt class="computeroutput"><span
class="identifier">libxml2</span></tt>
- and <tt class="computeroutput"><span
class="identifier">libxslt</span></tt>.
+ packages: <code class="computeroutput"><span
class="identifier">iconv</span></code>, <code class="computeroutput"><span
class="identifier">zlib</span></code>, <code class="computeroutput"><span
class="identifier">libxml2</span></code>
+ and <code class="computeroutput"><span
class="identifier">libxslt</span></code>.
</li>
<li>
Unpack all these packages in the same directory so that you get
unique
- <tt class="computeroutput"><span class="identifier">bin</span></tt>,
<tt class="computeroutput"><span class="identifier">include</span></tt>
- and <tt class="computeroutput"><span
class="identifier">lib</span></tt> directories within
- the hierarchy. These instructions use <tt
class="computeroutput"><span class="identifier">C</span><span
class="special">:\</span><span class="identifier">Users</span><span
class="special">\</span><span class="identifier">example</span><span
class="special">\</span><span class="identifier">Documents</span><span
class="special">\</span><span class="identifier">boost</span><span
class="special">\</span><span class="identifier">xml</span></tt>
+ <code class="computeroutput"><span
class="identifier">bin</span></code>, <code class="computeroutput"><span
class="identifier">include</span></code>
+ and <code class="computeroutput"><span
class="identifier">lib</span></code> directories within
+ the hierarchy. These instructions use <code
class="computeroutput"><span class="identifier">C</span><span
class="special">:\</span><span class="identifier">Users</span><span
class="special">\</span><span class="identifier">example</span><span
class="special">\</span><span class="identifier">Documents</span><span
class="special">\</span><span class="identifier">boost</span><span
class="special">\</span><span class="identifier">xml</span></code>
as the root for all files.
</li>
<li>
- From the command line, go to the <tt class="computeroutput"><span
class="identifier">bin</span></tt>
- directory and launch <tt class="computeroutput"><span
class="identifier">xsltproc</span><span class="special">.</span><span
class="identifier">exe</span></tt>
+ From the command line, go to the <code class="computeroutput"><span
class="identifier">bin</span></code>
+ directory and launch <code class="computeroutput"><span
class="identifier">xsltproc</span><span class="special">.</span><span
class="identifier">exe</span></code>
to ensure it works. You should get usage information on screen.
</li>
<li>
Download <a
href="http://www.docbook.org/xml/4.2/docbook-xml-4.2.zip"; target="_top">Docbook
XML 4.2</a> and unpack it in the same directory used above. That is:
- <tt class="computeroutput"><span class="identifier">C</span><span
class="special">:\</span><span class="identifier">Users</span><span
class="special">\</span><span class="identifier">example</span><span
class="special">\</span><span class="identifier">Documents</span><span
class="special">\</span><span class="identifier">boost</span><span
class="special">\</span><span class="identifier">xml</span><span
class="special">\</span><span class="identifier">docbook</span><span
class="special">-</span><span class="identifier">xml</span></tt>.
+ <code class="computeroutput"><span class="identifier">C</span><span
class="special">:\</span><span class="identifier">Users</span><span
class="special">\</span><span class="identifier">example</span><span
class="special">\</span><span class="identifier">Documents</span><span
class="special">\</span><span class="identifier">boost</span><span
class="special">\</span><span class="identifier">xml</span><span
class="special">\</span><span class="identifier">docbook</span><span
class="special">-</span><span class="identifier">xml</span></code>.
</li>
<li>
Download the latest <a
href="http://sourceforge.net/project/showfiles.php?group_id=21935&package_id=16608";
target="_top">Docbook
XSL</a> version and unpack it, again in the same directory used
before.
To make things easier, rename the directory created during the
extraction
- to <tt class="computeroutput"><span
class="identifier">docbook</span><span class="special">-</span><span
class="identifier">xsl</span></tt> (bypassing the version name): <tt
class="computeroutput"><span class="identifier">C</span><span
class="special">:\</span><span class="identifier">Users</span><span
class="special">\</span><span class="identifier">example</span><span
class="special">\</span><span class="identifier">Documents</span><span
class="special">\</span><span class="identifier">boost</span><span
class="special">\</span><span class="identifier">xml</span><span
class="special">\</span><span class="identifier">docbook</span><span
class="special">-</span><span class="identifier">xsl</span></tt>.
+ to <code class="computeroutput"><span
class="identifier">docbook</span><span class="special">-</span><span
class="identifier">xsl</span></code> (bypassing the version name): <code
class="computeroutput"><span class="identifier">C</span><span
class="special">:\</span><span class="identifier">Users</span><span
class="special">\</span><span class="identifier">example</span><span
class="special">\</span><span class="identifier">Documents</span><span
class="special">\</span><span class="identifier">boost</span><span
class="special">\</span><span class="identifier">xml</span><span
class="special">\</span><span class="identifier">docbook</span><span
class="special">-</span><span class="identifier">xsl</span></code>.
</li>
<li>
- Add the following to your <tt class="computeroutput"><span
class="identifier">user</span><span class="special">-</span><span
class="identifier">config</span><span class="special">.</span><span
class="identifier">jam</span></tt>
- file, which should live in your home directory (<tt
class="computeroutput"><span class="special">%</span><span
class="identifier">HOMEDRIVE</span><span class="special">%%</span><span
class="identifier">HOMEPATH</span><span class="special">%</span></tt>).
+ Add the following to your <code class="computeroutput"><span
class="identifier">user</span><span class="special">-</span><span
class="identifier">config</span><span class="special">.</span><span
class="identifier">jam</span></code>
+ file, which should live in your home directory (<code
class="computeroutput"><span class="special">%</span><span
class="identifier">HOMEDRIVE</span><span class="special">%%</span><span
class="identifier">HOMEPATH</span><span class="special">%</span></code>).
You must already have it somewhere or otherwise you could not be
building
Boost (i.e. missing tools configuration).
</li>
@@ -95,19 +91,19 @@
</p>
<div class="orderedlist"><ol type="1">
<li>
- Go to Quickbook's source directory (<tt class="computeroutput"><span
class="identifier">BOOST_ROOT</span><span class="special">\</span><span
class="identifier">tools</span><span class="special">\</span><span
class="identifier">quickbook</span></tt>).
+ Go to Quickbook's source directory (<code
class="computeroutput"><span class="identifier">BOOST_ROOT</span><span
class="special">\</span><span class="identifier">tools</span><span
class="special">\</span><span class="identifier">quickbook</span></code>).
</li>
<li>
- Build the utility by issuing <tt class="computeroutput"><span
class="identifier">bjam</span> <span class="special">--</span><span
class="identifier">v2</span></tt>.
+ Build the utility by issuing <code class="computeroutput"><span
class="identifier">bjam</span> <span class="special">--</span><span
class="identifier">v2</span></code>.
</li>
<li>
- Copy the resulting <tt class="computeroutput"><span
class="identifier">quickbook</span><span class="special">.</span><span
class="identifier">exe</span></tt>
- binary (located under the <tt class="computeroutput"><span
class="identifier">BOOST_ROOT</span><span class="special">\</span><span
class="identifier">bin</span><span class="special">.</span><span
class="identifier">v2</span></tt> hierarchy)
+ Copy the resulting <code class="computeroutput"><span
class="identifier">quickbook</span><span class="special">.</span><span
class="identifier">exe</span></code>
+ binary (located under the <code class="computeroutput"><span
class="identifier">BOOST_ROOT</span><span class="special">\</span><span
class="identifier">bin</span><span class="special">.</span><span
class="identifier">v2</span></code> hierarchy)
to a safe place. Following our previous example, you can install it
into:
- <tt class="computeroutput"><span class="identifier">C</span><span
class="special">:\</span><span class="identifier">Users</span><span
class="special">\</span><span class="identifier">example</span><span
class="special">\</span><span class="identifier">Documents</span><span
class="special">\</span><span class="identifier">boost</span><span
class="special">\</span><span class="identifier">xml</span><span
class="special">\</span><span class="identifier">bin</span></tt>.
+ <code class="computeroutput"><span class="identifier">C</span><span
class="special">:\</span><span class="identifier">Users</span><span
class="special">\</span><span class="identifier">example</span><span
class="special">\</span><span class="identifier">Documents</span><span
class="special">\</span><span class="identifier">boost</span><span
class="special">\</span><span class="identifier">xml</span><span
class="special">\</span><span class="identifier">bin</span></code>.
</li>
<li>
- Add the following to your <tt class="computeroutput"><span
class="identifier">user</span><span class="special">-</span><span
class="identifier">config</span><span class="special">.</span><span
class="identifier">jam</span></tt>
+ Add the following to your <code class="computeroutput"><span
class="identifier">user</span><span class="special">-</span><span
class="identifier">config</span><span class="special">.</span><span
class="identifier">jam</span></code>
file:
</li>
</ol></div>
@@ -117,7 +113,7 @@
<span class="special">;</span>
</pre>
</div>
-<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";
width="100%"><tr>
+<table width="100%"><tr>
<td align="left"></td>
<td align="right"><small>Copyright © 2002, 2004, 2006 Joel de Guzman,
Eric Niebler</small></td>
-------------------------------------------------------------------------
Take Surveys. Earn Cash. Influence the Future of IT
Join SourceForge.net's Techsay panel and you'll get the chance to share your
opinions on IT & business topics through brief surveys -- and earn cash
http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV
_______________________________________________
Boost-cvs mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/boost-cvs
