[darcs-users] darcs patch: Partially resolve issue1376: merge darcsman.hs into da...
Trent W. Buck
trentbuck at gmail.com
Sat Mar 7 10:27:40 UTC 2009
Simon Michael <simon at joyful.com> writes:
> Thanks Trent, here's some quick review. Background:
> http://bugs.darcs.net/issue1376 says
> "Currently the manual and manpage are treated as second-class citizens
> because they have not kept up with the cabal transition (my fault).
> This needs to be the top priority of the documentation team (i.e. me);
> otherwise documentation will continue to fall further behind.
> The first step is to merge darcsman.hs into the main Darcs binary,
> such that cabal can build dist/build/darcs/darcs and then just run it
> "dist/build/darcs/darcs help manual >darcs.1" at the end of "cabal
> build" and prior to "cabal install". Once this is done, we can worry
> about the full LaTeX manual (which is harder, because the
> auto-generated parts are occur throughout .lhs and .tex files.)"
> I'm sympathetic to building things right into the darcs binary when it
> eases building, deployment, and is not unuseful for users. Eg I'd like
> to build in some form of test runner. Your change indeed looks simple
> and should do what you want. I'm in favour of things that work for now
> even if not perfect.
> I'm uncomfortable with "darcs help manual" though because it's
> strictly to make cabal packaging easier
Agreed, but I'm not in a position to make changes to cabal.
> [...] Or make it a secret packager's command, though I don't like
> secret commands either.
Currently the command is undocumented...
More information about the darcs-users