[haddock @ 2002-06-03 14:15:10 by simonmar]

update, and separate into bugs, features, and cosmetic items.

1 files changed, 35 insertions, 35 deletions

diff --git a/TODO b/TODO
index 6a575895..cab9bd87 100644
--- a/TODO
+++ b/TODO
@@ -1,21 +1,39 @@
-* when exporting a class method on its own, don't list the whole class in
-  the export list (we should try to construct the type of the method, somehow).
+-----------------------------------------------------------------------------
+-- bugs
 
-* Allow linking to a section name?
+* don't link to M.x if M.x is re-exported via a 'module N' from module M.
 
-* Class names aren't rendered as proper binders
+* Pick the preferred export names as per the paper.
 
-* for a constructor, don't fill its entire cell with a grey background.
+* instances: need to construct instances for deriving clauses, somehow.
 
-* don't link to M.x if M.x is re-exported via a 'module N' from module M.
+* A module re-export should only reference the target module if the
+  target module is imported without hiding any of its exports (otherwise
+  we should inline just the exported bits).
 
-* switch to longer rendering form for datatypes when necessary?
+* pay attention to import specs!
 
-* Pick the preferred export names as per the paper.
+* remove the s/r conflicts I added to the grammar
+
+* check handling of special types ([], (), (,) etc.)
+
+* Support for the rest of GHC extensions in the parser:
+  - implicit parameters
+  - scoped type variables (return types left to do).
+
+* Be a bit cleaner about error cases: some internal errors can be
+  generated by bugs in the Haskell source.  Divide out the proper
+  internal error cases and emit proper error messages.
+
+-----------------------------------------------------------------------------
+-- features
 
 * Top-level package docs
 
-* instances: need to construct instances for deriving clauses, somehow.
+* Do the unlitting/CPPing from Haddock itself so we get the source file
+  links right.
+
+* Allow linking to a section name?
 
 * attributes for individual declarations, eg.
     -- #abstract
@@ -24,48 +42,30 @@
 
   #long, #short, #noinstances (on a type or class)
 
-* A module re-export should only reference the target module if the
-  target module is imported without hiding any of its exports (otherwise
-  we should inline just the exported bits).
-
 * facilities for saving interfaces so that you can run Haddock against
   something that isn't the Prelude.
 
-* Do the unlitting/CPPing from Haddock itself so we get the source file
-  links right.
-
 * Allow documentation annotations to explicitly name the entity they
   refer to.
 
-* Add back-references from the definition to the uses of types/classes
-  (perhaps in the index?)
 * In the contents page, indicate portability/stability of each module
   somehow.
 
-* remove extra whitespace from the generated HTML to save space
-
-* split large modules into several pages (perhaps split at each
-  section 1 heading?)
-
-* pay attention to import specs!
-
-* include file revision info in module headers
+* Add back-references from the definition to the uses of types/classes
+  (perhaps in the index?)
 
 * Add a link to the defining location of a re-exported entity
 
 * fixities
 
-* we don't deal with records properly - exporting record selectors etc.
-
-* remove the s/r conflicts I added to the grammar
+* include file revision info in module headers
 
-* check handling of special types ([], (), (,) etc.)
+-----------------------------------------------------------------------------
+-- cosmetic
 
-* Horizontal lines?
+* for a constructor, don't fill its entire cell with a grey background.
 
-* clean up the layout: don't use table cellspacing, use CSS instead
+* switch to longer rendering form for datatypes when necessary?
 
-* Support for the rest of GHC extensions in the parser:
-  - implicit parameters
-  - scoped type variables (return types left to do).
+* remove extra whitespace from the generated HTML to save space