From 18a5d55f0c31fef9198ee8ed54f4f5fa8f609295 Mon Sep 17 00:00:00 2001 From: Mateusz Kowalczyk Date: Thu, 12 Jun 2014 07:24:29 +0200 Subject: Slightly update the readme. Style-sheets are no longer a recent thing, dead links, old maintainers, different formats. --- README | 31 ++++++++++--------------------- 1 file changed, 10 insertions(+), 21 deletions(-) (limited to 'README') diff --git a/README b/README index 9f205d3b..53f84bf0 100644 --- a/README +++ b/README @@ -6,13 +6,12 @@ from annotated Haskell source code. It is primary intended for documenting library interfaces, but it should be useful for any kind of Haskell code. -Like other systems ([1],[2]), Haddock lets you write documentation -annotations next to the definitions of functions and types in the -source code, in a syntax that is easy on the eye when writing the -source code (no heavyweight mark-up). The documentation generated by -Haddock is fully hyperlinked - click on a type name in a type -signature to go straight to the definition, and documentation, for -that type. +Haddock lets you write documentation annotations next to the +definitions of functions and types in the source code, in a syntax +that is easy on the eye when writing the source code (no heavyweight +mark-up). The documentation generated by Haddock is fully hyperlinked +- click on a type name in a type signature to go straight to the +definition, and documentation, for that type. Haddock understands Haskell's module system, so you can structure your code however you like without worrying that internal structure will be @@ -28,21 +27,11 @@ fact, even without any documentation annotations, Haddock can generate useful documentation from your source code. Haddock can generate documentation in multiple formats; currently HTML -is implemented, and there is partial support for generating DocBook. -The generated HTML uses stylesheets, so you need a fairly up-to-date -browser to view it properly (Mozilla, Konqueror, Opera, and IE 6 -should all be ok). +is implemented, and there is partial support for generating LaTeX and +Hoogle. Full documentation can be found in the doc/ subdirectory, in DocBook format. -Please send questions and suggestions to: - -David Waern or -Simon Marlow - - -[1] IDoc - A No Frills Haskell Interface Documentation System - http://www.cse.unsw.edu.au/~chak/haskell/idoc/ - -[2] HDoc http://www.fmi.uni-passau.de/~groessli/hdoc/ +Please create issues when you have any problems and pull requests if +you have some code. \ No newline at end of file -- cgit v1.2.3