aboutsummaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* User manual + stuff for building GHC docsAlec Theriault2018-10-261-3/+3
|
* Merge branch 'ghc-8.4' into ghc-8.6Alec Theriault2018-10-161-3/+3
|\
| * Remove unnecessary backslashes from docs (#908)Noel Bourke2018-08-211-3/+3
| | | | | | | | | | | | | | On https://haskell-haddock.readthedocs.io/en/latest/markup.html#special-characters the backslash and backtick special characters showed up with an extra backslash before them – I think the escaping is not (or no longer) needed for those characters in rst.
| * Add # as a special character (#884)Masahiro Sakai2018-07-201-1/+1
| | | | | | | | '#' has special meaning used for anchors and can be escaped using backslash. Therefore it would be nice to be listed as special characters.
| * Additional tests for the identifier parser (#816)Simon Jakobi2018-07-201-9/+4
| | | | | | | | | | | | * Add tests for the identifier parser * docs: Clarify how to delimit identifiers
* | Update the ghc-8.6 branch (#889)Simon Jakobi2018-07-201-9/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * Revert "Bump GHC version to 8.6" This was applied to the wrong branch; there's now a `ghc-8.6` branch; ghc-head is always supposed to point to GHC HEAD, i.e. an odd major version. The next version bump to `ghc-head` is supposed to go from e.g. 8.5 to 8.7 This reverts commit 5e3cf5d8868323079ff5494a8225b0467404a5d1. * README updates (#856) * README: Remove mentions of master branch * README: Add instructions for using html-test * README: Change command to run _all_ the testsuites * README: Add project overview section (cherry picked from commit 61d6f935da97eb96685f07bf385102c2dbc2a33c) * Export more fixities for Hoogle (#871) This exports fixities for more things, including class methods and type-level operators. (cherry picked from commit 88316b972e3d47197b1019111bae0f7f87275fce) * Avoid line breaks due to line length in Hoogle (#868) * Avoid line breaks due to line length in Hoogle Hoogle operates in a line-oriented fashion, so we should avoid ever breaking due to long lines. One way of doing this non-intrusively is to modify the 'DynFlags' that are threaded through the 'Hoogle' module (note this is anyways only passed through for use in the various 'showSDoc' functions). * Amend test case (cherry picked from commit 657b1b3d519545f8d4ca048c06210d6cbf0f0da0) * tyThingToLHsDecl: Preserve type synonyms that contain a forall (#880) * tyThingToLHsDecls: Preserve type synonyms that contain a forall Fixes #879. * Add Note [Invariant: Never expand type synonyms] * Clarify Note [Invariant: Never expand type synonyms] (cherry picked from commit c3eb3f0581f69e816f9453b1747a9f2a3ba02bb9) * Fix HEAD html-test (#860) * Update tests for 'StarIsType' * Accept tests * Revert "Update tests for 'StarIsType'" This reverts commit 7f0c01383bbba6dc5af554ee82988d2cf44e407a. * Refactor handling of parens in types (#874) * Fix type parenthesization in Hoogle backend Ported the logic in the HTML and LaTeX backends for adding in parens into something top-level in 'GhcUtil'. Calling that from the Hoogle backend fixes #873. * Remove parenthesizing logic from LaTeX and XHTML backends Now, the only times that parenthesis in types are added in any backend is through the explicit 'HsParTy' constructor. Precedence is also represented as its own datatype. * List out cases explicitly vs. catch-all * Fix printing of parens for QuantifiedConstraints The priority of printing 'forall' types was just one too high. Fixes #877. * Accept HTML output for quantified contexts test * Preserve docs on type family instances (#867) * Preserve docs on type family instances The only problem was that the instance location was slightly off for type family instances. * Accept output (cherry picked from commit 133e9c2c168db19c1135479f7ab144c4e33af2a4) * Fix broken instance source links (#869) The problem manifests itself in instances that are defined in modules other than the module where the class is defined. The fix is just to thread through the 'Module' of the instance further along. Since orphan instances appear to already have been working, I didn't do anything there. (cherry picked from commit 2de7c2acf9b1ec85b09027a8bb58bf8512e91c05) * Add some more unicode related tests (#872) This has been fixed for sure ever since we switched from attoparsec to parsec. Parts of it may have been working before that, but there was a point where this would have failed (see #191). A regression test never hurt anyone. :) (cherry picked from commit 5ec7715d418bfac0f26aec6039792a99a6e89370) * Misc tests (#858) * More tests * spliced types * constructor/pattern argument docs * strictness marks on fields with argument docs * latex test cases need seperate directory * Accept tests * Additional tests for the identifier parser (#816) * Add tests for the identifier parser * docs: Clarify how to delimit identifiers (cherry picked from commit 0861affeca4d72938f05a2eceddfae2c19199071)
* | Merge branch 'ghc-head' with 'ghc-8.4'Herbert Valerio Riedel2018-05-011-0/+14
|\ \ | |/ |/|
| * Constructor and pattern synonym argument docs (#709)Alec Theriault2018-01-131-0/+14
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * Support Haddocks on constructor arguments This is in conjunction with https://phabricator.haskell.org/D4094. Adds support for rendering Haddock's on (non-record) constructor arguments, both for regular and GADT constructors. * Support haddocks on pattern synonym arguments It appears that GHC already parsed these - we just weren't using them. In the process of doing this, I tried to deduplicate some code around handling patterns. * Update the markup guide Add some information about the new support for commenting constructor arguments, and mention pattern synonyms and GADT-style constructors. * Overhaul LaTeX support for data/pattern decls This includes at least * fixing several bugs that resulted in invalid LaTeX * fixing GADT data declaration headers * overhaul handling of record fields * overhaul handling of GADT constructors * overhaul handling of bundled patterns * add support for constructor argument docs * Support GADT record constructors This means changes what existing HTML docs look like. As for LaTeX, looks like GADT records were never even supported. Now they are. * Clean up code/comments Made code/comments consistent between the LaTeX and XHTML backend when possible. * Update changelog * Patch post-rebase regressions * Another post-rebase change We want return values to be documentable on record GADT constructors.
* | Add grid table example to cheatsheetAlexander Biehl2018-02-011-0/+17
| | | | | | (pdf and svg need to be regenerated thought)
* | Grid Tables (#718)Oleg Grenrus2018-02-011-0/+20
|/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * Add table examples * Add table types and adopt simple parser Simple parser is done by Giovanni Cappellotto (@potomak) in https://github.com/haskell/haddock/pull/577 It seems to support single fine full tables, so far from full RST-grid tables, but it's good start. Table type support row- and colspans, but obviously parser is lacking. Still TODO: - Latex backend. Should we use multirow package https://ctan.org/pkg/multirow?lang=en? - Hoogle backend: ? * Implement grid-tables * Refactor table parser * Add two ill-examples * Update CHANGES.md * Basic documentation for tables * Fix documentation example
* Fix tiny typo in docs (#693)Veronika Romashkina2017-10-241-1/+1
|
* Provide --show-interface option to dump interfaces (#645)Alexander Biehl2017-08-061-0/+5
| | | | | | | | | | | | | | | | | | | | | | * 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.
* Import @aisamanra's Haddock cheatsheetHerbert Valerio Riedel2017-07-205-0/+1181
| | | | from https://github.com/aisamanra/haddock-cheatsheet
* Improve documenation of Haddock markup (#614)Nathan Collins2017-05-111-93/+357
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * Improve documentation of Haddock markup. - document that Haddock supports inferring types top-level functions with without type signatures, but also explain why using this feature is discouraged. Looks like this feature has been around since version 2.0.0.0 in 2008! - rework the "Module description" section: - move the general discussion of field formatting to the section intro and add examples illustrating the prose for multiline fields. - mention that newlines are preserved in some multiline fields, but not in others (I also noticed that commas in the `Copyright` field are not preserved; I'll look into this bug later). - add a subsection for the module description fields documentation, and put the field keywords in code formatting (double back ticks) instead of double quotes, to be consistent with the typesetting of keywords in other parts of the documentation. - mention that "Named chunks" are not supported in the long-form "Module description" documentation. - fix formatting of keywords in the "Module attributes" section. Perhaps these errors were left over from an automatic translation to ReST from some other format as part of the transition to using Sphinx for Haddock documentation? Also, add a missing reference here; it just said "See ?"! - update footnote about special treatment for re-exporting partially imported modules not being implemented. In my tests it's not implemented at all -- I tried re-exporting both `import B hiding (f)` and `import B (a, b)` style partial imports, and in both cases got the same result as with full imports `import B`: I only get a module reference. * Rework the `Controlling the documentation structure` section. My main goal was to better explain how to use Haddock without an export list, since that's my most common use case, but I hope I improved the section overall: - remove the incomplete `Omitting the export list` section and fold it into the other sections. In particular, summarize the differences between using and not using an export list -- i.e. control over what and in what order is documented -- in the section lead. - add "realistic" examples that use the structure markup, both with and without an export list. I wanted a realistic example here to capture how it can be useful to explain the relationship between a group of functions in a section, in addition to documenting their individual APIs. - make it clear that you can associate documentation chunks with documentation sections when you aren't using an export list, and that doing it in the most obvious way -- i.e. with `-- |`, as you can in the export list -- doesn't work without an export list. It took me a while to figure this out the first time, since the docs didn't explain it at all before. - add a "no export list" example to the section header section. - add more cross references. * Add examples of gotchas for markup in `@...@`. I'm not sure this will help anyone, since I think most people first learn about `@...@` by reading other people's Haddocks, but I've documented the mistakes which I've made and then gotten confused by. * Use consistent Capitalization of Titles. Some titles were in usual title caps, and others only had the first word capitalized. I chose making them all use title caps because that seems to make the cross references look better.
* Add $ as a special characterOmari Norman2016-06-291-1/+1
| | | | | | | | If this character is not escaped, documentation built with Haddock 2.17.2 will fail. This was not an issue with 2.16 series, which causes builds to fail and there is nothing in the docs or error message giving a clue about why builds that used to succeed now don't.
* Fix math typo and add link.Dominic Steinitz2016-06-091-2/+2
|
* Camel case MathJax.Dominic Steinitz2016-06-091-1/+1
|
* Fix spelling mistake.Dominic Steinitz2016-06-091-1/+1
|
* Documentation for LaTeX markup.Dominic Steinitz2016-06-091-0/+15
|
* remove framed view of the HTML documentation (see #114 and #274)Sebastian Meric de Bellefon2016-05-241-6/+2
| | | | | Frames are a bit broken, ignored by Hackage, and considered obsolete in general. This patch disables frames generation. The mini_*.html files are still used in the synopsis.
* doc: Use whichever theme sphinx deems appropriateBen Gamari2016-05-161-1/+0
|
* Revert "doc: Vendorize alabaster Sphinx theme"Ben Gamari2016-05-162-1/+0
| | | | | | | This ended up causes far too many issues to be worthwhile. We'll just have to live with inconsistent haddock documentation. This reverts commit cec21957001143794e71bcd9420283df18e7de40.
* doc: Vendorize alabaster Sphinx themeBen Gamari2016-05-162-0/+1
| | | | | | Alabaster is now the default sphinx theme and is a significant improvement over the previous default that it's worthproviding it when unavailable (e.g. Sphinx <1.3).
* doc: Use `$(MAKE)` instead of `make`Ben Gamari2016-05-141-1/+1
| | | | This is necessary to ensure we use gmake.
* doc: Fix GHC clean ruleBen Gamari2016-05-121-1/+1
| | | | Apparently GHC's build system doesn't permit wildcards in clean paths.
* doc: Add html as an all-target for ghcBen Gamari2016-05-111-2/+2
| | | | Otherwise the html documentation won't be installed for binary-dist.
* doc: Add clean targetsBen Gamari2016-05-111-0/+2
|
* doc: At long last fix ghc.mkBen Gamari2016-05-011-2/+2
| | | | | | | The variable reference was incorrectly escaped, meaning that Sphinx documentation was never installed. (cherry picked from commit 609018dd09c4ffe27f9248b2d8b50f6196cd42b9)
* doc: Fix option referencesBen Gamari2016-04-101-7/+8
| | | | (cherry picked from commit f915fb3c74328fb994235bbbd42092a691539197)
* doc: Only install if BUILD_SPHINX_HTML==YESBen Gamari2016-04-101-0/+2
| | | | | | Fixes GHC #11818. (cherry picked from commit c6d6a18d85e5e2d9bb5904e6919e8a8d7e31c4c5)
* Document --use-unicode flagBen Gamari2016-02-081-0/+4
|
* doc: Switch to SphinxBen Gamari2016-02-0815-2721/+1613
|
* Make some version changes after 2.16.1 releaseMateusz Kowalczyk2015-07-221-1/+1
|
* Fix incorrect specification of source style option in doc file.Łukasz Hanuszczak2015-07-041-2/+2
|
* Update docs on using `--read-interface` option.Łukasz Hanuszczak2015-07-041-7/+29
|
* Update docs with information about source hyperlinking.Łukasz Hanuszczak2015-07-041-0/+37
|
* Update some meta data at the top of the docsMateusz Kowalczyk2015-06-031-2/+11
|
* Update docs with info on new list nesting ruleMateusz Kowalczyk2015-06-031-0/+11
| | | | Fixes #278 through commits from PR #401
* Turn the README into GitHub Markdown format.Njagi Mwaniki2014-12-291-7/+6
| | | | Closes #354
* Update docs for @sinceMateusz Kowalczyk2014-12-181-0/+34
|
* Fix parsing of identifiers written in infix wayMateusz Kowalczyk2014-11-041-1/+3
|
* Allow an optional colon after the closing bracket of definition listsSimon Hengel2014-11-031-9/+4
| | | | | This is to disambiguate them from markdown links and will be require with a future release.
* Add support for markdown imagesSimon Hengel2014-11-031-8/+11
|
* Update documentationSimon Hengel2014-11-031-12/+32
|
* Experimental support for collapsable headersMateusz Kowalczyk2014-10-291-2/+21
| | | | Closes #335
* Mention --print-missing-docsMateusz Kowalczyk2014-09-041-0/+12
|
* Make the doc parser not complainMateusz Kowalczyk2014-08-311-1/+9
|
* Bump version in docMateusz Kowalczyk2014-08-311-1/+1
|
* Bump down the version for master to 2.14.4Mateusz Kowalczyk2014-08-141-1/+1
|
* Fix anchors. Closes #308.Mateusz Kowalczyk2014-06-251-2/+5
|