name: haddock version: 2.18.1 synopsis: A documentation-generation tool for Haskell libraries description: This is Haddock, a tool for automatically generating documentation from annotated Haskell source code. It is primary intended for documenting library interfaces, but it should be useful for any kind of Haskell code. . 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). . Haddock understands Haskell's module system, so you can structure your code however you like without worrying that internal structure will be exposed in the generated documentation. For example, it is common to implement a library in several modules, but define the external API by having a single module which re-exports parts of these implementation modules. Using Haddock, you can still write documentation annotations next to the actual definitions of the functions and types in the library, but the documentation annotations from the implementation will be propagated to the external API when the documentation is generated. Abstract types and classes are handled correctly. In fact, even without any documentation annotations, Haddock can generate useful documentation from your source code. license: BSD3 license-file: LICENSE author: Simon Marlow, David Waern maintainer: Alex Biehl , Simon Hengel , Mateusz Kowalczyk homepage: http://www.haskell.org/haddock/ bug-reports: https://github.com/haskell/haddock/issues copyright: (c) Simon Marlow, David Waern category: Documentation build-type: Simple cabal-version: >= 2.0 tested-with: GHC==8.2.* extra-source-files: CHANGES.md README.md doc/Makefile doc/README.md doc/*.rst doc/conf.py driver-test/*.hs haddock-api/src/haddock.sh html-test/src/*.hs html-test/ref/*.html hypsrc-test/src/*.hs hypsrc-test/ref/src/*.html latex-test/src/Simple/*.hs latex-test/ref/Simple/*.tex latex-test/ref/Simple/*.sty flag in-ghc-tree description: Are we in a GHC tree? default: False manual: True executable haddock default-language: Haskell2010 main-is: Main.hs hs-source-dirs: driver ghc-options: -funbox-strict-fields -Wall -fwarn-tabs -O2 -threaded -- haddock typically only supports a single GHC major version build-depends: base >= 4.3 && < 4.11 if flag(in-ghc-tree) hs-source-dirs: haddock-api/src, haddock-library/vendor/attoparsec-0.13.1.0, haddock-library/src cpp-options: -DIN_GHC_TREE build-depends: filepath, directory, containers, deepseq, array, xhtml >= 3000.2 && < 3000.3, Cabal >= 1.10, ghc-boot, ghc == 8.2.*, bytestring, transformers other-modules: ResponseFile, Documentation.Haddock.Parser Documentation.Haddock.Parser.Monad Documentation.Haddock.Types Documentation.Haddock.Doc Data.Attoparsec Data.Attoparsec.ByteString Data.Attoparsec.ByteString.Buffer Data.Attoparsec.ByteString.Char8 Data.Attoparsec.ByteString.FastSet Data.Attoparsec.ByteString.Internal Data.Attoparsec.Combinator Data.Attoparsec.Internal Data.Attoparsec.Internal.Fhthagn Data.Attoparsec.Internal.Types Data.Attoparsec.Number Documentation.Haddock.Utf8 Documentation.Haddock.Parser.Util Documentation.Haddock Haddock Haddock.Interface Haddock.Interface.Rename Haddock.Interface.Create Haddock.Interface.AttachInstances Haddock.Interface.LexParseRn Haddock.Interface.ParseModuleHeader Haddock.Interface.Specialize Haddock.Parser Haddock.Utils Haddock.Backends.Xhtml Haddock.Backends.Xhtml.Decl Haddock.Backends.Xhtml.DocMarkup Haddock.Backends.Xhtml.Layout Haddock.Backends.Xhtml.Names Haddock.Backends.Xhtml.Themes Haddock.Backends.Xhtml.Types Haddock.Backends.Xhtml.Utils Haddock.Backends.LaTeX Haddock.Backends.HaddockDB Haddock.Backends.Hoogle Haddock.Backends.Hyperlinker Haddock.Backends.Hyperlinker.Ast Haddock.Backends.Hyperlinker.Parser Haddock.Backends.Hyperlinker.Renderer Haddock.Backends.Hyperlinker.Types Haddock.Backends.Hyperlinker.Utils Haddock.ModuleTree Haddock.Types Haddock.Doc Haddock.Version Haddock.InterfaceFile Haddock.Options Haddock.GhcUtils Haddock.Syb Haddock.Convert else -- in order for haddock's advertised version number to have proper meaning, -- we pin down to a single haddock-api version. build-depends: haddock-api == 2.18.1 other-modules: ResponseFile test-suite driver-test type: exitcode-stdio-1.0 default-language: Haskell2010 main-is: Main.hs hs-source-dirs: driver-test, driver other-modules: ResponseFile ResponseFileSpec build-depends: base, hspec test-suite html-test type: exitcode-stdio-1.0 -- This tells cabal that this test depends on the executable -- component 'haddock' from this very same package, as well -- as adding the build-folder where the `haddock` -- executable can be found in front of $PATH build-tool-depends: haddock:haddock default-language: Haskell2010 main-is: Main.hs hs-source-dirs: html-test build-depends: base, filepath, haddock-test == 0.0.1 test-suite hypsrc-test type: exitcode-stdio-1.0 build-tool-depends: haddock:haddock default-language: Haskell2010 main-is: Main.hs hs-source-dirs: hypsrc-test build-depends: base, filepath, haddock-test == 0.0.1 ghc-options: -Wall -fwarn-tabs test-suite latex-test type: exitcode-stdio-1.0 build-tool-depends: haddock:haddock default-language: Haskell2010 main-is: Main.hs hs-source-dirs: latex-test build-depends: base, filepath, haddock-test == 0.0.1 test-suite hoogle-test type: exitcode-stdio-1.0 build-tool-depends: haddock:haddock default-language: Haskell2010 main-is: Main.hs hs-source-dirs: hoogle-test build-depends: base, filepath, haddock-test == 0.0.1 source-repository head type: git location: https://github.com/haskell/haddock.git