Changes to haddock(40)

Changes to haddock:
commit 3945c9aaf13064f768aceb1dc93a43e211e9f4e0
Merge: e0865f5 1063ade
Author: Herbert Valerio Riedel <hvr@gnu.org>
Date:   Wed Mar 12 10:28:39 2014 +0100

    Merge tag 'haddock-2.14.0-release' into ghc-7.8

    This merge has been done in such a way that this commit's tree corresponds
    exactly to the tree pointed to by the haddock-2.14.0-release tag.

    Signed-off-by: Herbert Valerio Riedel <hvr@gnu.org>

commit 1063ade772264cc40a88e0d72db5e26b74439a6e
Author: Mateusz Kowalczyk <fuuzetsu@fuuzetsu.co.uk>
Date:   Tue Mar 11 10:21:09 2014 +0000

    Fix up CPP preparing for release with GHC 7.8.

commit 5f02bd67b9a17feb2dc64dc5f5c011996850fb8a
Author: Niklas Haas <git@nand.wakku.to>
Date:   Tue Mar 11 10:36:55 2014 +0100

    Revert "Reorder topDeclElem to move the source/wiki links to the top"

    This reverts commit 843c42c4179526a2ad3526e4c7d38cbf4d50001d.

    This change is no longer needed with the new rendering style, and it
    messes with copy/pasting lines.

commit b9995041b5c838d41ba14ff684d9f5bfacd9ffc4
Author: Niklas Haas <git@nand.wakku.to>
Date:   Tue Mar 11 09:11:21 2014 +0100

    Add documentation for --source-entity-line

commit b8efaf4ead90c5c95367cc479da522b820b5004e
Author: Niklas Haas <git@nand.wakku.to>
Date:   Tue Mar 11 08:42:34 2014 +0100

    Filter family instances of hidden types

    Currently, this check does not extend to hidden right hand sides,
    although it probably should hide them in that case.

commit 72f655f5a4429403674521d251e6cccf62d76747
Author: Niklas Haas <git@nand.wakku.to>
Date:   Tue Mar 11 07:21:03 2014 +0100

    Update appearance of fixity annotations

    This moves them in-line with their corresponding lines, similar to a
    presentation envision by @hvr and described in #ghc.

    Redundant operator names are also omitted when no ambiguity is present.

commit 3f6c34a3cb23d046486c2a58cdf197b9959a4983
Author: Niklas Haas <git@nand.wakku.to>
Date:   Mon Mar 10 21:32:58 2014 +0100

    Update changelog

commit 28e685d2589e4cd6847c21fe45a3b702c15090ea
Author: Niklas Haas <git@nand.wakku.to>
Date:   Mon Mar 10 21:03:22 2014 +0100

    Include fixity information in the Interface file

    This resolves fixity information not appearing across package borders.

    The binary file version has been increased accordingly.

commit c40ee25c4a9cc4952b237d1b5a659eaeb0023c05
Author: Mateusz Kowalczyk <fuuzetsu@fuuzetsu.co.uk>
Date:   Mon Mar 10 04:24:18 2014 +0000

    Update changelog

commit 68a78932b5b004945f6681bd51e8080e868fc0ee
Author: Niklas Haas <git@nand.wakku.to>
Date:   Sun Mar 9 16:32:36 2014 +0100

    Group similar fixities together

    Identical fixities declared for the same line should now render using
    syntax like: infix 4 <, >=, >, <=

