diff --git a/doc/install/OSX.mdwn b/doc/install/OSX.mdwn
index edfeff6a73..775771ebdf 100644
--- a/doc/install/OSX.mdwn
+++ b/doc/install/OSX.mdwn
@@ -32,4 +32,8 @@ git-annex is now [[available in Homebrew|Homebrew]]!
 ## using MacPorts
 
 git-annex is not available in MacPorts, but can be built from source using
-MacPorts tools. See [[MacPorts]]
+MacPorts tools. See [[MacPorts]].
+
+## building it yourself
+
+See [[cabal]].
diff --git a/doc/install/OSX/cabal.mdwn b/doc/install/OSX/cabal.mdwn
new file mode 100644
index 0000000000..b3629c6497
--- /dev/null
+++ b/doc/install/OSX/cabal.mdwn
@@ -0,0 +1,6 @@
+If you cannot get a OSX build of git-annex suitable for your computer,
+from eg [[HomeBrew]] or the regular [[OSX]] prebuilt app, you
+can try Building git-annex from source on OSX, using haskell's cabal package
+manager.
+
+For general instructions for using cabal, see [[this page|/install/cabal]].
diff --git a/doc/install/OSX/comment_11_740fa80e2e54e6fb570f820ff1f56440._comment b/doc/install/OSX/cabal/comment_11_740fa80e2e54e6fb570f820ff1f56440._comment
similarity index 100%
rename from doc/install/OSX/comment_11_740fa80e2e54e6fb570f820ff1f56440._comment
rename to doc/install/OSX/cabal/comment_11_740fa80e2e54e6fb570f820ff1f56440._comment
diff --git a/doc/install/OSX/comment_13_d6f1db401858ffea23c123db49f5b296._comment b/doc/install/OSX/cabal/comment_13_d6f1db401858ffea23c123db49f5b296._comment
similarity index 100%
rename from doc/install/OSX/comment_13_d6f1db401858ffea23c123db49f5b296._comment
rename to doc/install/OSX/cabal/comment_13_d6f1db401858ffea23c123db49f5b296._comment
diff --git a/doc/install/OSX/comment_14_035f856923276b0edad879e196e94097._comment b/doc/install/OSX/cabal/comment_14_035f856923276b0edad879e196e94097._comment
similarity index 100%
rename from doc/install/OSX/comment_14_035f856923276b0edad879e196e94097._comment
rename to doc/install/OSX/cabal/comment_14_035f856923276b0edad879e196e94097._comment
diff --git a/doc/install/OSX/comment_15_336e0acb00e84943715e69917643a69e._comment b/doc/install/OSX/cabal/comment_15_336e0acb00e84943715e69917643a69e._comment
similarity index 100%
rename from doc/install/OSX/comment_15_336e0acb00e84943715e69917643a69e._comment
rename to doc/install/OSX/cabal/comment_15_336e0acb00e84943715e69917643a69e._comment
diff --git a/doc/install/OSX/comment_16_1befafa862b7d07b1f6e57c0182497cf._comment b/doc/install/OSX/cabal/comment_16_1befafa862b7d07b1f6e57c0182497cf._comment
similarity index 100%
rename from doc/install/OSX/comment_16_1befafa862b7d07b1f6e57c0182497cf._comment
rename to doc/install/OSX/cabal/comment_16_1befafa862b7d07b1f6e57c0182497cf._comment
diff --git a/doc/install/OSX/comment_22_6b5f44a98f9d37a1c6ecfe19a60fe6c5._comment b/doc/install/OSX/cabal/comment_22_6b5f44a98f9d37a1c6ecfe19a60fe6c5._comment
similarity index 100%
rename from doc/install/OSX/comment_22_6b5f44a98f9d37a1c6ecfe19a60fe6c5._comment
rename to doc/install/OSX/cabal/comment_22_6b5f44a98f9d37a1c6ecfe19a60fe6c5._comment
diff --git a/doc/install/OSX/comment_23_3d82a270dd4b0159f4aab5675166e1e3._comment b/doc/install/OSX/cabal/comment_23_3d82a270dd4b0159f4aab5675166e1e3._comment
similarity index 100%
rename from doc/install/OSX/comment_23_3d82a270dd4b0159f4aab5675166e1e3._comment
rename to doc/install/OSX/cabal/comment_23_3d82a270dd4b0159f4aab5675166e1e3._comment
diff --git a/doc/install/OSX/comment_24_b9d3563a2cc3d769f27876e028dc344d._comment b/doc/install/OSX/cabal/comment_24_b9d3563a2cc3d769f27876e028dc344d._comment
similarity index 100%
rename from doc/install/OSX/comment_24_b9d3563a2cc3d769f27876e028dc344d._comment
rename to doc/install/OSX/cabal/comment_24_b9d3563a2cc3d769f27876e028dc344d._comment
diff --git a/doc/install/OSX/comment_28_0970bfd63137ea48701dff6aea1b4bcb._comment b/doc/install/OSX/cabal/comment_28_0970bfd63137ea48701dff6aea1b4bcb._comment
similarity index 100%
rename from doc/install/OSX/comment_28_0970bfd63137ea48701dff6aea1b4bcb._comment
rename to doc/install/OSX/cabal/comment_28_0970bfd63137ea48701dff6aea1b4bcb._comment
diff --git a/doc/install/OSX/comment_30_ce58633ef5b2f8f4caa7e626358f33be._comment b/doc/install/OSX/cabal/comment_30_ce58633ef5b2f8f4caa7e626358f33be._comment
similarity index 100%
rename from doc/install/OSX/comment_30_ce58633ef5b2f8f4caa7e626358f33be._comment
rename to doc/install/OSX/cabal/comment_30_ce58633ef5b2f8f4caa7e626358f33be._comment
diff --git a/doc/install/OSX/comment_31_09084a7b3cf06bfa3add0f4991476ffe._comment b/doc/install/OSX/cabal/comment_31_09084a7b3cf06bfa3add0f4991476ffe._comment
similarity index 100%
rename from doc/install/OSX/comment_31_09084a7b3cf06bfa3add0f4991476ffe._comment
rename to doc/install/OSX/cabal/comment_31_09084a7b3cf06bfa3add0f4991476ffe._comment
diff --git a/doc/install/OSX/comment_32_a46d8e3e7795b9afb1e1c2be943d12af._comment b/doc/install/OSX/cabal/comment_32_a46d8e3e7795b9afb1e1c2be943d12af._comment
similarity index 100%
rename from doc/install/OSX/comment_32_a46d8e3e7795b9afb1e1c2be943d12af._comment
rename to doc/install/OSX/cabal/comment_32_a46d8e3e7795b9afb1e1c2be943d12af._comment
diff --git a/doc/install/OSX/comment_33_203a36322b3c453c05c8906c64e62e06._comment b/doc/install/OSX/cabal/comment_33_203a36322b3c453c05c8906c64e62e06._comment
similarity index 100%
rename from doc/install/OSX/comment_33_203a36322b3c453c05c8906c64e62e06._comment
rename to doc/install/OSX/cabal/comment_33_203a36322b3c453c05c8906c64e62e06._comment
diff --git a/doc/install/OSX/comment_34_874ff01f27911baf6ef0f559d5d5f5a0._comment b/doc/install/OSX/cabal/comment_34_874ff01f27911baf6ef0f559d5d5f5a0._comment
similarity index 100%
rename from doc/install/OSX/comment_34_874ff01f27911baf6ef0f559d5d5f5a0._comment
rename to doc/install/OSX/cabal/comment_34_874ff01f27911baf6ef0f559d5d5f5a0._comment
diff --git a/doc/install/OSX/comment_8_38d9c2eea1090674de2361274eab5b0e._comment b/doc/install/OSX/cabal/comment_8_38d9c2eea1090674de2361274eab5b0e._comment
similarity index 100%
rename from doc/install/OSX/comment_8_38d9c2eea1090674de2361274eab5b0e._comment
rename to doc/install/OSX/cabal/comment_8_38d9c2eea1090674de2361274eab5b0e._comment
diff --git a/doc/install/OSX/comment_9_35bf3812db6f3ef25da9b3bc84f147c5._comment b/doc/install/OSX/cabal/comment_9_35bf3812db6f3ef25da9b3bc84f147c5._comment
similarity index 100%
rename from doc/install/OSX/comment_9_35bf3812db6f3ef25da9b3bc84f147c5._comment
rename to doc/install/OSX/cabal/comment_9_35bf3812db6f3ef25da9b3bc84f147c5._comment
diff --git a/doc/install/OSX/comment_4_bbe99673033e4c48c8bb3db24ee419f9._comment b/doc/install/OSX/comment_4_bbe99673033e4c48c8bb3db24ee419f9._comment
deleted file mode 100644
index f3838e890b..0000000000
--- a/doc/install/OSX/comment_4_bbe99673033e4c48c8bb3db24ee419f9._comment
+++ /dev/null
@@ -1,8 +0,0 @@
-[[!comment format=mdwn
- username="https://www.google.com/accounts/o8/id?id=AItOawkSq2FDpK2n66QRUxtqqdbyDuwgbQmUWus"
- nickname="Jimmy"
- subject="comment 4"
- date="2012-12-10T17:00:43Z"
- content="""
-For those that care, I've updated my autobuilder to the latest version of haskell-platform 2012.4.0.0 and it appears to be building correctly.
-"""]]