Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

- Makefile:

  - In the stattrees target, added ctags generation

- TODO:
  - Added a TODO list (it's up for grabs ;)
  • Loading branch information...
commit 8dbde0b74c61cce04964dfd5f818b3b1f2560c6b 1 parent fc7eb7d
@docelic docelic authored
Showing with 28 additions and 21 deletions.
  1. +7 −21 Makefile
  2. +21 −0 TODO
View
28 Makefile
@@ -106,9 +106,15 @@ $(LTMPDIR):
# STATTREE
tmp/stattrees:
-for p in $(IC_VERSIONS); do \
- ./bin/stattree sources/$$p \
+ ./bin/stattree sources/$$p; \
+ ctags -R -x --languages=perl --perl-kinds=cls sources/$$p/ \
+ > cache/$$p/.objectlist.perl.txt; \
+ ctags -R -x --languages=c --c-kinds=cdf sources/$$p/ \
+ > cache/$$p/.objectlist.c.txt; \
+ ctags -f cache/$$p/.tags -R --extra=fq --fields=afikKlmnsSz --line-directives sources/$$p \
; done
+
#
# Cleanup
#
@@ -126,10 +132,6 @@ distclean: clean
#
# OlinkDBs
#
-# TODO OlinkDB targets get properly called implicitly by
-# the above targets, but SOMEHOW the tmp/*.db files are not created.
-# Everything works fine if you run it manually. I really don't know
-# the problem here.
# OlinkDB information for unchunked parts
#$(LTMPDIR)/%-nc.db: %.xml $(LTMPDIR)
# $(XSLT) $(XSLT_FLAGS) \
@@ -145,21 +147,5 @@ distclean: clean
# docbook/html-chunks.xsl $<
#
#
-# # Generate human-readable ctags information
-# -for p in $(IC_VERSIONS); do \
-# ctags -R -x --languages=perl --perl-kinds=cls sources/$$p/ \
-# > $(CACHE)/$$p/.objectlist.perl.txt; \
-# ctags -R -x --languages=c --c-kinds=cdf sources/$$p/ \
-# > $(CACHE)/$$p/.objectlist.c.txt; \
-# cd sources \
-# ; done
-#
-#tags:
-# # Generate ctags information
-# -for p in $(IC_VERSIONS); do \
-# ctags -f $(CACHE)/$$p/.tags -R --extra=fq --fields=afikKlmnsSz --line-directives sources/$$p; \
-# cd sources \
-# ; done
-#
## TODO Make target that conveniently checks out all IC releases from CVS
#
View
21 TODO
@@ -0,0 +1,21 @@
+
+DOCUMENTATION SYSTEM:
+- Make items in the See Also section to appear as links to the
+ appropriate items.
+- For reference pages, make Examples appear without the "Example XY"
+ prefix.
+- See why each Example has weird characters around the example index number
+ (it renders badly in manpages).
+- In bin/stattree, when extracting symbol context, also try to determine
+ function name in question and print its name in Context header (along with
+ filename/line number).
+- Make more use of docbook/catalog.xml
+
+ Long-term:
+- Support using refs/<filename> with all the documentation for a symbol
+ instead of refs/<directory>/<files>.
+
+
+DOCUMENTATION ITSELF:
+- Resolve items from tmp/missing file. (You need to run 'make' in your tree
+ first, to get that file generated).
Please sign in to comment.
Something went wrong with that request. Please try again.