aboutsummaryrefslogtreecommitdiff
path: root/TODO
blob: 9723ce66270654e6f2788158a351c2126976462f (plain) (blame)
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
For 1.0:

* parse module headers, augment Interface with info from header

* IDoc compatibility, as far as possible

* named chunks of documentation?

* Handle parse errors better in doc strings

* Do the unlitting/CPPing from Haddock itself

* facilities for saving interfaces so that you can run Haddock against
  something that isn't the Prelude.

* copy haddock.css into the right place when run

* allow the HTML/DocBook to be generated into a specified directory

* remove extra whitespace from the generated HTML

-----------------------------------------------------------------------------
Post 1.0:

* split large modules into several pages (perhaps split at each
  section 1 heading?)

* pay attention to import specs!

* instances: list relevant instances in the documentation for classes and
  datatypes.

* include file revision info in module headers

* Allow fully hiding modules from the output

* Add a link to the defining location of a re-exported entity

* 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.)

* Horizontal lines?

* enhance the doc string parser:
	* @...@ for monospaced text
	* an apostrophe inside a string shouldn't be considered to be a quote

* Do proper dependency analysis rather than relying on laziness to
  sort it out.

* clean up the layout: don't use table cellspacing, use CSS instead