Changes between Version 48 and Version 49 of BoostDocs/GettingStarted

Timestamp:

Feb 17, 2009, 10:47:41 PM (14 years ago)

Author:

Daniel James

Comment:

Reorganise OS X instructions, and add BasicTeX details.

BoostDocs/GettingStarted

@@ -114 +114 @@
 === OS X ===
 
-I'm not sure about any of this...
-
- * Doxygen has an OS X download.
- * `xsltproc` is included with OS X, but is too old,
-   [http://www.explain.com.au/oss/libxml2xslt.html binaries] are available.
-   I haven't tried them yet.
- * Need to install docbook manually.
- * [http://tug.org/mactex/ MacTex]
-
-(Alternatively use macports or fink?)
-
-==== Macports ====
-
-(I'm working on this, so just assorted notes for now).
-
-Doxygen doesn't compile on tiger at the moment: http://trac.macports.org/ticket/18258
+''TODO: Fink''
+
+Macports has packages for `boost-build` and `boost-jam` but I think it might be best to use the version from your boost tarball/checkout, so that you're up to date.
+OS X comes with xsltproc, but it's too old, so a recent version needs to be installed.
+
+Install libxslt, docbook and doxygen using macports:
+
+{{{
+sudo port install docbook-xml-4.2 docbook-xsl libxslt doxygen
+}}}
+
+`user-config.jam`:
+
+{{{
+using darwin ;
+using doxygen ;
+using boostbook
+    : /opt/local/share/xsl/docbook-xsl/
+    : /opt/local/share/xml/docbook/4.2
+    ;
+}}}
+
+==== Latex and Ghostscript ====
+
+[http://mactex-wiki.tug.org/wiki/index.php?title=TeX_Distributions List of TeX distributions]
+
+===== !MacPorts =====
+
+With macports latex is a large download - very slow.
+
 Texlive_base doesn't seem to compile with x11: http://trac.macports.org/ticket/18326
-
-Which doesn't look very good. I think macports might be useful for gcc, xsl and docbook. For doxygen and latex, I think it might be best to use prebuilt packages from elsewhere.
 
 To avoid installing x11:
@@ -141 +153 @@
 }}}
 
-(or maybe just add `+no_x11` to the command line). Formulas won't be anti-aliased - not suitable for production build.
-
-{{{
-sudo port install docbook-xml-4.2 docbook-xsl libxslt doxygen texlive
-}}}
-
-This takes a long time - in particular, texlive is a large download.
-
-Macports has packages for `boost-build` and `boost-jam` but I think it might be best to manually install them, so that you're up to date.
-
-On Tiger, you need to be using xsltproc from macport's `libxslt` as the one included in OS X is very old but it might not be needed on Leopard.
-
-Leopard's version:
-
-{{{
-$ /usr/bin/xsltproc --version
-Using libxml 20616, libxslt 10112 and libexslt 810
-xsltproc was compiled against libxml 20616, libxslt 10112 and libexslt 810
-libxslt 10112 was compiled against libxml 20616
-libexslt 810 was compiled against libxml 20616
-}}}
-
-Macport's version:
-
-{{{
-$ /opt/local/bin/xsltproc --version
-Using libxml 20703, libxslt 10124 and libexslt 813
-xsltproc was compiled against libxml 20703, libxslt 10124 and libexslt 813
-libxslt 10124 was compiled against libxml 20703
-libexslt 813 was compiled against libxml 20703
-}}}
-
-I think we should recommend getting an up to date version.
-
-`user-config.jam`:
-
-{{{
-using darwin ;
-using doxygen ;
-using boostbook
-    : /opt/local/share/xsl/docbook-xsl/
-    : /opt/local/share/xml/docbook/4.2
-    ;
-}}}
+(or maybe just add `+no_x11` to the following command line).
+
+{{{
+sudo port install texlive
+}}}
+
+===== !BasicTex =====
+
+Install `BasicTeX-2008.dmg` and `mactex-additions.mpkg.zip` from http://www.tug.org/mactex/morepackages.html
+
+Add to path `/usr/local/bin/` (probably already in path) and `/usr/local/texlive/2008basic/bin/universal-darwin/`.
 
 === Debian/ubuntu ===