Florian Eggenhofer authored 7 years ago and Alex Biehl committed 7 years ago

Generate an index for package content search

* Make Span strict in Position

* Hyperlinker: Use a proper map to enrich tokens

This allows us to later throw warnings if can't find an identifier

* WIP: Provide --show-interface option to dump interfaces

Like ghcs own --show-iface this flag dumps a binary interface file to
stdout in a human (and machine) readable fashion. Currently it uses
json as output format.

* Fill all the jsonNull stubs

* Rework Bifunctor instance of DocH, update changelog and documentation

* replace changelog, bring DocMarkupH doc back

* Update CHANGES.md

* Update CHANGES.md

* Move Control.Arrow up

It would result in unused import if the Bifunctor instance is not generated.

TimBaumann authored 7 years ago and Alex Biehl committed 7 years ago

* Fix pretty-printing of pattern signatures

Pattern synonyms can have up to two contexts, both having a
different semantic meaning: The first holds the constraints
required to perform the matching, the second contains the
constraints provided by a successful pattern match. When the
first context is empty but the second is not it is necessary
to render the first, empty context.

* Generate pattern synonym signatures for ctors exported as patterns

This fixes #653.

* Simplify extractPatternSyn

It is not necessary to generate the simplest type signature since
it will be simplified when pretty-printed.

* Add changelog entries for PR #663

* Fix extractPatternSyn error message

Moritz Drexl authored 7 years ago and Alex Biehl committed 7 years ago

* rework rename

* Add regression test for Bug 613

* update tests

* update changelog

* Move `DocMarkup` from haddock-api to haddock-library

* Move more markup related functions

* Markup module

* CHANGELOG

Also improves markup and removes/fixes redundant/obsolete parts

[skip ci]

from https://github.com/aisamanra/haddock-cheatsheet

* Beef up haddock description

* Handle empty lines

This .cabal property has long been considered obsolete

This addresses
https://github.com/haskell/haddock/issues/638#issuecomment-309283297

A practical benefit is that we can control the build-depends and also
avoid some recompilation between library and test-suite.

otherwise we can't test w/ e.g. GHC 7.4.2

* Avoid missing home module warning

* Update haddock-library.cabal

Yuji Yamamoto authored 7 years ago and Alex Biehl committed 7 years ago

* Avoid errors on non UTF-8 Windows

Problem
====

haddock exits with errors like below:

`(1)`

```
haddock: internal error: <stderr>: hPutChar: invalid argument (invalid character)
```

`(2)`

```
haddock: internal error: Language\Haskell\HsColour\Anchors.hs: hGetContents: invalid argument (invalid byte sequence)
```

`(1)` is caused by printing [the "bullet" character](http://www.fileformat.info/info/unicode/char/2022/index.htm) onto stderr.
For example, this warning contains it:

```
Language\Haskell\HsColour\ANSI.hs:62:10: warning: [-Wmissing-methods]
    • No explicit implementation for
        ‘toEnum’
    • In the instance declaration for ‘Enum Highlight’
```

`(2)` is caused when the input file of `readFile` contains some Unicode characters.
In the case above, '⇒' is the cause.

Environment
----

OS: Windows 10
haddock: 2.17.3
GHC: 8.0.1

Solution
====

Add `hSetEncoding handle utf8` to avoid the errors.

Note
====

- I found the detailed causes by these changes for debugging:
    - https://github.com/haskell/haddock/commit/8f29edb6b02691c1cf4c479f6c6f3f922b35a55b
    - https://github.com/haskell/haddock/commit/1dd23bf2065a1e1f2c14d0f4abd847c906b4ecb4
- These errors happen even after executing `chcp 65001` on the console.
  According to the debug code, `hGetEncoding stderr` returns `CP932` regardless of the console encoding.

* Avoid 'internal error: <stderr>: hPutChar: invalid argument (invalid character)' non UTF-8 Windows

Better solution for 59411754a6db41d17820733c076e6a72bcdbd82b's (1)

Yuji Yamamoto authored 7 years ago and Alex Biehl committed 7 years ago

* Ignore .stack-work

* Fix for windows: use nul instead of /dev/null

* Fix for windows: canonicalize line separator

* Also normalize osx line endings

niteria authored 7 years ago and Alex Biehl committed 7 years ago

* Fix haddock: internal error: links: UnhelpfulSpan

This fixes #554 for me. I believe this is another fall out
of `wildcard-refactor`, like #549.

* Comment to clarify why we take the methods name location

* Make per-argument docs for class methods work again

* Test case