Discussion
Loading...

Post

Log in
  • About
  • Code of conduct
  • Privacy
  • Users
  • Instances
  • About Bonfire
Paolo Amoroso
Paolo Amoroso
@amoroso@oldbytes.space  ·  activity timestamp 7 days ago

At over a thousand pages the Common Lisp specification is a thick document but that space is worth it, especially the many welcome examples. The Common Lisp Interface Manager (CLIM) specification is about a third that long and has nearly no examples, which makes the many concepts and features harder to understand.

Examples are underrated in software documentation.

https://www.lispworks.com/documentation/HyperSpec/Front

http://bauhh.dyndns.org:8000/clim-spec/index.html

#CommonLisp #CLIM #lisp #documentation

CLIM 2 Specification — Common Lisp Interface Manager CLIM II Specification

Common Lisp HyperSpec (TM)

  • Copy link
  • Flag this post
  • Block
lispm
lispm
@symbolics@mastodon.social replied  ·  activity timestamp 7 days ago

@amoroso the Symbolics CLIM documentation has three parts: Tutorial, User's Guide and Dictionary. The older Dynamic Windows documentation has even more content, maybe twice as much.

The CL spec has examples mostly for individual functionality, but still lacks larger examples and a tutorial - that's not the role of a spec. I would for example recommend for learning CL to read something like PCL or PAIP, and use the CL Spec as a reference, plus for example the CL Cookbook or CL Recipes.

2 media
Sorry, no caption provided by author
Sorry, no caption provided by author
Sorry, no caption provided by author
Sorry, no caption provided by author
Sorry, no caption provided by author
Sorry, no caption provided by author
  • Copy link
  • Flag this comment
  • Block
Paolo Amoroso
Paolo Amoroso
@amoroso@oldbytes.space replied  ·  activity timestamp 6 days ago

@symbolics Yes, I read the Symbolics CLIM documentation and it's really helpful.

  • Copy link
  • Flag this comment
  • Block
Digital Mark λ ☕️ 🕹 👽
Digital Mark λ ☕️ 🕹 👽
@mdhughes@appdot.net replied  ·  activity timestamp 7 days ago

@amoroso The source for McClim has a ton of examples and tests which are how I got anything done in it.

  • Copy link
  • Flag this comment
  • Block
Paolo Amoroso
Paolo Amoroso
@amoroso@oldbytes.space replied  ·  activity timestamp 7 days ago

@mdhughes Right, I'm reading a lot of McCLIM example code.

  • Copy link
  • Flag this comment
  • Block

bonfire.cafe

A space for Bonfire maintainers and contributors to communicate

bonfire.cafe: About · Code of conduct · Privacy · Users · Instances
Bonfire social · 1.0.1-beta.35 no JS en
Automatic federation enabled
Log in
  • Explore
  • About
  • Members
  • Code of Conduct