From 2b39cd941c80d2603f2480684c45dd31f9256831 Mon Sep 17 00:00:00 2001 From: simonmar Date: Thu, 4 Apr 2002 16:23:43 +0000 Subject: [haddock @ 2002-04-04 16:23:43 by simonmar] This is Haddock, my stab at a Haskell documentation tool. It's not quite ready for release yet, but I'm putting it in the repository so others can take a look. It uses a locally modified version of the hssource parser, extended with support for GHC extensions and documentation annotations. --- TODO | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 TODO (limited to 'TODO') diff --git a/TODO b/TODO new file mode 100644 index 00000000..9fc4d404 --- /dev/null +++ b/TODO @@ -0,0 +1,35 @@ +* pay attention to import specs! + +* instances: list relevant instances in the documentation for classes and + datatypes. + +* parse module headers, augment Interface with info from header + +* include file revision info in module headers + +* handle scoped type variables in the parser + +* For a re-exported declaration, remap its original names to names that are + "closer" to the current module (might need to rename decls twice: once + for docs with import_env, and once for export with orig_env). This is + the final support needed to fully "hide" modules from the output. + +* fixities + +* we don't deal with records properly - exporting record selectors etc. + +* doc strings for: function arguments + +* remove the s/r conflicts I added to the grammar + +* check handling of special types ([], (), (,) etc.) + +* enhance the doc string parser: + * @...@ for monospaced text + * an apostrophe inside a string shouldn't be considered to be a quote + * `..' instead of '..' ? + +* Handle parse errors better in doc strings + +* Do proper dependency analysis rather than relying on laziness to + sort it out. -- cgit v1.2.3