Github/emacs
2
0
Fork 1
mirror of git://git.sv.gnu.org/emacs.git synced 2026-02-16 17:24:23 +00:00
Code Issues Projects Releases Packages Wiki Activity
131968 commits 244 branches 194 tags 1.4 GiB
Commit graph

2834 commits

Author SHA1 Message Date
Eli Zaretskii
fdd7e7d8a8 Improve indexing of 'eval-defun' in ELisp manual 
* doc/lispref/display.texi (Defining Faces):
* doc/lispref/debugging.texi (Explicit Debug):
* doc/lispref/customize.texi (Variable Definitions):
* doc/lispref/variables.texi (Defining Variables): Add index
entries for 'eval-defun'.  (Bug#32066)
 2018-07-07 11:37:43 +03:00
Paul Eggert
10af989024 Fix (length CIRCULAR) documentation 
* doc/lispref/sequences.texi (Sequence Functions):
Correct documentation of what (length X) does when
X is a circular list.
 2018-07-06 11:00:22 -07:00
Karl Fogel
c7848767c9 Tighten a cross-reference in documentation 
* doc/lispref/internals.texi (Writing Emacs Primitives): Switch to
  a simple parenthetical cross-reference, following up to my
  commit 9a53b6d426 of 2018-06-24.

See discussion:

  https://lists.gnu.org/archive/html/emacs-devel/2018-06/msg00826.html
  From: Eli Zaretskii
  Subject: Re: [Emacs-diffs] \
           emacs-26 9a53b6d: Say how to override a primitive interactive spec
  To: Karl Fogel
  CC: Stefan Monnier, Emacs Devel
  Date: Mon, 25 Jun 2018 17:41:53 +0300
  Message-Id: <83r2kvrkr2.fsf@gnu.org>
 2018-06-25 12:23:23 -05:00
Karl Fogel
9a53b6d426 Say how to override a primitive interactive spec 
* doc/lispref/internals.texi (Writing Emacs Primitives): Mention that
  the `interactive-form' property can be used to override a primitive
  interactive specification, and refer to the detailed documentation
  for setting that property.

From this thread on Emacs Devel:

  https://lists.gnu.org/archive/html/emacs-devel/2018-03/msg00923.html
  From: Eli Zaretskii
  To: Karl Fogel
  CC: Juri Linkov, Emacs Devel
  Subject: Re: [Emacs-diffs] \
           master b88e7c8: Make transpose-regions interactive (Bug#30343)
  Date: Thu, 29 Mar 2018 14:38:15 +0300
  Message-Id: <834lkzdsd4.fsf@gnu.org>
 2018-06-24 07:10:43 -05:00
Eli Zaretskii
decdfedf02 Clarify wording about functions' argument lists 
* doc/lispref/functions.texi (Argument List): Clarify the
wording.  (Bug#31872)
 2018-06-23 10:38:44 +03:00
Simen Heggestøyl
3d2e3dc1ca Change name of `seqp' argument (Bug#26411) 
* lisp/emacs-lisp/seq.el (seqp): Change argument name.

* doc/lispref/sequences.texi: Update the documentation for seqp.
 2018-06-21 20:27:35 -04:00
Noam Postavsky
40e1db8ccd Change index of ";" to better reflect it's usage (Bug#31623) 
* doc/lispref/objects.texi (Comments): "; for commenting" fits better
with the following text about how a semicolon begins a comment.  Also
mention that only unescaped semicolons start a comment.
 2018-06-20 08:46:13 -04:00
Eli Zaretskii
ffd20184ca Minor documentation fix 
* doc/lispref/windows.texi (Window Start and End): Improve
documentation and indexing of window-end.
 2018-06-17 11:19:59 +03:00
Eli Zaretskii
63ba73a9f2 Fix documentation of ':propertize' in mode-line-format 
* doc/lispref/modes.texi (Mode Line Data): Make the description of
':propertize' more accurate.  (Bug#26291)
 2018-06-16 14:00:47 +03:00
Eli Zaretskii
0b1a2ae84a Delete description of deleted Customize functions 
* doc/lispref/customize.texi (Variable Definitions): Remove the
description of 'custom-initialize-safe-set' and
'custom-initialize-safe-default', which were deleted in Emacs
23.2, and replace with the description of
'custom-initialize-delay'.
 2018-06-15 10:32:45 +03:00
Eli Zaretskii
9c6f35a6b2 * doc/lispref/files.texi (Unique File Names): Fix a typo. (Bug#31784) 2018-06-11 19:58:14 +03:00
Eli Zaretskii
36bbdfc017 Update Unicode data files to version 11.0.0 of Unicode 
* admin/unidata/UnicodeData.txt:
* admin/unidata/SpecialCasing.txt:
* admin/unidata/NormalizationTest.txt:
* admin/unidata/copyright.html:
* admin/unidata/BidiMirroring.txt:
* admin/unidata/BidiBrackets.txt: Import from Unicode 11.0.
* admin/notes/unicode: Update the URL for OTF script tags.

* lisp/international/mule-cmds.el (ucs-names): Update unused ranges.
* lisp/international/fontset.el (script-representative-chars): Add
hanifi-rohingya, old-sogdian, sogdian, dogra, gunjala-gondi,
makasar, and medefaidrin.
(otf-script-alist): Add old-hungarian.
* lisp/international/characters.el (tbl): Add syntax entries for
Supplemental Mathematical Operators, Miscellaneous Symbols and
Arrows, and Supplemental Punctuation.
Update the list of wide characters.

* test/lisp/international/ucs-normalize-tests.el
(ucs-normalize-tests--failing-lines-part2): Update to match
admin/unidata/NormalizationTest.txt.

* doc/lispref/nonascii.texi (Character Properties): Update the
reference to the Unicode Standard.
* doc/misc/efaq.texi (New in Emacs 26):
* etc/NEWS: Mention compatibility with Unicode 11.0.
 2018-06-09 15:41:21 +03:00
Eli Zaretskii
ef35d405b1 Clarify subtle issues with 'eq' in byte-compiled code 
* doc/lispref/objects.texi (Equality Predicates): Explain why
byte-compiled code might compare literal objects with identical
contents as 'eq'.  (Bug#31688)
 2018-06-08 18:06:34 +03:00
Eli Zaretskii
4cfe5312c8 Improve ELisp documentation of 'clone-indirect-buffer' 
* doc/lispref/buffers.texi (Indirect Buffers): Be more explicit
about the value of DISPLAY-FLAG in interactive usage.  (Bug#31648)
 2018-06-02 14:15:10 +03:00
Eli Zaretskii
6107e12f76 Improve documentation of comment styles 
* doc/lispref/syntax.texi (Syntax Flags): Define the "a" style.
(Bug#31624)
 2018-06-02 14:01:18 +03:00
Eli Zaretskii
641c94ce68 Imp[rove documentation of 'with-silent-modifications' 
* doc/lispref/buffers.texi (Buffer Modification): Document
'with-silent-modifications'.  (Bug#31613)
* doc/lispref/text.texi (Changing Properties): Add a
cross-reference to "Buffer Modification".  Improve wording.
 2018-06-02 13:27:22 +03:00
Eli Zaretskii
21f2247cf4 Merge branch 'emacs-26' of git.savannah.gnu.org:/srv/git/emacs into emacs-26 2018-06-01 17:10:46 +03:00
Ville Skyttä
6d2352594f Fix typos in several manuals (Bug#31610) 
Copyright-paperwork-exempt: yes
 2018-06-01 16:33:58 +03:00
Robert Pluim
9188291f7a Add detailed documentation about lock files 
* doc/emacs/files.texi (Interlocking): Point user at detailed
file locking description in lisp reference manual.  Add index
entry for '.#' to improve disoverability of information about locking.

* doc/lispref/files.texi (File Locks): Describe in detail what
the form of the lock file is.  Add index entry for '.#' to
improve disoverability of information about locking.

* src/filelock.c (create-lockfiles): Add cross reference to
file locking in user manual and to 'lock-buffer'.  Add string
'.#' to help users find the doc string.
 2018-06-01 15:06:20 +02:00
Eli Zaretskii
99f92dab3d Improve documentation of 'directory-files-and-attributes' 
* doc/lispref/files.texi (Contents of Directories): Fix inaccurate
description of the return value of directory-files-and-attributes.

* src/dired.c (Fdirectory_files_and_attributes): Describe the
function's value in more detail.
 2018-06-01 11:27:29 +03:00
Thien-Thi Nguyen
9d6a3ac73a Mention pcase as a fifth conditional form 
* doc/lispref/control.texi (Conditionals): ...here,
in first para, w/ xref to "Pattern-Matching Conditional".
 2018-05-27 17:15:19 +02:00
Thien-Thi Nguyen
567cb9046d Overhaul pcase documentation 
Suggested by Drew Adams (Bug#31311).

* doc/lispref/control.texi (Control Structures):
Add "Pattern-Matching Conditional" to menu, before "Iteration".
(Conditionals): Delete menu.
(Pattern matching case statement): Delete node/subsection,
by actually moving, renaming, and overhauling it to...
(Pattern-Matching Conditional): ...new node/section.
(pcase Macro): New node/subsection.
(Extending pcase): Likewise.
(Backquote Patterns): Likewise.
* doc/lispref/elisp.texi (Top) In @detailmenu, add
"Pattern-Matching Conditional" under "Control Structures"
section and delete "Conditionals" section.
* lisp/emacs-lisp/pcase.el (pcase): Rewrite docstring.
(pcase-defmacro \` (qpat) ...): Likewise.
 2018-05-27 17:14:27 +02:00
Noam Postavsky
2f44d2d5b1 Note caveat for backward regexp searching in docstring (Bug#31584) 
* src/search.c (Fre_search_backward): Emphasize that backwards
searches may give shorter than expected matches.
* doc/lispref/searching.texi (Regexp Search): Add an anchor for
re-search-backward to reference.
 2018-05-25 07:54:30 -04:00
Philipp Stephani
52ccb24aba ; * doc/os.texi (Batch Mode): use = after --eval 2018-05-22 15:33:22 +02:00
Eli Zaretskii
ef4aec14d1 ; * doc/lispref/hash.texi (Defining Hash): Fix typos. 2018-05-21 21:08:39 +03:00
Eli Zaretskii
7ddcc9ab1a Document 'custom-group' 
* doc/lispref/customize.texi (Group Definitions): Document the
'custom-group' property.
 2018-05-04 18:00:02 +03:00
Basil L. Contovounesios
343d70b10e Improve kill-related documentation (bug#31209) 
* doc/lispref/text.texi (Low-Level Kill Ring): Fix typo under
current-kill.  Mention interprogram-paste-function under kill-new
and kill-append.
* lisp/simple.el (save-interprogram-paste-before-kill, kill-new)
(kill-append-merge-undo, kill-append): Touch-up docstrings.
 2018-04-24 20:58:15 -04:00
Charles A. Roelli
6cf83131e2 * doc/lispref/display.texi (Glyphless Chars): Fix grammar. 2018-04-22 11:15:37 +02:00
Eli Zaretskii
5de608f3ed Update the documentation of 'perform-replace' 
* doc/lispref/searching.texi (Search and Replace): Update the
documentation of 'perform-replace'.
 2018-04-20 10:18:06 +03:00
Eli Zaretskii
8f6293ca78 Fix use of @key in Texinfo manuals 
* doc/misc/efaq-w32.texi (Location of init file):
* doc/misc/org.texi (Editing source code, Export settings)
(Closing items, Drawers, Structure editing):
* doc/misc/gnus.texi (Spam and Ham Processors, Terminology):
* doc/misc/calc.texi (Keypad Functions Menu, Keypad Binary Menu)
(Keypad Vectors Menu, Keypad Main Menu, Basic Arithmetic)
(Symbolic Mode):
* doc/misc/sc.texi (Electric References):
* doc/misc/info.texi (Help-^L):
* doc/misc/reftex.texi (Reference Styles):
* doc/misc/idlwave.texi (Troubleshooting, Examining Variables)
(Lesson III---User Catalog, Using the Shell):
* doc/misc/eshell.texi (Bugs and ideas):
* doc/misc/ada-mode.texi (Automatic Casing):
* doc/misc/ediff.texi (Selective Browsing):
* doc/misc/vip.texi (Customizing Constants):
* doc/misc/pcl-cvs.texi (Selected files):
* doc/misc/efaq.texi (Replying to the sender of a message)
(Basic keys, No Meta key, Matching parentheses)
(Origin of the term Emacs, Installing Texinfo documentation)
(Learning how to do something, Emacs manual, Extended commands):
* doc/misc/viper.texi (Rudimentary Changes):
* doc/misc/tramp.texi (Frequently Asked Questions):
* doc/emacs/kmacro.texi (Basic Keyboard Macro):
* doc/emacs/frames.texi (Frame Commands):
* doc/emacs/msdos.texi (Windows Keyboard):
* doc/emacs/search.texi (Query Replace):
* doc/lispintro/emacs-lisp-intro.texi (Keybindings)
(Note for Novices):
* doc/lispref/tips.texi (Key Binding Conventions): Fix use of
@key.  For the details, see
http://lists.gnu.org/archive/html/emacs-devel/2018-04/msg00390.html.
 2018-04-19 12:21:06 +03:00
Eli Zaretskii
f4c989427b Improve documentation of actual arglist 
* doc/lispref/functions.texi (Function Documentation): Advise
against using '(fn ARGLIST)' method of advertising a calling
convention when the old calling convention is deprecated.
(Bug#31191)
 2018-04-19 11:29:50 +03:00
Eli Zaretskii
ad731b0d8f ; * doc/lispref/display.texi (Temporary Displays): Fix typos. 2018-04-13 20:19:17 +03:00
Alan Mackenzie
f1450e9f34 Complete documentation of syntax flags by adding `c' 
* doc/lispref/syntax.texi ("Syntax Table Internals"): Add entry for `c'
as `(1 lsh 23)'.
 2018-04-13 14:35:13 +00:00
Eli Zaretskii
6bdcaec885 Fix typos and minor wording issues in ELisp manual 
* doc/lispref/internals.texi (Writing Emacs Primitives):
* doc/lispref/display.texi (Temporary Displays): Fix typos.
* doc/lispref/text.texi (Filling, Changing Properties)
(Transposition): Clarify and fix typos.
* doc/lispref/positions.texi (Screen Lines): Improve wording.
* doc/lispref/modes.texi (Minor Mode Conventions)
(Font Lock Multiline): Fix typos.
* doc/lispref/variables.texi (Dynamic Binding Tips): Fix a
cross-reference.  Fix a typo.
* doc/lispref/sequences.texi (Sequence Functions): Fix typos.
(Bug#31143)
 2018-04-13 16:44:05 +03:00
Eli Zaretskii
3a798f696b Fix a minor mistake in the ELisp manual 
* doc/lispref/files.texi (Reading from Files): Fix copy/paste
mistake.  (Bug#31107)
 2018-04-09 17:53:37 +03:00
Eli Zaretskii
1527235baf ; * doc/lispref/compile.texi (Compilation Functions): Fix wording. 2018-04-02 20:25:52 +03:00
Tino Calancha
b07decdf02 ; * doc/lispref/compile.texi (Compilation Functions): Fix typo 2018-04-03 00:43:25 +09:00
Eli Zaretskii
9fee1b8fb3 Minor copyedits of completion-at-point-functions documentation 
* lisp/minibuffer.el (completion-at-point-functions):
* doc/lispref/minibuf.texi (Completion in Buffers): Fix wording
and filling.

(cherry picked from commit a8ddd05d7d)
 2018-04-01 12:22:39 +03:00
Stefan Monnier
748f0fdd5a (completion-at-point-functions): Improve doc 
(cherry picked from commit b56c56f203)
 2018-04-01 12:21:29 +03:00
Noam Postavsky
e50196e8a9 Document return value of pcase (Bug#30425) 
* doc/lispref/control.texi (Pattern matching case statement):
* lisp/emacs-lisp/pcase.el (pcase): State that pcase returns nil if no
patterns match.
(pcase-exhaustive): State that an error is signaled if no patterns
match.
 2018-03-31 00:50:37 -04:00
Eli Zaretskii
930f7b10b3 * doc/lispref/functions.texi (Defining Functions): Improve indexing. 2018-03-26 18:58:20 +03:00
Glenn Morris
7d6c7d0b46 ; Use GNU not Gnu in docs 2018-03-23 16:01:12 -04:00
Noam Postavsky
10b1f2fdd5 Explain more about (defvar foo) form (Bug#18059) 
* doc/lispref/variables.texi (Defining Variables)
(Using Lexical Binding):
* doc/lispref/compile.texi (Compiler Errors): Emphasize that omitting
VALUE for `defvar' marks the variable special only locally.
* doc/lispref/variables.texi (Using Lexical Binding): Add example of
using `defvar' without VALUE.
 2018-03-23 08:19:09 -04:00
Charles A. Roelli
68c2f336b1 * doc/lispref/buffers.texi (Buffer List): Fix grammar. 2018-03-22 20:43:42 +01:00
Charles A. Roelli
7e720c6851 * doc/lispref/anti.texi (Antinews): Fix grammar. 2018-03-22 20:40:02 +01:00
Eli Zaretskii
8ac621bb55 Document DEFUN attributes 
* doc/lispref/internals.texi (Writing Emacs Primitives): Document
specification of function attributes in DEFUN.
 2018-03-22 14:57:43 +02:00
Glenn Morris
5268f3059d * doc/lispref/windows.texi (Selecting Windows): Fix a typo. 2018-03-21 16:58:11 -04:00
Charles A. Roelli
143b485029 * doc/lispref/internals.texi (Writing Emacs Primitives): Fix grammar. 2018-03-21 20:52:35 +01:00
Alan Mackenzie
4ab4551470 Firm up documentation of generalized variables 
* doc/lispref/variables.texi (Generalized Variables)
(Setting Generalized Variables): Define a generalized variable as something
setf can write to.  Remove the insinuation that hackers have poor memories.
State explicitly that the list of GVs given is complete.  Remove the
suggestion that `setf' has superseded, or is in the process of superseding,
`setq'.  Make minor corrections to the English.
 2018-03-21 17:36:34 +00:00
Nick Helm
2fb52abd9e Improve documentation of 'with-help-window' 
* doc/lispref/help.texi (Help Functions): Change variable name
to 'buffer-or-name'.

* lisp/help.el (with-help-window): Change variable name to
'buffer-or-name' and rewrite the doc string, adding reference
to 'help-window-setup'.  (Bug#30792)
 2018-03-20 14:19:14 +02:00