[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/compat 015fbedf4b 3/4: Do not omit the prefix when docu
From: |
ELPA Syncer |
Subject: |
[elpa] externals/compat 015fbedf4b 3/4: Do not omit the prefix when documenting a prefixed symbol |
Date: |
Fri, 8 Apr 2022 16:57:31 -0400 (EDT) |
branch: externals/compat
commit 015fbedf4be46f4a7cb42115ddb96c40d5f1616b
Author: Jonas Bernoulli <jonas@bernoul.li>
Commit: Philip Kaludercic <philipk@posteo.net>
Do not omit the prefix when documenting a prefixed symbol
Implemented functions and variables appear in the respective indices
exactly as written. If we do not prefix these symbols then the risk
is very high that someone will look at the index and see that some
function is defined in this package and start to use it, when in
actuality it is only the prefixed symbol that is defined here.
---
MANUAL | 46 +++++++++++++++++++++++-----------------------
compat.texi | 46 +++++++++++++++++++++++-----------------------
2 files changed, 46 insertions(+), 46 deletions(-)
diff --git a/MANUAL b/MANUAL
index 77f12458e5..10405e7437 100644
--- a/MANUAL
+++ b/MANUAL
@@ -132,15 +132,15 @@ provided by Compat by default:
These functions are prefixed with ~compat~ prefix, and are only loaded
when ~compat-24~ is required:
-- Function: = ::
-- Function: < ::
-- Function: > ::
-- Function: <= ::
-- Function: >= ::
+- Function: compat-= ::
+- Function: compat-< ::
+- Function: compat-> ::
+- Function: compat-<= ::
+- Function: compat->= ::
See [[info:elisp#Comparison of Numbers][(elisp) Comparison of Numbers]].
Allows for more than two arguments to be compared.
-- Function: split-string :: See [[info:elisp#Creating Strings][(elisp)
Creating Strings]].
+- Function: compat-split-string :: See [[info:elisp#Creating Strings][(elisp)
Creating Strings]].
Takes optional argument TRIM.
@@ -186,7 +186,7 @@ provided by Compat by default:
These functions are prefixed with ~compat~ prefix, and are only loaded
when ~compat-25~ is required:
-- Function: sort :: See [[info:elisp#Sequence Functions][(elisp) Sequence
Functions]].
+- Function: compat-sort :: See [[info:elisp#Sequence Functions][(elisp)
Sequence Functions]].
Adds support for vectors to be sorted, next to just lists.
@@ -232,13 +232,13 @@ provided by Compat by default:
These functions are prefixed with ~compat~ prefix, and are only loaded
when ~compat-26~ is required:
-- Function: assoc :: See [[info:elisp#Association Lists][(elisp) Association
Lists]].
+- Function: compat-assoc :: See [[info:elisp#Association Lists][(elisp)
Association Lists]].
Handle the optional argument TESTFN.
-- Function: line-number-at-pos :: See [[info:elisp#Text Lines][(elisp) Text
Lines]].
+- Function: compat-line-number-at-pos :: See [[info:elisp#Text Lines][(elisp)
Text Lines]].
Handle the optional argument ABSOLUTE.
-- Function: alist-get :: See [[info:elisp#Association Lists][(elisp)
Association Lists]].
+- Function: compat-alist-get :: See [[info:elisp#Association Lists][(elisp)
Association Lists]].
Handle the optional argument TESTFN.
@@ -292,22 +292,22 @@ provided by Compat by default:
These functions are prefixed with ~compat~ prefix, and are only loaded
when ~compat-27~ is required:
-- Function: recenter :: See [[info:elisp#Textual Scrolling][(elisp) Textual
Scrolling]].
+- Function: compat-recenter :: See [[info:elisp#Textual Scrolling][(elisp)
Textual Scrolling]].
Adds the optional argument REDISPLAY.
-- Function: lookup-key :: See [[info:elisp#Low-Level Key Binding][(elisp)
Low-Level Key Binding]].
+- Function: compat-lookup-key :: See [[info:elisp#Low-Level Key
Binding][(elisp) Low-Level Key Binding]].
Allows KEYMAP to be a list of keymaps.
-- Macro: setq-local :: See [[info:elisp#Creating Buffer-Local][(elisp)
Creating Buffer-Local]].
+- Macro: compat-setq-local :: See [[info:elisp#Creating Buffer-Local][(elisp)
Creating Buffer-Local]].
Allow for more than one variable to be set.
-- Function: regexp-opt :: See [[info:elisp#Regexp Functions][(elisp) Regexp
Functions]].
+- Function: compat-regexp-opt :: See [[info:elisp#Regexp Functions][(elisp)
Regexp Functions]].
Handle an empty list of strings.
-- Function: file-size-human-readable :: Defined in ~files.el~.
+- Function: compat-file-size-human-readable :: Defined in ~files.el~.
Handle the optional third (SPACE) and forth (UNIT) arguments.
-- Function: assoc-delete-all :: See [[info:elisp#Association Lists][(elisp)
Association Lists]].
+- Function: compat-assoc-delete-all :: See [[info:elisp#Association
Lists][(elisp) Association Lists]].
Handle the optional third (TESTFN) argument.
@@ -377,27 +377,27 @@ provided by Compat by default:
These functions are prefixed with ~compat~ prefix, and are only loaded
when ~compat-28~ is required:
-- Function: unlock-buffer :: See [[info:elisp#File Locks][(elisp) File Locks]].
+- Function: compat-unlock-buffer :: See [[info:elisp#File Locks][(elisp) File
Locks]].
Handle ~file-error~ conditions.
-- Function: string-width :: See [[info:elisp#Size of Displayed Text][(elisp)
Size of Displayed Text]].
+- Function: compat-string-width :: See [[info:elisp#Size of Displayed
Text][(elisp) Size of Displayed Text]].
Handle optional arguments FROM and TO.
-- Function: json-serialize :: See [[info:elisp#Parsing JSON][(elisp) Parsing
JSON]].
+- Function: compat-json-serialize :: See [[info:elisp#Parsing JSON][(elisp)
Parsing JSON]].
Handle primitive, top-level JSON values.
-- Function: json-insert :: See [[info:elisp#Parsing JSON][(elisp) Parsing
JSON]].
+- Function: compat-json-insert :: See [[info:elisp#Parsing JSON][(elisp)
Parsing JSON]].
Handle primitive, top-level JSON values.
-- Function: json-parse-string :: See [[info:elisp#Parsing JSON][(elisp)
Parsing JSON]].
+- Function: compat-json-parse-string :: See [[info:elisp#Parsing JSON][(elisp)
Parsing JSON]].
Handle primitive, top-level JSON values.
-- Function: json-parse-buffer :: See [[info:elisp#Parsing JSON][(elisp)
Parsing JSON]].
+- Function: compat-json-parse-buffer :: See [[info:elisp#Parsing JSON][(elisp)
Parsing JSON]].
Handle primitive, top-level JSON values.
-- Function: count-windows :: Defined in ~window.el~.
+- Function: compat-count-windows :: Defined in ~window.el~.
Handle optional argument ALL-FRAMES.
diff --git a/compat.texi b/compat.texi
index 40b869295e..6db3add847 100644
--- a/compat.texi
+++ b/compat.texi
@@ -297,21 +297,21 @@ See @ref{Defining Faces,(elisp) Defining Faces,,elisp,}.
These functions are prefixed with @code{compat} prefix, and are only loaded
when @code{compat-24} is required:
-@defun =
+@defun compat-=
@end defun
-@defun <
+@defun compat-<
@end defun
-@defun >
+@defun compat->
@end defun
-@defun <=
+@defun compat-<=
@end defun
-@defun >=
+@defun compat->=
See @ref{Comparison of Numbers,(elisp) Comparison of Numbers,,elisp,}.
Allows for more than two arguments to be compared.
@end defun
-@defun split-string
+@defun compat-split-string
See @ref{Creating Strings,(elisp) Creating Strings,,elisp,}.
Takes optional argument TRIM@.
@@ -419,7 +419,7 @@ See @ref{Bool-Vectors,(elisp) Bool-Vectors,,elisp,}.
These functions are prefixed with @code{compat} prefix, and are only loaded
when @code{compat-25} is required:
-@defun sort
+@defun compat-sort
See @ref{Sequence Functions,(elisp) Sequence Functions,,elisp,}.
Adds support for vectors to be sorted, next to just lists.
@@ -519,19 +519,19 @@ See @ref{Unique File Names,(elisp) Unique File
Names,,elisp,}.
These functions are prefixed with @code{compat} prefix, and are only loaded
when @code{compat-26} is required:
-@defun assoc
+@defun compat-assoc
See @ref{Association Lists,(elisp) Association Lists,,elisp,}.
Handle the optional argument TESTFN@.
@end defun
-@defun line-number-at-pos
+@defun compat-line-number-at-pos
See @ref{Text Lines,(elisp) Text Lines,,elisp,}.
Handle the optional argument ABSOLUTE@.
@end defun
-@defun alist-get
+@defun compat-alist-get
See @ref{Association Lists,(elisp) Association Lists,,elisp,}.
Handle the optional argument TESTFN@.
@@ -670,37 +670,37 @@ Defined in @code{package.el}.
These functions are prefixed with @code{compat} prefix, and are only loaded
when @code{compat-27} is required:
-@defun recenter
+@defun compat-recenter
See @ref{Textual Scrolling,(elisp) Textual Scrolling,,elisp,}.
Adds the optional argument REDISPLAY@.
@end defun
-@defun lookup-key
+@defun compat-lookup-key
See @ref{Low-Level Key Binding,(elisp) Low-Level Key Binding,,elisp,}.
Allows KEYMAP to be a list of keymaps.
@end defun
-@defmac setq-local
+@defmac compat-setq-local
See @ref{Creating Buffer-Local,(elisp) Creating Buffer-Local,,elisp,}.
Allow for more than one variable to be set.
@end defmac
-@defun regexp-opt
+@defun compat-regexp-opt
See @ref{Regexp Functions,(elisp) Regexp Functions,,elisp,}.
Handle an empty list of strings.
@end defun
-@defun file-size-human-readable
+@defun compat-file-size-human-readable
Defined in @code{files.el}.
Handle the optional third (SPACE) and forth (UNIT) arguments.
@end defun
-@defun assoc-delete-all
+@defun compat-assoc-delete-all
See @ref{Association Lists,(elisp) Association Lists,,elisp,}.
Handle the optional third (TESTFN) argument.
@@ -889,43 +889,43 @@ See @ref{Backup Names,(elisp) Backup Names,,elisp,}.
These functions are prefixed with @code{compat} prefix, and are only loaded
when @code{compat-28} is required:
-@defun unlock-buffer
+@defun compat-unlock-buffer
See @ref{File Locks,(elisp) File Locks,,elisp,}.
Handle @code{file-error} conditions.
@end defun
-@defun string-width
+@defun compat-string-width
See @ref{Size of Displayed Text,(elisp) Size of Displayed Text,,elisp,}.
Handle optional arguments FROM and TO@.
@end defun
-@defun json-serialize
+@defun compat-json-serialize
See @ref{Parsing JSON,(elisp) Parsing JSON,,elisp,}.
Handle primitive, top-level JSON values.
@end defun
-@defun json-insert
+@defun compat-json-insert
See @ref{Parsing JSON,(elisp) Parsing JSON,,elisp,}.
Handle primitive, top-level JSON values.
@end defun
-@defun json-parse-string
+@defun compat-json-parse-string
See @ref{Parsing JSON,(elisp) Parsing JSON,,elisp,}.
Handle primitive, top-level JSON values.
@end defun
-@defun json-parse-buffer
+@defun compat-json-parse-buffer
See @ref{Parsing JSON,(elisp) Parsing JSON,,elisp,}.
Handle primitive, top-level JSON values.
@end defun
-@defun count-windows
+@defun compat-count-windows
Defined in @code{window.el}.
Handle optional argument ALL-FRAMES@.