/usr/share/doc/libtools-macro-clojure/html/README.html is in libtools-macro-clojure 0.1.5-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<head>
<title>clojure.tools.macro</title>
</head>
<body>
<h1>clojure.tools.macro</h1>
<p>Tools for writing macros.</p>
<h1>Releases and Dependency Information</h1>
<p>Latest stable release: 0.1.2</p>
<ul>
<li><p><a href="http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22org.clojure%22%20AND%20a%3A%22tools.macro%22">All Released Versions</a></p></li>
<li><p><a href="https://oss.sonatype.org/index.html#nexus-search;gav~org.clojure~tools.macro~~~">Development Snapshot Versions</a></p></li>
</ul>
<p><a href="https://github.com/technomancy/leiningen">Leiningen</a> dependency information:</p>
<pre><code>[org.clojure/tools.macro "0.1.2"]
</code></pre>
<p><a href="http://maven.apache.org/">Maven</a> dependency information:</p>
<pre><code><dependency>
<groupId>org.clojure</groupId>
<artifactId>tools.macro</artifactId>
<version>0.1.2</version>
</dependency>
</code></pre>
<h1>Example Usages</h1>
<h4>macrolet: local macro definitions</h4>
<p>Example:</p>
<pre><code>(macrolet [(foo [form] `(~form ~form))]
(foo x))
</code></pre>
<p>expands to <code>(x x)</code></p>
<h4>symbol-macrolet: local symbol macro definitions</h4>
<p>Example:</p>
<pre><code>(symbol-macrolet [def foo]
(def def def))
</code></pre>
<p>expands to <code>(def def foo)</code></p>
<h4>defsymbolmacro, with-symbol-macros: global symbol macro definitions</h4>
<p>Example:</p>
<pre><code>(defsymbolmacro sum-2-3 (plus 2 3))
(with-symbol-macros
(+ 1 sum-2-3))
</code></pre>
<p>expands to <code>(+ 1 (plus 2 3))</code></p>
<h4>mexpand-1</h4>
<p>like clojure.core/macroexpand-1, but handles symbol macros</p>
<h4>mexpand</h4>
<p>like clojure.core/macroexpand, but handles symbol macros </p>
<h4>mexpand-all</h4>
<p>full recursive macro expansion </p>
<h4>name-with-attributes</h4>
<p>For writing def-like macros. Handles optional docstrings and attribute
maps for a name to be defined in a list of macro arguments.</p>
<h1>Developer Information</h1>
<ul>
<li><p><a href="https://github.com/clojure/tools.macro">GitHub project</a></p></li>
<li><p><a href="http://dev.clojure.org/jira/browse/TMACRO">Bug Tracker</a></p></li>
<li><p><a href="http://build.clojure.org/job/tools.macro/">Continuous Integration</a></p></li>
<li><p><a href="http://build.clojure.org/job/tools.macro-test-matrix/">Compatibility Test Matrix</a></p></li>
</ul>
<h1>Change Log</h1>
<ul>
<li>Release 0.1.2 on 2012.02.18
<ul>
<li>Protect symbols bound by let and letfn against macroexpansion from an outer scope</li>
</ul></li>
<li>Release 0.1.1 on 2011.05.26
<ul>
<li>Added <code>name-with-attributes</code></li>
</ul></li>
<li>Release 0.1.0 on 2011.05.04
<ul>
<li>Version imported from old contrib</li>
</ul></li>
</ul>
<h1>Copyright and License</h1>
<p>Copyright (c) 2011 Rich Hickey. All rights reserved. The use and distribution terms for this software are covered by the Eclipse Public License 1.0 (http://opensource.org/licenses/eclipse-1.0.php) which can be found in the file epl-v10.html at the root of this distribution. By using this software in any fashion, you are agreeing to be bound bythe terms of this license. You must not remove this notice, or any other, from this software.</p>
</body>
</html>
|