emacs and scheme talk to each other https://jao.io/cgit/geiser/atom?h=0.33 2024-07-06T15:37:23Z 2024-07-06T15:37:23Z Jonas Bernoulli jonas@bernoul.li 2022-07-14T12:33:38Z urn:sha1:de52f0e36f1709181c1ce4e787d79208fa2cb870 - In the summary line, use three dashes to separate the file name from the summary. That is the convention, which some tools depend on, and for some libraries we already did it here too. - Capitalize the first word in the summary. That is the convention, and for some libraries we already did it here too. - For libraries that have a commentary, make sure it is placed in a "Commentary:" section. - Make sure the "Code:" heading, which separates the header from the code part of the library, exists in all files. 2023-12-15T21:33:58Z Jonas Bernoulli jonas@bernoul.li 2023-12-15T21:29:45Z urn:sha1:b20dd4d77b92197d88d7cf3512fe202581d5c430 Emacs 30.0.50 has started to warn when this variable isn't set, presumably so that the default can be changed from nil to t in a few years. I see no reason not to use lexical-binding. 2020-03-27T20:38:45Z Jonas Bernoulli jonas@bernoul.li 2020-02-25T13:32:18Z urn:sha1:3ceb31b71824e59e3f000edf7cb09ab86616d723 It's the convention and by following it we make a big step towards supporting outline navigation. The convention doesn't say much about what parts of the code are supposed to be part of that sections and what parts belong in a subsequent section. Here we put the `require' forms in this section and maybe some setup code, that's a popular approach. In most cases there was "" where we now insert "Code:". They both serve a similar purpose and we keep the former because some users depend on that for navigation. We even add this "" in libraries where it previously was missing. In some cases the permission statement was followed by a commentary, which obviously does not belong in the "Code:" section. In such cases add the conventional "Commentary:" section. 2012-10-11T02:17:35Z Jose Antonio Ortega Ruiz jao@gnu.org 2012-10-11T02:17:35Z urn:sha1:b8630ca33b9abbcc5b39163d1df9180a66f1f998 2012-09-29T23:48:31Z Jose Antonio Ortega Ruiz jao@gnu.org 2012-09-29T23:48:31Z urn:sha1:1c105ac47a5e28eb36c6507cbe421f15bf2ded2b 2010-10-31T14:08:50Z Jose Antonio Ortega Ruiz jao@gnu.org 2010-10-31T14:08:50Z urn:sha1:55c0dc91f8410fbc96c766fde3b5e43c3b2b00f7