Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 126588 - ghc has no man page
Summary: ghc has no man page
Status: RESOLVED UPSTREAM
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: Current packages (show other bugs)
Hardware: x86 Linux
: High trivial (vote)
Assignee: Gentoo's Haskell Language team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2006-03-17 13:38 UTC by Rafael Almeida
Modified: 2006-03-19 06:44 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Rafael Almeida 2006-03-17 13:38:20 UTC
Hi, 

I'm not sure if this should be considered a bug, a new feature request or none of the before. But when I install ghc without the doc useflag (haven't try with it on because it requires me to install a few packages I don't care about installing) it doesn't come with a man page. I find it very annoying, as I think every binary in my system (or at least as most as possible) should have a manpage describing its use. I whish you consider having the manual installed even without any other docs. 

Thank you for your attention.
Comment 1 Duncan Coutts (RETIRED) gentoo-dev 2006-03-17 17:11:39 UTC
It's true that ghc does not come with a man page. I agree that it might be nice. However it's not out policy to add these kinds of things if upstream do not provide them.

If you want to get a man page for ghc, I suggest that you propose it to the ghc developers. If you were to find a way of generating the man page from the existing docbook manual then it shouldn't be any more work to maintain and I'm sure they would be happy to add that.

The bits that one might want in a man page would come from this section in the manual:

http://www.haskell.org/ghc/docs/latest/html/users_guide/using-ghc.html

Or you might just want the flag reference:

http://www.haskell.org/ghc/docs/latest/html/users_guide/flag-reference.html

There are various tools available to convert docbook to man pages. For example:
http://docbook2x.sourceforge.net
docbook2X is already in portage.

I'm closing this bug and marking it as an upstream issue.
Comment 2 Rafael Almeida 2006-03-18 14:18:02 UTC
I've asked the ghc developers about this. I'm not sure if I should have re-opnened this bug report, anyhow you can see the answer here: http://hackage.haskell.org/trac/ghc/ticket/730

I think that's the manpage used on debian. It'd be good if you could add it to gentoo or something. I hope I'm being helpful.
Comment 3 Duncan Coutts (RETIRED) gentoo-dev 2006-03-19 06:44:48 UTC
Thanks Rafael, that's fine.

Hopefully they'll add that upstream.