From 2ad18d112c2b028dd5721fe67b98d8f86183c09c Mon Sep 17 00:00:00 2001 From: Sean Whitton Date: Thu, 10 Mar 2022 18:55:56 -0700 Subject: code style: use SETQ over SETF & two text formatting requirements Signed-off-by: Sean Whitton --- CONTRIBUTING.rst | 9 +++++++++ 1 file changed, 9 insertions(+) (limited to 'CONTRIBUTING.rst') diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index f9a888d..27d7ed4 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -66,6 +66,15 @@ Code style - Choose judiciously between a functional programming style and LOOP. Err on the side of LOOP. +- Use SETQ not SETF whenever SETQ works. + +- Separate sentences with two spaces after the period. In recent Emacs there + is ``M-x repunctuate-sentences`` to help with this. + +- In docstrings, comments and commit messages, refer to symbols and Lisp + packages -- though not ASDF systems -- in BLOCK CAPITALS, without any + quotation marks. + - Avoid complicating property definitions to include updates to file ownership, and the like, when it's possible instead to switch to the target user and apply a simpler version of the property. For example, instead of -- cgit v1.2.3