improving commandline documentation/help

Mikhail Glushenkov the.dead.shall.rise at
Thu Oct 30 15:38:54 UTC 2014


On 30 October 2014 16:22, lennart spitzner <lsp at> wrote:
> hello cabal devs,
> i am willing to put a bit of time into improving the help texts of
> cabal-install. some questions:
> 1) nobody else is working on this, right? is there risk that it
> interferes with other's work? (i'd basically touch
> Distribution.Simple.Command and the different fooCommand's in both
> Setup.hs's)

Not to my knowledge.

> 2) is there a specific reason that the help texts currently are so
> short, other than lack of time/focus on functionality? pending large
> changes or smth?

Not really, feel free to go ahead and improve things.

> 3) is there a policy to keep commits touching Cabal and cabal-install
> subdirectories separate (for git-subtree purposes, for example)?

No, and I think it's better to change both in lockstep so that there
are no broken revisions in history.

More information about the cabal-devel mailing list