commit 003f11795e4413abae5275e8a855765c571ccab9
Author: Niklas Haas <git@nand.wakku.to>
Date:   Sun Mar 9 06:07:09 2014 +0100

    Differentiate between TH splices (line-links) and regular names

    This adds a new type of source code link, to a specific line rather than
    a specific declaration/name - this is used to link to the location of a
    TH splice that defines a certain name.

    Rather hefty changes throughout and still one unresolved issue (the line
    URLs aren't parsed from the third form of --read-interface which means
    they're currently restricted to same-interface links). Not sure if
    this issue is really worth all the hassle, especially since we could
    just use line links in general.

    This commit also contains some cleanup/clarification of the types in
    Haddock.Backends.Xhtml.Decl and shortens some overlong lines in the
    process. Notably, the Bool parameter was replaced by a Unicode type
    synonym to help clarify its presence in type signatures.

commit 9aa5a2a420788e39806c5fe85845002181f3b945
Author: Niklas Haas <git@nand.wakku.to>
Date:   Sat Mar 8 23:58:38 2014 +0100

    Use optLast instead of listToMaybe for sourceUrls/wikiUrls

    This lets you override them using eg. cabal haddock --haddock-options,
    which can come in handy if you want to use a different layout or URL for
    your source code links than cabal-install generates.

commit 843c42c4179526a2ad3526e4c7d38cbf4d50001d
Author: Niklas Haas <git@nand.wakku.to>
Date:   Sun Mar 9 07:43:39 2014 +0100

    Reorder topDeclElem to move the source/wiki links to the top

    They appear in the same position due to the float: right attribute but
    now they're always at the top of the box instead of at the bottom.

commit 17970e6b6aa22962c498ce02ead8dbadad31a733
Author: Niklas Haas <git@nand.wakku.to>
Date:   Sat Mar 8 09:42:00 2014 +0100

    Render fixity information

    Affects functions, type synonyms, type families, class names, data type
    names, constructors, data families, associated TFs/DFs, type synonyms,
    pattern synonyms and everything else I could think of.

commit e5bd27b5edf533054513871dc475a54a8b1bee23
Author: Mateusz Kowalczyk <fuuzetsu@fuuzetsu.co.uk>
Date:   Mon Feb 24 22:01:11 2014 +0000

    Change rendering of duplicate record field docs

    See Haddock Trac #195. We now change this behaviour to only rendering
    the documentation attached to the first instance of a duplicate field.

    Perhaps we could improve this by rendering the first instance that has
    documentation attached to it but for now, we'll stick with this.

commit daa0ae5ba1acdee031cd72fc6690fe60a6710c20
Author: Mateusz Kowalczyk <fuuzetsu@fuuzetsu.co.uk>
Date:   Mon Feb 24 06:26:50 2014 +0000

    Fix wording in the docs

commit 1bf686940b28394f5d169f297659cd4c66869ec1
Author: Mateusz Kowalczyk <fuuzetsu@fuuzetsu.co.uk>
Date:   Mon Feb 24 06:07:33 2014 +0000

    Fix rendering of Contents when links are present

    Fixes Haddock Trac #267.

commit 6ca276702d04c9183caa98d1848f6aa5b88a8755
Author: Niklas Haas <git@nand.wakku.to>
Date:   Sun Feb 23 16:11:22 2014 +0100

    Add RankNTypes test case to ImplicitParams.hs

    This test actually tests what #260 originally reported - I omitted the
    RankNTypes scenario from the original fix because I realized it's not
    relevant to the underlying issue and indeed, this renders as intended
    now. Still good to have more tests.

commit 64850ca4f7dc2ca0fdb21d078d93cd636de5c87a
Author: Niklas Haas <git@nand.wakku.to>
Date:   Sun Feb 23 15:37:13 2014 +0100

    Lower precedence of equality constraints

    This drops them to the new precedence pREC_CTX, which makes single
    eqaulity constraints show up as (a ~ b) => ty, in line with GHC's
    rendering. Additional tests added to make sure other type operators
    render as intended. Current behavior matches GHC

commit 14531f7838c5abd0ba2aaf5217a477194d7b1897
Author: Niklas Haas <git@nand.wakku.to>
Date:   Sun Feb 23 15:21:52 2014 +0100

    Make ImplicitParams render correctly (#260)

    This introduces a new precedence level for single contexts (because
    implicit param contexts always need parens around them, but other types
    of contexts don't necessarily, even when alone)

commit 1944b94edca881d14e979d564719da6f196f8e63
Author: Mateusz Kowalczyk <fuuzetsu@fuuzetsu.co.uk>
Date:   Sun Feb 23 05:02:47 2014 +0000

    Don't shadow ‘strip’.

    -Wall complains

commit 49b2a05ee0d769568d97a091de93f2ce2512eef6
Author: Mateusz Kowalczyk <fuuzetsu@fuuzetsu.co.uk>
Date:   Sun Feb 23 04:58:50 2014 +0000

    Update test case for lifted GADT type rendering

    The parsing of these seems to have been fixed by GHC folk and it now
    renders differently. IMHO it now renders in a better way so I'm updating
    the test to reflect this.

commit dfc006ad2b8f5cb27570ac02c77aa63c5c027cd9
Author: Simon Hengel <sol@typeful.net>
Date:   Sat Feb 22 21:55:35 2014 +0100

    Turn a source code comment into specs

commit fc7fd1875d31dbfd37eaa058177e534b4fc6bc25
Author: Niklas Haas <git@nand.wakku.to>
Date:   Sat Feb 22 21:15:34 2014 +0100

    Strip a single leading space from bird tracks (#201)

    This makes bird tracks in the form

    > foo
    > bar
    > bat

    parse as if they had been written as

    >foo
    >bar
    >bat

    ie. without the leading whitespace in front of every line.

    Ideally we also want to look into how leading whitespace affects code
    blocks written using the @ @ syntax, which are currently unaffected by
    this patch.

commit 91e2c21cfdaca7913dbfec17bdd7712c0c1ed732
Author: Mateusz Kowalczyk <fuuzetsu@fuuzetsu.co.uk>
Date:   Wed Feb 19 05:11:34 2014 +0000

    Use a bespoke data type to indicate fixity

    This deals with what I imagine was an ancient TODO and makes it much
    clearer what the argument actually does rather than having the user
    chase down the comment.

commit 6b35adfb811d9e41e5bfa1c11963e441740c2836
Author: Niklas Haas <git@nand.wakku.to>
Date:   Sat Feb 15 08:41:40 2014 +0100

    Add test case for inter-module type/data family instances

    These should show up in every place where the class is visible, and
    indeed they do right now.

    Signed-off-by: Mateusz Kowalczyk <fuuzetsu@fuuzetsu.co.uk>

commit 50d1d18cc70cf6c8ffcf247743cd8af0ff9aae16
Author: Mateusz Kowalczyk <fuuzetsu@fuuzetsu.co.uk>
Date:   Thu Feb 13 23:57:16 2014 +0000

    Only warn about missing docs when docs are missing

    This fixes the ‘Missing documentation for…’ message for modules with
    100% coverage.

commit d86f68860c40d45d2cec94edd15d4bf4fc4292d8
Author: Niklas Haas <git@nand.wakku.to>
Date:   Thu Feb 13 22:21:36 2014 +0100

    Get rid of re-implementation of sortBy

    I have no idea what this was doing lying around here, and due to the
    usage of tuples it's actually slower, too.

    Signed-off-by: Mateusz Kowalczyk <fuuzetsu@fuuzetsu.co.uk>

commit 7e53f628440169f90cfb6aeeaf74ffbe2b1cfa6d
Author: nand <git@nand.wakku.to>
Date:   Tue Feb 11 16:51:27 2014 +0100

    Add test case for PatternSynonyms

    This just tests various stuff including poly-kinded patterns and
    operator patterns to make sure the rendering isn't broken.

    Signed-off-by: Mateusz Kowalczyk <fuuzetsu@fuuzetsu.co.uk>

commit bc5756d062bbc5cad5d4fa60798435ed020c518e
Author: nand <git@nand.wakku.to>
Date:   Tue Feb 11 11:52:48 2014 +0100

    Improve display of poly-kinded type operators

    This now displays them as (==) k a b c ... to mirror GHC's behavior,
    instead of the old (k == a) b c ... which was just wrong.

    Signed-off-by: Mateusz Kowalczyk <fuuzetsu@fuuzetsu.co.uk>

commit e0718f203f2448ba2029e70d14aed075860b7fac
Author: nand <git@nand.wakku.to>
Date:   Tue Feb 4 22:13:27 2014 +0100

    Add support for type/data families

    This adds support for type/data families with their respective
    instances, as well as closed type families and associated type/data
    families.

    Signed-off-by: Mateusz Kowalczyk <fuuzetsu@fuuzetsu.co.uk>

commit 860d6504530a163e7483960ca8837eb596e05634
Author: Mateusz Kowalczyk <fuuzetsu@fuuzetsu.co.uk>
Date:   Mon Feb 10 23:27:21 2014 +0000

    Ensure a space between type signature and ‘Source’

    This is briefly related to Haddock Trac #249 and employs effectively the
    suggested fix _but_ it doesn't actually fix the reported issue. This
    commit simply makes copying the full line a bit less of a pain.

commit 01de3a355ee0db773eba5f4368ac8ef4d75425b5
Author: Mateusz Kowalczyk <fuuzetsu@fuuzetsu.co.uk>
Date:   Sun Feb 9 18:27:36 2014 +0000

    Insert a space between module link and description

    Fixes Haddock Trac #277.

commit 1e21c673a42d3337e05607ed4f47024c65d0cc9d
Author: Mateusz Kowalczyk <fuuzetsu@fuuzetsu.co.uk>
Date:   Sun Feb 9 17:51:22 2014 +0000

    Document module header.

    Fixes Haddock Trac #270.

commit 880b91ed0f2fe63c7d35a83ecebb3aa29c2ffc1d
Author: Mateusz Kowalczyk <fuuzetsu@fuuzetsu.co.uk>
Date:   Thu Jan 30 17:21:50 2014 +0000

    Correct whitespace in ‘hidden’ test for <+> change

commit 039b2346cd7a9998135636146ea234eb9cc0fbab
Author: Dr. ERDI Gergo <gergo@erdi.hu>
Date:   Fri Jan 31 00:55:50 2014 +0800

    Handle infix vs prefix names correctly everywhere, by explicitly specifying the context

    The basic idea is that "a" and "+" are either pretty-printed as "a" and "(+)"  or "`a`" and "+"

commit 18e9417edcda21dd23edf675b41f46ab336d773f
Author: Mateusz Kowalczyk <fuuzetsu@fuuzetsu.co.uk>
Date:   Wed Jan 29 21:41:58 2014 +0000

    Update tests

    This updates tests due to Haddock Trac #271 fix and due to removal of
    TypeHoles as an extension from GHC.

commit 7d2106e18f26a680d157ef943da2602e7199afa1
Author: Mateusz Kowalczyk <fuuzetsu@fuuzetsu.co.uk>
Date:   Wed Jan 29 20:37:10 2014 +0000

    Fix @ code blocks

    In cases where we had some horizontal space before the closing ‘@’, the
    parser would not accept the block as a code block and we'd get ugly
    output.

commit cf73b006faf95512b28c744ecfbdf47c044acb67
Author: Dr. ERDI Gergo <gergo@erdi.hu>
Date:   Fri Jan 31 00:15:01 2014 +0800

    <+>: Don't insert a space when concatenating empty nodes

commit 96838d249070e1ab55641b6816360a3e6bc909fa
Author: Austin Seipp <austin@well-typed.com>
Date:   Wed Jan 29 08:09:04 2014 -0600

    Update CPP check for __GLASGOW_HASKELL__

    Signed-off-by: Austin Seipp <austin@well-typed.com>