From b39349280dde1b103d60a315d503773afdd23225 Mon Sep 17 00:00:00 2001
From: Jean-Francois Dockes <jfd@recoll.org>
Date: Mon, 6 Jun 2011 14:03:45 +0200
Subject: [PATCH] doc: macport download

---
 website/download.html | 58 +++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 56 insertions(+), 2 deletions(-)

diff --git a/website/download.html b/website/download.html
index 2606b6ce..b5492599 100644
--- a/website/download.html
+++ b/website/download.html
@@ -40,7 +40,7 @@
          <td><a href="#rpms">Rpm/deb packages</a></td>
          <td><a href="BUGS.html">Known bugs</a></td>
 	 <td><a href="#otherbinary">Other binary packages</a></td>
-	 <td><a href="#ports">Bsd port</a></td>
+	 <td><a href="#ports">Bsd and Mac ports</a></td>
 	 <td><a href="#filters">Filters</a> </td>
 	 <td><a href="#translations">Translations</a></td>
 	  </tr>
@@ -331,8 +331,9 @@ I now use the OpenSUSE build service to create Recoll OpenSUSE packages.
       </blockquote>
 
 
-      <h2><a name="ports">FreeBSD ports</a></h2> 
+      <h2><a name="ports">Ports</a></h2> 
 
+      <h3>FreeBSD ports</h3>
       <p>There are ports for both xapian-core
 	and recoll in the standard tree, you may just need to update
 	your ports (cvsup, portsnap), or you can get the ports from
@@ -342,6 +343,59 @@ I now use the OpenSUSE build service to create Recoll OpenSUSE packages.
 	<a href="http://cvsweb.freebsd.org/ports/deskutils/recoll">
 	  recoll port</a>.</p>
 
+      <h3>Mac port</h3>
+
+      <p>It seems that Recoll will sometimes find data that Spotlight
+        misses (especially inside pdfs apparently, which is probably
+        more to the credit of poppler than recoll itself).</p>
+      <p>There is a MacPorts Portfile available for Recoll 1.15.9. It
+        is not in the official MacPorts tree though, but you can use it
+        outside the tree anyway.</p>
+      <p>The following is based on
+      the <a href="http://guide.macports.org/#development.local-repositories">
+          the MacPort documentation</a>. Procedure:</p>
+      <ul>
+        <li>Install <a href="http://www.macports.org/">MacPorts</a>
+          if it's not there yet.</li>
+        <li>Download
+          the <a href="files/macport-recoll-1.15.9.tar.gz">recoll
+            Portfile tree (tar file)</a>.</li> 
+        <li>Decide where you want the local port tree to leave (it's
+          tiny), ie: /Users/myself/macports.</li>
+        <li>Edit /opt/local/etc/macports/sources.conf, and insert a URL
+          pointing to your local repository before the rsync one:
+<pre>
+    file:///Users/myself/macports
+    rsync://rsync.macports.org/release/ports [default]
+</pre>
+        </li>
+        <li>Extract the port tar file inside your local tree:
+<pre>
+    cd /Users/myself/macports
+    tar xvzf /path/to/the/downloaded/macport-recoll-1.15.9.tar.gz
+</pre>
+        </li>
+        <li>Use the MacPorts portindex
+          command in the local repository's directory to create or
+          update the index of the ports in your local repository:
+<pre>
+    cd ~/Users/myself/macports
+    portindex
+</pre>
+          Once the local port is added to the PortIndex, it becomes
+          available for searching or installation as with any other
+          Portfile in the MacPorts
+         tree.
+        </li>
+        <li>Install :) :
+<pre>
+    sudo port install recoll
+</pre>
+      </ul>
+      <p>Recoll is then available from the command line. There is
+        probably a way to run it in a clicky way, but some more
+        advanced mac user will have to point me to it...</p>
+
       <h2><a name="translations">Translations</a></h2>
 
       <p>Most of the translations for 1.15 are incomplete