[plt-scheme] Are there any obstacles to a single form that combines define and provide/doc?
On Fri, Jun 26, 2009 at 11:49 AM, Noel Welsh<noelwelsh at gmail.com> wrote:
> On Fri, Jun 26, 2009 at 2:57 AM, Grant Rettke<grettke at acm.org> wrote:
>> Are there any obstacles to a single form that combines define and provide/doc?
>
> I don't think so. There is, for example, a define/provide-test-suite
> function in SchemeUnit which is a straightforward macro.
> define/provide-doc should be analogous.
>
> But does anyone use provide/doc? I thought in-code documentation was
> in the long term plan, not the short term reality. I could be wrong!
>
After reading the scribble docs I got the impression this would be the
best way to go if you want to use your contracts for documentation.
Given you should document your programs and contracts only makes your
programs better, provide/doc should be used as much as possible... :)
> N.
> _________________________________________________
> For list-related administrative tasks:
> http://list.cs.brown.edu/mailman/listinfo/plt-scheme
>
--
Paulo Jorge Matos - pocmatos at gmail.com
http://www.pmatos.net