On 5/14/06, Juliusz Chroboczek <[EMAIL PROTECTED]> wrote:
> Sun May 7 18:30:09 CEST 2006 Eric Kow <[EMAIL PROTECTED]>
> * Tidy up comment for working dir in patch apply.
> +-- | Note: The expression (@apply flags working p@) applies the patch
> +-- to whatever directory-like monad you are in. If @working@ is
> +-- 'True', some inconsitencies such as removing a non-empty directory
> +-- are treated as warnings, not errors. When in doubt, set @working@
> +-- 'False'.
Eric, we've been through this discussion before, and I have asked that
people should not submit patches with non-TeX markup to source files.
If you disagree with this decision, let us have the discussion again.
But until we do, please do not try to sneak in markup in Haskell
comments in this way.
I see this discussion:
http://thread.gmane.org/gmane.comp.version-control.darcs.devel/3917/focus=3917
Where Zachary said he basically thought it was a good idea. I've said
I think it's a good idea, and Eric appears to be using it so I'd say
he thinks it's good idea as well. So that's three people for it.
Actually, I see Eric stated exactly how he felt about it here:
http://article.gmane.org/gmane.comp.version-control.darcs.devel/4312/match=haddock
And here Juliusz says he doesn't feel strongy, but is waiting for a consesus:
http://thread.gmane.org/gmane.comp.version-control.darcs.devel/4289/focus=4312
So, let me recap. It appears we have 3 votes for, one vote against.
Thinking that I might misunderstand 'consensus', here is the
dictionary definition:
http://dictionary.reference.com/search?q=consensus
I'd say we hit the second definition, but perhaps Juliusz means the first.
And one of the emails above said that David should know about this,
and he doesn't seem to read the list often, so I'm CC'ing him
directly. (If I've used an address that doesn't usualy reach him,
please someone forward it to the right address). David, would you
like to comment?
If anyone wants to see the output generated by haddock for reference
here are two examples. The first one is a good example of how haddock
can be comprehensive and helpful and the second one is the output of
using haddock on the darcs source tree, including the patch that was
just rejected:
http://www.haskell.org/ghc/docs/latest/html/libraries/index.html
http://projects.codersbase.com/repos/darcs-unofficial/api-doc/PatchApply.html#v%3Aapply
Thanks,
Jason
_______________________________________________
darcs-devel mailing list
[email protected]
http://www.abridgegame.org/cgi-bin/mailman/listinfo/darcs-devel
