summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--lispref/tips.texi10
1 files changed, 10 insertions, 0 deletions
diff --git a/lispref/tips.texi b/lispref/tips.texi
index 1e50f672d1d..f6e240c9c41 100644
--- a/lispref/tips.texi
+++ b/lispref/tips.texi
@@ -74,6 +74,16 @@ If you define a major mode, make sure to run a hook variable using
@code{run-hooks}, just as the existing major modes do. @xref{Hooks}.
@item
+If the purpose of a function is to tell you whether a certain condition
+is true or false, give the function a name that ends in @samp{p}. If
+the name is one word, add just @samp{p}; if the name is multiple words,
+add @samp{-p}. Examples are @code{framep} and @code{frame-live-p}.
+
+@item
+If a user option variable records a true-or-false condition, give it a
+name that ends in @samp{-flag}.
+
+@item
Please do not define @kbd{C-c @var{letter}} as a key in your major
modes. These sequences are reserved for users; they are the
@strong{only} sequences reserved for users, so we cannot do without