Mike Gerwitz
c058e0ca1e
Generate variable definitions
...
That is, top-level variables.
2015-10-06 23:39:09 -04:00
Mike Gerwitz
ca28680f79
Add namespace to function/template Texinfo output
...
This allows users to actually...uh..._use_ it.
2015-09-29 22:52:09 -04:00
Mike Gerwitz
10b270250f
De-indent docblocks when rendering Texinfo
2015-09-29 21:37:38 -04:00
Mike Gerwitz
5c4059e20a
Do not treat line-separated comments as docblocks
...
This is already handled by the `is-docblock` predicate, but was also needed
here. In particular, if we have a situation like this:
```xml
<!--
No a docblock.
-->
<function name="foo">
<!-- ... -->
</function>
```
we do not want that comment to be considered the docblock of `foo`, since it
does not appear immediately adjacent to it.
2015-09-29 21:27:55 -04:00
Mike Gerwitz
ab0d0a8e46
texinfo namespace change to reflect project rename
...
The rename happened a while back.
2015-09-29 21:25:33 -04:00
Mike Gerwitz
b08861779e
{:=>#} Texinfo anchor arity delimiter
...
This is more in line with conventional XSL function references, such as
those in the W3C specification.
2015-09-29 00:12:22 -04:00
Mike Gerwitz
32ae0ec8ce
Texinfo function documentation fixes and changes
2015-09-29 00:03:40 -04:00
Mike Gerwitz
e27e446006
texinfo.xsl copyright year update
2015-09-29 00:02:59 -04:00
Mike Gerwitz
c9f9ab5d50
Prefix woven definition with text indicator
...
This helps make clear that the code snippet is not an example, or part of an
example that ends the description (in the docblock).
2015-09-29 00:00:09 -04:00
Mike Gerwitz
c3d0839b9a
Prevent reading preceding sibling's docblock
2015-09-28 23:59:34 -04:00
Mike Gerwitz
88b1a9ba49
Account for parity in Texinfo function anchor
2015-09-28 23:58:59 -04:00
Mike Gerwitz
30daa3c1d9
Comments preceding stylesheet declaration no longer processed
...
The original intent of processing this was to try to generate useful
documentation for any source. Now, this project is moving more toward
expecting that the user make use of its literate features.
2015-04-17 14:06:12 -04:00
36c9e09625
xsltexi => literate-xsl; stylesheet rename to reflect
2015-04-16 09:04:18 -04:00
40e0464c67
Functions and named templates now generate anchors
...
Anchors are generated from the namespace prefix and local name, making it
easy (and intuitive) to reference.
2015-04-15 12:28:01 -04:00
21f94be4e8
Comments now considered docblocks only when immediately adjacent
...
See comments in this commit.
2015-04-14 16:42:32 -04:00
106f96c498
Stupidly simple serialization
...
This will be improved upon in the future; it exists in the spirit of weaving
in literate programming.
2015-04-14 14:22:26 -04:00
530407e05d
Attribute selectors now escaped in @match output
2015-04-14 12:12:57 -04:00
Mike Gerwitz
5cded3d64b
Trailing space removed from param list output
2014-12-19 14:50:05 -05:00
Mike Gerwitz
ef7d968fe0
Proper handling of non-docblock comments
2014-12-19 14:30:37 -05:00
Mike Gerwitz
4b51d40bb5
Initial documentation concept
...
Based on Knuth's concept of literate programming.
2014-12-19 11:54:43 -05:00
Mike Gerwitz
Mike Gerwitz