[darcs-users] Darcs utterly melts my brain: why PatchInfoAnd?

[Florent Becker]

Eric Kow a écrit :
> On Wed, Oct 01, 2008 at 10:28:02 +0200, Florent Becker wrote:
>   
>> This yields a question: do we want the C(x y) to appear in the
>> api-doc. They don't appear in the automatically-generated parts of the
>> html, but they do appear in the code, so there has to be a discrepancy
>> somewhere.
>>     
>
> Hmm, I think this may not be the best place to put the contexts:
> the
>
>   'function' @arg1 arg2@ does foo
>
> comments tell us what happens when we pass particular objects (err,
> what's the right word to use here?) to functions.  Putting type
> arguments in there is bound to confuse somebody, me at least ;-)
>
>   'function' @arg1 String arg2@ does foo
>
>   
I was documenting a type application, so it _is_ code you would find in
the source.
I wrote 'Hopefully p C(x y)' is equivalent to 'Either String (p C(x
y))'. (or did I do a typo and put Cs in a function?)