[commit: ghc] master: Make it easy to get hyperlinked sources (3dac53f)

[git at git.haskell.org]

Repository : ssh://git@git.haskell.org/ghc

On branch  : master
Link       : http://ghc.haskell.org/trac/ghc/changeset/3dac53fa3ede70e86ddb6f40e1e96feb61301754/ghc

>---------------------------------------------------------------

commit 3dac53fa3ede70e86ddb6f40e1e96feb61301754
Author: Bartosz Nitka <niteria at gmail.com>
Date:   Mon Apr 18 06:29:37 2016 -0700

    Make it easy to get hyperlinked sources
    
    The version of `haddock` that ghc has as a submodule has an option
    for generating linkified sources. I don't think it hurts to have this
    and they are great for exploring the codebase.
    
    I'd be nice if harbormaster or travis published them somewhere, but
    I don't know how to do that yet.
    
    Test Plan:
    uncomment, run `make` and look at the
    nicely linkified sources in `compiler/stage2/doc/html/ghc/`
    
    Reviewers: hvr, austin, bgamari
    
    Reviewed By: bgamari
    
    Subscribers: thomie, simonmar
    
    Differential Revision: https://phabricator.haskell.org/D2119


>---------------------------------------------------------------

3dac53fa3ede70e86ddb6f40e1e96feb61301754
 mk/build.mk.sample | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/mk/build.mk.sample b/mk/build.mk.sample
index 196becb..eed749c 100644
--- a/mk/build.mk.sample
+++ b/mk/build.mk.sample
@@ -86,5 +86,9 @@ endif
 # (other sometimes useful configure-options: `--with-gmp-{includes,libraries}`)
 #libraries/integer-gmp_CONFIGURE_OPTS += --configure-option=--with-intree-gmp
 
+# Enable pretty hyperlinked sources
+#HADDOCK_DOCS = YES
+#EXTRA_HADDOCK_OPTS += --hyperlinked-source
+
 # Don't strip debug and other unneeded symbols from libraries and executables.
 STRIP_CMD = :