diff --git a/README.html b/README.html
index 7464765..05a1eaa 100644
--- a/README.html
+++ b/README.html
@@ -17,7 +17,9 @@ The changes for HTML5 support started from a
 <p>For more information, see
  <a href="http://w3c.github.com/tidy-html5/">w3c.github.com/tidy-html5</a>
 
-<p>For *nix platforms, you can build and install from the source code using the
+<h2>Building the tidy command-line tool</h2>
+<p>For Linux/BSD/OSX platforms, you can build and install the
+<code>tidy</code> command-line tool from the source code using the
 following steps.</p>
 
 <ol>
@@ -27,3 +29,16 @@ following steps.</p>
 
 <p>Note that you will either need to run <code>make install</code> as root,
 or with <code>sudo make install</code>.</p>
+
+<h2>Building the libtidy shared library</h2>
+<p>For Linux/BSD/OSX platforms, you can build and install the
+<code>tidylib</code> shared library (for use in building other
+applications) from the source code using the following steps.</p>
+
+<ol>
+<li>sh build/gnuauto/setup.sh && ./configure && make</li>
+<li>make install</li>
+</ol>
+
+<p>Note that you will either need to run <code>make install</code> as root,
+or with <code>sudo make install</code>.</p>
diff --git a/README.md b/README.md
index 63afc1f..ff363bd 100644
--- a/README.md
+++ b/README.md
@@ -12,8 +12,10 @@ For more information, see [w3c.github.com/tidy-html5][3]
 
    [3]: http://w3c.github.com/tidy-html5/
 
-For *nix platforms, you can build and install from the source code using the
-following steps.
+## Building the tidy command-line tool
+
+For Linux/BSD/OSX platforms, you can build and install the `tidy` command-line
+tool from the source code using the following steps.
 
   1. `make -C build/gmake/`
 
@@ -22,3 +24,16 @@ following steps.
 Note that you will either need to run `make install` as root, or with `sudo make
 install`.
 
+## Building the libtidy shared library
+
+For Linux/BSD/OSX platforms, you can build and install the `tidylib` shared
+library (for use in building other applications) from the source code using the
+following steps.
+
+  1. sh build/gnuauto/setup.sh && ./configure && make
+
+  2. make install
+
+Note that you will either need to run `make install` as root, or with `sudo make
+install`.
+