Update of /cvsroot/boost/boost/tools/quickbook/doc/html/quickbook/install
In directory sc8-pr-cvs3.sourceforge.net:/tmp/cvs-serv7467/quickbook/install
Added Files:
macosx.html
Log Message:
doc updates
--- NEW FILE: macosx.html ---
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title> Mac OS X</title>
<link rel="stylesheet" href="../../boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.66.1">
<link rel="start" href="../../index.html" title="Quickbook 1.4">
<link rel="up" href="../install.html" title=" Installation and configuration">
<link rel="prev" href="../install.html" title=" Installation and configuration">
<link rel="next" href="windows.html" title=" Windows 2000, XP, 2003, Vista">
</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="../install.html"><img
src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a
accesskey="u" href="../install.html"><img
src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h"
href="../../index.html"><img src="../../../../../../doc/html/images/home.png"
alt="Home"></a><a accesskey="n" href="windows.html"><img
src="../../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
<a name="quickbook.install.macosx"></a><a href="macosx.html" title=" Mac OS X">
Mac OS X</a></h3></div></div></div>
<div class="blockquote"><blockquote class="blockquote">
<p>
</p>
<p>
<span class="emphasis"><em>Section contributed by Julio M. Merino
Vidal</em></span>
</p>
<p>
</p>
</blockquote></div>
<p>
The following instructions explain how to install Docbook XML, Docbook
XSL
and Doxygen in a Mac OS X system, how to configure Boost.Build v2 to
recognize
them and how to build and install Quickbook. They were taken from a 10.4
(Tiger) machine so it is likely that they also apply to future versions;
they may not work with older ones, though.
</p>
<p>
The text below assumes you want to install all the necessary utilities
in
a system-wide location, allowing any user in the machine to have access
to
them. Therefore, all files will be put in the <tt
class="computeroutput"><span class="special">/</span><span
class="identifier">usr</span><span class="special">/</span><span
class="identifier">local</span></tt>
hierarchy. If you do not want this, you can choose any other prefix such
as <tt class="computeroutput"><span class="special">~/</span><span
class="identifier">Applications</span></tt>
for a single-user installation.
</p>
<p>
Mac OS X comes with <tt class="computeroutput"><span
class="identifier">xsltproc</span></tt>
and all related libraries preinstalled, so you do not need to take any
extra
steps to set them up. It is probable that future versions will include
them
too, but these instructions may not apply to older versions.
</p>
<p>
To get started:
</p>
<div class="orderedlist"><ol type="1">
<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 inside <tt 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">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="number">4.2</span></tt>.
</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. Put the results in <tt
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">share</span><span class="special">/</span><span
class="identifier">xsl</span><span class="special">/</span><span
class="identifier">docbook</span></tt>, thus effectively removing the
version number from the directory name (for simplicity).
</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">Users</span><span class="special">/<</span><span
class="identifier">your_username</span><span class="special">></span></tt>).
You must already have it somewhere or otherwise you could not be
building
Boost (i.e. missing tools configuration).
</li>
</ol></div>
<pre class="programlisting">
<span class="keyword">using</span> <span class="identifier">xsltproc</span>
<span class="special">;</span>
<span class="keyword">using</span> <span class="identifier">boostbook</span>
<span class="special">:</span> <span
class="string">"/usr/local/share/xsl/docbook"</span>
<span class="special">:</span> <span
class="string">"/usr/local/share/xml/docbook/4.2"</span>
<span class="special">;</span>
</pre>
<p>
The above steps are enough to get a functional BoostBook setup.
Quickbook
will be automatically built when needed. If you want to avoid these
rebuilds
and install a system-wide Quickbook instead:
</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>).
</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>.
</li>
<li>
Copy the resulting <tt class="computeroutput"><span
class="identifier">quickbook</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)
to a safe place. Following our previous example, you can install it
into:
<tt 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></tt>.
</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:
</li>
</ol></div>
<pre class="programlisting">
<span class="keyword">using</span> <span class="identifier">quickbook</span>
<span class="special">:</span> <span
class="string">"/usr/local/bin/quickbook"</span> <span class="special">;</span>
<span class="special">;</span>
</pre>
<p>
Additionally, if you need to build documentation that uses <a
href="http://www.doxygen.org"; target="_top">Doxygen</a>,
you will need to install it too:
</p>
<div class="orderedlist"><ol type="1">
<li>
Go to the <a
href="http://www.stack.nl/~dimitri/doxygen/download.html#latestsrc";
target="_top">downloads
section</a> and get the disk image (<tt class="computeroutput"><span
class="identifier">dmg</span></tt>
file) for Mac OS X.
</li>
<li>
Open the disk image and drag the Doxygen application to your <tt
class="computeroutput"><span class="identifier">Applications</span></tt> folder
to install it.
</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:
</li>
</ol></div>
<pre class="programlisting">
<span class="keyword">using</span> <span class="identifier">doxygen</span>
<span class="special">:</span> <span class="special">/</span><span
class="identifier">Applications</span><span class="special">/</span><span
class="identifier">Doxygen</span><span class="special">.</span><span
class="identifier">app</span><span class="special">/</span><span
class="identifier">Contents</span><span class="special">/</span><span
class="identifier">Resources</span><span class="special">/</span><span
class="identifier">doxygen</span>
<span class="special">;</span>
</pre>
<p>
Alternatively, you may want to install all the prerequistes through a
package
system to avoid manual management of the installations. In that case,
check
out <a href="http://www.pkgsrc.org"; target="_top">pkgsrc</a>.
</p>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";
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="../install.html"><img
src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a
accesskey="u" href="../install.html"><img
src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h"
href="../../index.html"><img src="../../../../../../doc/html/images/home.png"
alt="Home"></a><a accesskey="n" href="windows.html"><img
src="../../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>
-------------------------------------------------------------------------
This SF.net email is sponsored by: Splunk Inc.
Still grepping through log files to find problems? Stop.
Now Search log events and configuration files using AJAX and a browser.
Download your FREE copy of Splunk now >> http://get.splunk.com/
_______________________________________________
Boost-cvs mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/boost-cvs
