[Hackage] #783: Weird brackets in function names on Haddock page
#783: Weird brackets in function names on Haddock page --------------------------------+------------------------------------------- Reporter: guest | Owner: Type: defect | Status: new Priority: normal | Milestone: Component: hackageDB website | Version: 1.8.0.6 Severity: normal | Keywords: Difficulty: unknown | Ghcversion: Platform: | --------------------------------+------------------------------------------- Take a look at: http://hackage.haskell.org/packages/archive/harpy/0.4.3.0/doc/html/Harpy- Call.html Here the docs show very weird names such as conv[a9D8]. However, if we look at the source it has #ifndef __HADDOCK__, to make it look fine. But that's not being obeyed on Hackage, for some reason. -- Neil Mitchell -- Ticket URL: http://hackage.haskell.org/trac/hackage/ticket/783 Hackage http://haskell.org/cabal/ Hackage: Cabal and related projects
#783: Weird brackets in function names on Haddock page --------------------------------+------------------------------------------- Reporter: guest | Owner: Type: defect | Status: new Priority: normal | Milestone: Component: hackageDB website | Version: 1.8.0.6 Severity: normal | Keywords: Difficulty: unknown | Ghcversion: Platform: | --------------------------------+------------------------------------------- Comment(by isaacdupree): That's because `__HADDOCK__` is only defined for Haddock 0.x, not for the current GHC-API-based Haddock (deliberately, nothing special is defined for the current Haddock). IMHO it's a Haddock bug to say "conv[a9D8] :: something" and not give a proper name (any idea whether it's easy to fix, vs. is a design problem?). The only(?) other reason I can see for that ifdef is if you're trying to lie about the types in the haddocumentation (I don't know Harpy's use of TH well enough to be sure myself). -Isaac Dupree -- Ticket URL: http://hackage.haskell.org/trac/hackage/ticket/783#comment:1 Hackage http://haskell.org/cabal/ Hackage: Cabal and related projects
#783: Weird brackets in function names on Haddock page --------------------------------+------------------------------------------- Reporter: guest | Owner: Type: defect | Status: closed Priority: normal | Milestone: Component: hackageDB website | Version: 1.8.0.6 Severity: normal | Resolution: invalid Keywords: | Difficulty: unknown Ghcversion: | Platform: --------------------------------+------------------------------------------- Changes (by ross): * status: new => closed * resolution: => invalid Comment: That's right; the Cabal library doesn't set __HADDOCK__ for haddock-2. You'll need to try to work out something with haddock. -- Ticket URL: http://hackage.haskell.org/trac/hackage/ticket/783#comment:2 Hackage http://haskell.org/cabal/ Hackage: Cabal and related projects
#783: Weird brackets in function names on Haddock page --------------------------------+------------------------------------------- Reporter: guest | Owner: Type: defect | Status: closed Priority: normal | Milestone: Component: hackageDB website | Version: 1.8.0.6 Severity: normal | Resolution: invalid Keywords: | Difficulty: unknown Ghcversion: | Platform: --------------------------------+------------------------------------------- Comment(by elga): * [http://www.releve-identite-operateur.fr/numbero-de-virgin-mobile.html virgin mobile] -- Ticket URL: http://hackage.haskell.org/trac/hackage/ticket/783#comment:3 Hackage http://haskell.org/cabal/ Hackage: Cabal and related projects
participants (1)
-
Hackage