From 9ad344be9dde7c835f0a00ed1faa2e0649306290 Mon Sep 17 00:00:00 2001
From: Jean-Francois Dockes <jf@dockes.org>
Date: Wed, 11 Dec 2019 09:02:55 +0100
Subject: [PATCH] macports readme

---
 packaging/macports/README.asc | 43 +++++++++++++++++++++++++++++++++++
 packaging/macports/README.txt | 28 -----------------------
 2 files changed, 43 insertions(+), 28 deletions(-)
 create mode 100644 packaging/macports/README.asc
 delete mode 100644 packaging/macports/README.txt

diff --git a/packaging/macports/README.asc b/packaging/macports/README.asc
new file mode 100644
index 00000000..e1b998fa
--- /dev/null
+++ b/packaging/macports/README.asc
@@ -0,0 +1,43 @@
+= Building Recoll with macports
+
+== Install macports
+
+https://www.macports.org/install.php
+
+== Have a look at the doc about external/local packages
+
+http://guide.macports.org/#development.local-repositories
+
+== Build Recoll
+
+- Create a directory for the local ports repository and the recoll
+  data. This could be anywhere but you do need the macports/textproc/recoll
+  directories in the path. E.g.:
+
+    mkdir -p ~/macports/textproc/recoll
+  
+- Edit /opt/local/etc/macports/sources.conf, and insert an URL pointing to
+  your local repository *before* the rsync one The file should look like
+  the following (replace <me> with your user name):
+
+    file:///Users/<me>/macports/
+    rsync://rsync.macports.org/release/ports [default]
+
+- Copy the Portfile file and the files/ subdirectory from the recoll source
+  (in packaging/macports) to   macports/textproc/recoll. e.g.: 
+
+    /Users/<me>/macports/textproc/recoll/Portfile
+    /Users/<me>/macports/textproc/recoll/files/...
+
+- Run the MacPorts portindex command in the local repository's directory to
+  create or update the local port index:
+
+    cd /Users/<me>/macports
+    portindex
+
+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,
+for example run the following to build and install recoll:
+
+    sudo port build recoll
+    sudo port install recoll
diff --git a/packaging/macports/README.txt b/packaging/macports/README.txt
deleted file mode 100644
index 810107d7..00000000
--- a/packaging/macports/README.txt
+++ /dev/null
@@ -1,28 +0,0 @@
-
-http://guide.macports.org/#development.local-repositories
-
-To use/test the macports Portfile port out of the official macports tree:
-
-- Edit /opt/local/etc/macports/sources.conf, and insert a URL pointing to
-  your local repository before the rsync one (replace <me> with your user
-  name): 
-
-    file:///Users/<me>/macports/
-    rsync://rsync.macports.org/release/ports [default]
-
-Inserting before ensures it's used before the macports one.
-
-- The Portfile file should be copied under category/portname. e.g.:
-
-    /Users/<me>/macports/textproc/recoll/Portfile
-
-- After you create or update your Portfile, use the MacPorts portindex
-  command in the local repository's directory to create or update the index
-  of the ports in your local repository.
-
-    cd /Users/<me>/macports
-    portindex
-
-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
-