aboutsummaryrefslogtreecommitdiff
path: root/README.org
diff options
context:
space:
mode:
Diffstat (limited to 'README.org')
-rw-r--r--README.org36
1 files changed, 36 insertions, 0 deletions
diff --git a/README.org b/README.org
new file mode 100644
index 0000000..aa8f144
--- /dev/null
+++ b/README.org
@@ -0,0 +1,36 @@
+#+title: docshack: Getting docs easy on Emacs
+
+docshack is a set of tools to get docs for projects for Emacs
+browsing.
+
+* MDN
+
+Requires [[https://elpa.nongnu.org/nongnu/markdown-mode.html][markdown-mode]].
+
+You may use docshack to get MDN markdown docs for local browsing. To
+do so, first build the docs:
+
+#+begin_src sh
+make mdn
+make DESTDIR=~/docs install-mdn
+#+end_src
+
+Then add in your emacs init file (assuming you cloned docshack to
+~~/docshack~).
+
+#+begin_src elisp
+(add-to-list 'load-path "~/docshack/lisp")
+(require 'docshack-mdn)
+#+end_src
+
+Most of the internal links now work in mdn. A nice way to look up mdn
+is with an indexer, like [[https://lesbonscomptes.com/recoll/pages/index-recoll.html][recoll]] (an emacs client is [[https://github.com/alraban/org-recoll][org-recoll]]).
+
+** TODOs
+- [ ] JSxRef links don't work.
+
+* Contact and copyright
+
+docshack is maintained by Yuchen Pei <id@ypei.org>, and covered by GNU
+AGPLv3+. You may find the license text in a file named COPYING.agpl3
+in the project tree.