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

Eric Kow kowey at darcs.net
Wed Oct 1 09:06:51 UTC 2008


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

-- 
Eric Kow <http://www.nltg.brighton.ac.uk/home/Eric.Kow>
PGP Key ID: 08AC04F9
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
Url : http://lists.osuosl.org/pipermail/darcs-users/attachments/20081001/566b8317/attachment.pgp 


More information about the darcs-users mailing list