[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[nongnu] elpa/clojure-ts-mode ed7b301e1e 04/71: Add install instructions
From: |
ELPA Syncer |
Subject: |
[nongnu] elpa/clojure-ts-mode ed7b301e1e 04/71: Add install instructions |
Date: |
Fri, 25 Aug 2023 03:59:23 -0400 (EDT) |
branch: elpa/clojure-ts-mode
commit ed7b301e1efb2cc792c989188b0db8a4e9c9c0c1
Author: dannyfreeman <danny@dfreeman.email>
Commit: dannyfreeman <danny@dfreeman.email>
Add install instructions
---
README.md | 56 +++++++++++++++++++++++++++++++++++++++++++++++++++++++-
1 file changed, 55 insertions(+), 1 deletion(-)
diff --git a/README.md b/README.md
index 1db5e5b4c0..8c182ab2e5 100644
--- a/README.md
+++ b/README.md
@@ -10,8 +10,62 @@ highlighting),indentation, and navigation support for the
# Installation
+## Emacs 29
+
+This package requires Emacs 29 built with tree-sitter support from the
[emacs-29 branch](https://git.savannah.gnu.org/cgit/emacs.git/log/?h=emacs-29).
+As of right now, users must install Emacs from source with tree-sitter
installed on their system.
+More information on this can be found in the Emacs repository:
+[Emacs tree-sitter
starter-guide](https://git.savannah.gnu.org/cgit/emacs.git/tree/admin/notes/tree-sitter/starter-guide?h=emacs-29)
+[Emacs install
instricutions](https://git.savannah.gnu.org/cgit/emacs.git/tree/INSTALL.REPO).
+
+## Install libtree-sitter-clojure shared library
+
+The tree-sitter clojure shared library must be available to Emacs.
+clojure-ts-mode will not automatically install this (yet).
+For now, users must do it themselves manually, which requires that a c
compiler be installed.
+
+To start, clone
[tree-sitter-clojure](https://github.com/dannyfreeman/tree-sitter-clojure).
+
+The run the following code (depending on your OS) from the tree-sitter-clojure
repository on your machine.
+
+### Linux
+```bash
+mkdir -f dist
+cc -c -I./src src/parser.c -o "parser.o"
+cc -fPIC -shared src/parser.o -o "dist/libtree-sitter-clojure.so
+```
+
+### OS X
+```bash
+mkdir -f dist
+cc -c -I./src src/parser.c -o "parser.o"
+cc -fPIC -shared src/parser.o -o "dist/libtree-sitter-clojure.dylib
+```
+
+### Windows
+I don't know how to do this on Windows. Patches welcome!
+
+### Finally, in emacs
+Then tell Emacs where to find the shared library by adding something like this
to your init file
+
+```emacs-lisp
+(setq treesit-extra-load-path '( "~/path/to/tree-sitter-clojure/dist"))
```
-TODO
+
+OR you can move the `libtree-sitter-clojure.so`/`libtree-sitter-clojure.dylib`
to a directory named `tree-sitter`
+under your `user-emacs-directory`.
+
+## Install clojure-ts-mode
+
+This package is not yet avaialble through package.el.
+You can install it by cloning the repository and adding it to your load path.
+
+```bash
+git clone https://github.com/clojure-emacs/clojure-ts-mode.git
+```
+
+```emacs-lisp
+(add-to-list 'load-path "~/path/to/clojure-ts-mode/")
```
## License
- [nongnu] elpa/clojure-ts-mode 712dc772fd 55/71: Adds syntax table, (continued)
- [nongnu] elpa/clojure-ts-mode 712dc772fd 55/71: Adds syntax table, ELPA Syncer, 2023/08/25
- [nongnu] elpa/clojure-ts-mode 8a98d260fd 27/71: Imenu support for namespace, defn, and def forms, ELPA Syncer, 2023/08/25
- [nongnu] elpa/clojure-ts-mode fb63469870 60/71: Update changelog, ELPA Syncer, 2023/08/25
- [nongnu] elpa/clojure-ts-mode b26d46e195 28/71: Add macros to imenu, declare used treesit C functions, ELPA Syncer, 2023/08/25
- [nongnu] elpa/clojure-ts-mode a244ddeee3 43/71: Add comment to explain why extracting seems over-complicated., ELPA Syncer, 2023/08/25
- [nongnu] elpa/clojure-ts-mode bf4a07063a 44/71: Fix missing interfaces in imenu caused my node name typo, ELPA Syncer, 2023/08/25
- [nongnu] elpa/clojure-ts-mode aab92b9c27 45/71: Fix indentation of function calls when treesit node is nil, ELPA Syncer, 2023/08/25
- [nongnu] elpa/clojure-ts-mode a3e5ba84fd 42/71: Add more definition types to imenu, ELPA Syncer, 2023/08/25
- [nongnu] elpa/clojure-ts-mode e624191b3d 11/71: line-start and line-end apply to entire `definition` regex, ELPA Syncer, 2023/08/25
- [nongnu] elpa/clojure-ts-mode 38d3672ba9 18/71: Unused highlight cleanup, ELPA Syncer, 2023/08/25
- [nongnu] elpa/clojure-ts-mode ed7b301e1e 04/71: Add install instructions,
ELPA Syncer <=
- [nongnu] elpa/clojure-ts-mode 8109fdfe1a 40/71: Fix a bad name, ELPA Syncer, 2023/08/25
- [nongnu] elpa/clojure-ts-mode f469a8c558 24/71: Add a note about the current status, ELPA Syncer, 2023/08/25
- [nongnu] elpa/clojure-ts-mode 866e815f8e 63/71: Release v0.1.2, ELPA Syncer, 2023/08/25
- [nongnu] elpa/clojure-ts-mode e423062a04 10/71: Fix a link, ELPA Syncer, 2023/08/25
- [nongnu] elpa/clojure-ts-mode 2fe33b8fc2 35/71: Fix a typo, ELPA Syncer, 2023/08/25
- [nongnu] elpa/clojure-ts-mode aed33874a7 22/71: Update copyright years, ELPA Syncer, 2023/08/25
- [nongnu] elpa/clojure-ts-mode 9fb5739a67 64/71: Add elpaignore file, ELPA Syncer, 2023/08/25
- [nongnu] elpa/clojure-ts-mode 2d6b12e15b 61/71: Fix link in changelog, ELPA Syncer, 2023/08/25
- [nongnu] elpa/clojure-ts-mode 59bbb1e773 31/71: Tweak the readme a bit, ELPA Syncer, 2023/08/25
- [nongnu] elpa/clojure-ts-mode 6cba90c556 67/71: Move defcustom above usage, ELPA Syncer, 2023/08/25