Re: Commenting Code (Was: Re: Clojure as a First Language)

2009-08-11 Thread Baishampayan Ghose
> As for the coding style, we are not maniacs, later we intend to run the > code in a formater to standardize. > We use LISP style naming conventions (hyphens in names, +constant+. > *global-var*,...) While we are at it, I would like to know if there are any Clojure/Lisp formatter which re-indent

Re: Commenting Code (Was: Re: Clojure as a First Language)

2009-08-10 Thread Luc Prefontaine
It's along the lines that we follow. Declaring the public functions first however forces you to use a declare statement for all the private functions used by your public API. We use section comments to split the module (constants, global defs, private functions, public ones, ...) and keep the publ

Re: Commenting Code (Was: Re: Clojure as a First Language)

2009-08-10 Thread John Harrop
On Sun, Aug 9, 2009 at 12:47 PM, Lauri Pesonen wrote: > > 2009/8/8 Luc Prefontaine : > > > I totally agree no comments is not good at all but JavaDoc style comments > in > > Clojure ? I pray you all, please stay away of it : > > I was quite taken by this scheme style guide recently: > > http:

Commenting Code (Was: Re: Clojure as a First Language)

2009-08-09 Thread Lauri Pesonen
2009/8/8 Luc Prefontaine : > I totally agree no comments is not good at all but JavaDoc style comments in > Clojure ? I pray you all, please stay away of it : I was quite taken by this scheme style guide recently: http://mumble.net/~campbell/scheme/style.txt While I don't agree with all th