On Thu, 2008-11-20 at 11:03 +0000, Duncan Coutts wrote: > On Wed, 2008-11-19 at 10:28 +0100, Wolfgang Jeltsch wrote:
> > > The cabal user guide lists the default install directories for global > > > and user installs. > > > > Okay, I looked at the cabal-install docs. And the only doc seems to be the > > output of cabal with the --help option. > > Pretty much all the stuff in the Cabal user guide applies to the cabal > command line tool. There is some extra stuff in the cabal command line > tool that is not yet adequately documented (ie only in --help). By the way I should note that we would very much appreciate anyone who wants to help us improve the documentation. There is some documentation around (the user guide is quite extensive) but it does not seem to be well organised or easy to find. Similarly there are several sources that are not really intended for end-users (like the cabal-install page on the dev wiki) that are top hits on google. So clearly we need to do a better job with organising. With cabal-install we've been moving from a phase where it was under heavy development and only just usable to the point where it's nearly the tool of choice in its niche, so documentation and ease of installation, error messages are now more important than they were previously. We could really do with some help on these things as the number of people actually spending time hacking on these projects is quite small given the number of users and their (justified) demands for better docs, better defaults, ease of use, etc. Duncan _______________________________________________ Haskell-Cafe mailing list Haskell-Cafe@haskell.org http://www.haskell.org/mailman/listinfo/haskell-cafe
