I’m starting to work on the manual of CHICKEN Scheme’s upcoming major release.
Do you have anything you would love to see in a manual or tutorial introduction? Any input in welcome!
(boost if you want to help a cool open-source project 😇)
One thing that has me cringing, with every language, is the setup
I love when Emacs can really autocomplete, find references, maybe even rename all the references to a function you are renaming
That was hard with clojure, brutally hard with clojurescript, quite hard with Guile Scheme and I was never brave enough to explore the issue in Common Lisp
@catonano I was planning on putting a simple emacs setup at the beginning of the tutorial, so you just confirm that it’s needed, thanks!
I don’t really know about the whole renaming thing you’re talking about, I will look into it a bit, but it seems difficult, as your identifiers might be used in many places the editor is not aware of, and that’s not even counting identifier renaming and namespacing…
A debugger has been added recently, but I don’t think there’s emacs support yet.
@luksamuk It’s pretty straightforward, but requires some knowledge of C (I guess that’s to be expected for any language embedding). You can define Scheme functions that are callable from C with define-external, you can call C functions from Scheme with the FFI… Some complexity arises when you have to deal with multiple OS threads though.
Here are the most relevant pieces of doc:
@Kooda Something I love from Rust's book is that it starts out with instructions to set up a fully-functional, but small, interactive program: https://doc.rust-lang.org/nightly/book/second-edition/ch02-00-guessing-game-tutorial.html
It's a nice attention grabber and can start someone jumping into the manual to check neat stuff out.