improving commandline documentation/help

2014-10-30 Thread lennart spitzner
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)

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?

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


Lennart

___
cabal-devel mailing list
cabal-devel@haskell.org
http://www.haskell.org/mailman/listinfo/cabal-devel


Re: improving commandline documentation/help

2014-10-30 Thread Mikhail Glushenkov
Hi,

On 30 October 2014 16:22, lennart spitzner l...@informatik.uni-kiel.de 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.
___
cabal-devel mailing list
cabal-devel@haskell.org
http://www.haskell.org/mailman/listinfo/cabal-devel