Documentation targets are not working

None of the documentation targets mentioned in the Wiki work: https://ghc.haskell.org/trac/ghc/wiki/Building/StandardTargets#DocumentationTargets

As far as I can see there's no mention of how to build documentation in the entire wiki.

Trac metadata

Trac field	Value
Version
Type	Task
TypeOfFailure	OtherFailure
Priority	normal
Resolution	Unresolved
Component	Documentation
Test case
Differential revisions
BlockedBy
Related
Blocking
CC
Operating system
Architecture

changed weight to 5

added Ttask Trac import documentation labels

changed title from make targets for documentation not working to [build system] Documentation targets are not working

changed title from [build system] Documentation targets are not working to Documentation targets are not working

Trac metadata

Trac field	Value
Type	Task → Bug
Component	Documentation → Build System

added Tbug label and removed Ttask documentation labels

Actually, things are strictly speaking working as they always have: the html rule only works when one of BUILD_SPHINX_HTML or BUILD_SPHINX_PDF is set. Presumably your BuildFlavour has disabled these?

While we could in principle fix this (just teach ghc.mk to unconditionally add the documentation directories to BUILD_DIRS and fix whatever breakage this causes), I'm not sure it's worth the effort given that Hadrian will soon be the norm.

Perhaps updating the wiki in the meantime would be a reasonable compromise.

The new Hadrian build system has been merged. Relabeling the tickets concerning the legacy make build system to prevent confusion.

Trac metadata

Trac field	Value
Component	Build System → Build System (make)

added Ttask documentation labels

added Pnormal label