Michael J Forster writes: > On Thu, Dec 15, 2005 at 10:21:26AM -0600, Joshua Stone wrote: > > On Dec 15, 2005, at 3:52 AM, Tim Cross wrote: > > > > > One of the most difficult problems I've encountered with lisp is in > > > finding the appropriate function for doing some task. Many times I've > > > looked for some functionality which I knew was likely to exist, but > > > couldn't find the appropriate function. Some of this was due to not > > > being familiar with lisp nameing conventions/style and part of it is > > > due to the large number of functions available in CL. While the > > > hyperspec is great once you know what your looking for, its not so > > > good when you have an idea or know the general area, but not the > > > name. I've often ended up re-inventing the wheel only to stumble > > > across a built in function that does the same job. While this can be a > > > good way to learn, it really slows down your development time and that > > > can be somewhat discouraging at times. > > > > So are you suggesting something like an "idiomatic dictionary" for > > Common Lisp? I.e., we all probably implemented a "sum" function before > > we 'discovered' #'reduce, right (on a side-note, everyone always > > complains about the semantic inaccessibility of CL function names, but > > compare "reduce" to Ruby's "inject" -- crazy, huh?)? I like this idea, > > if only because it seems to me that PCL is just about the only truly > > practical approach to "how to do stuff" in Lisp (I'm sure I'm wrong, so > > feel free to correct me -- I won't be surprised). > > [snip] > I think the the Common Lisp Cookbook [1] addresses this to some > extent at least. Rather than duplicate that work, could we combine > our efforts? Would the Cookbook and Gardeners admins be interested > in integrating the sites and documentation? I'll say it again: > one site, one look and feel, one navigation, one set of standards. >
to some extent, the CL cookbook does address some of the problems with identifying what functionality is available in the CL libraries and provides some clear examples of how to use that functionality. What I'd like to see is a reference which has brief chapters dealing with common tasks, but rather than providing lots of examples, provides more of a roadmap - rather than a cookbook, possibly something more like CL in a Nutshell - brief and concise with pointers to more in-depth information, like the hyperspec and cl-cookbook, but which is restricted to the standard CL functions and not dependent on add-on packages. Essentially, something which can narrow the search space when you are looking for details of what support is available for what you want to do. Tim _______________________________________________ Gardeners mailing list [email protected] http://www.lispniks.com/mailman/listinfo/gardeners
