mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-01-27 07:30:59 -08:00
Code Issues Projects Releases Wiki Activity
131996 commits 242 branches 194 tags 738 MiB
Commit graph

6554 commits

Author SHA1 Message Date
Eli Zaretskii
f4e7f6d73d Improve documentation of 'seqp' 
* doc/lispref/sequences.texi (Sequence Functions): Add text to
explain the relation between 'seqp' and 'sequencep'.  (Bug#32125)
 2018-07-14 11:18:04 +03:00
Eli Zaretskii
9b49a8ed4a Improve documentation of Flyspell 
For the background, see
http://lists.gnu.org/archive/html/help-gnu-emacs/2018-07/msg00099.html.

* doc/emacs/fixit.texi (Spelling): Add a couple of caveats.
* lisp/textmodes/flyspell.el: Update commentary.
 2018-07-12 18:59:18 +03:00
Basil L. Contovounesios
db3874b161 Refer to "proper lists" instead of "true lists" 
* doc/lispref/lists.texi (Cons Cells, Building Lists):
* doc/lispref/sequences.texi (Vector Functions): Use the more
popular term "proper", rather than "true", to qualify nil-terminated
lists.

For discussion, see the following emacs-devel subthreads:
https://lists.gnu.org/archive/html/emacs-devel/2018-06/msg00112.html
https://lists.gnu.org/archive/html/emacs-devel/2018-06/msg00138.html
 2018-07-10 19:54:31 -07:00
Michael Albinus
51bf4e4650 Fix Bug#32085 
* doc/misc/tramp.texi (GVFS based methods): `dav' and `davs' do
not support paths in the volume name.  (Bug#32085)
 2018-07-10 09:49:49 +02:00
Basil L. Contovounesios
da5d6dbe39 Fix (length NON-SEQUENCE) documentation 
Suggested by Eli Zaretskii <eliz@gnu.org> in the following threads:
https://lists.gnu.org/archive/html/emacs-devel/2018-07/msg00171.html
https://lists.gnu.org/archive/html/emacs-devel/2018-07/msg00206.html

* doc/lispref/sequences.texi (Sequence Functions): Mention that
'length' signals a 'wrong-type-argument' also when given a
non-sequencep argument.
 2018-07-07 20:05:42 +03:00
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
Michael Albinus
271d1f778e Tramp editorials 
* doc/misc/tramp.texi (Android shell setup): Mention Termux.

* lisp/net/tramp-sh.el (tramp-remote-process-environment):
Use proper spelling "Tramp" in docstring.
 2018-07-06 14:03:42 +02:00
Glenn Morris
00fdce071c * doc/emacs/docstyle.texi: Avoid messing up the html output. 
Previously the @hyphenation commands somehow caused the <head>
section to go missing, with makeinfo 4.13 at least.
 2018-07-02 22:37:22 -07:00
Eli Zaretskii
2f149c074d Fix a factual error in Introduction to Emacs Lisp 
* doc/lispintro/emacs-lisp-intro.texi (Buffer Names): Update the
key that exits the splash screen.  (Bug#32019)
 2018-06-30 16:13:01 +03:00
Michael Albinus
1f5037925b Sync with Tramp 2.3.4. Do not merge with master 
* doc/misc/trampver.texi:
* lisp/net/trampver.el: Change version to "2.3.4".

* lisp/net/tramp-smb.el (tramp-smb-handle-delete-directory):
Check, that the directory has been removed indeed.

* test/lisp/net/tramp-tests.el (tramp-test21-file-links): Adapt test.
(tramp--test-emacs25-p): New defun.
(tramp-test34-vc-registered): Use it.
 2018-06-27 13:08:18 +02: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
Eli Zaretskii
b419f27a43 ; * doc/emacs/files.texi (Interlocking): Fix a non-portable @xref. 2018-06-24 19:23:13 +03: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
Eli Zaretskii
5cb3991a4f Fix a typo in emacs-lisp-intro.texi 
* doc/lispintro/emacs-lisp-intro.texi (kill-ring-yank-pointer):
Add a missing quote.  Reported by Jean-Christophe Helary
<brandelune@gmail.com> in emacs-devel.
 2018-06-22 21:25:55 +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
Noam Postavsky
e292c0973c Fix #'fun handling inside `labels' (Bug#31792) 
* lisp/emacs-lisp/cl.el (labels): Apply the equivalent of the
cl-labels change from 2015-01-16 "* lisp/emacs-lisp/cl-macs.el: Fix
last change".
* test/lisp/emacs-lisp/cl-tests.el (labels-function-quoting): New
test.
* lisp/emacs-lisp/cl-macs.el (cl-flet, cl-labels): Improve docstring,
link to relevant manual page.
* doc/misc/cl.texi (Function Bindings): Don't imply that function
cells of symbols are modified by cl-flet.  Don't claim that cl-flet or
cl-labels affect references of the form (quote FUNC).
 2018-06-19 20:02:16 -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
Michael Albinus
94e84a92fe ; Further wording fix in tramp.texi 2018-06-13 10:28:39 +02:00
Michael Albinus
a5a0b11186 Fix wording in tramp.texi 
* doc/misc/tramp.texi (Frequently Asked Questions):
Fix wording for abbreviations.
 2018-06-13 09:34:35 +02:00
Michael Albinus
29332428f1 * doc/misc/tramp.texi (Remote shell setup): Fix typo. 2018-06-13 09:21:29 +02: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
5b6f8b54d1 Clarify the documentation of 'dired-recursive-deletes' 
* doc/emacs/dired.texi (Dired Deletion): Clarify text regarding
recursive deletion of non-empty directories.  (Bug#31529)
 2018-06-09 11:58:27 +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
Basil L. Contovounesios
c57e7eaae8 Improve documentation of 'empty' whitespace-style 
* doc/emacs/display.texi (Useless Whitespace): Clarify that the
'empty' whitespace-style option highlights empty lines only at
BOB/EOB, as per the docstring of whitespace-style. (bug#31713)
 2018-06-05 18:04:01 +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
4a3aed2507 Update Emacs Lisp Intro to match current behavior 
* doc/lispintro/emacs-lisp-intro.texi (Wrong Type of Argument)
(debug, debug-on-entry, Void Function, Void Variable): Update the
*Backtrace* buffer display to current Emacs.  (Bug#31654)
 2018-06-01 17:11:36 +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
Robert Pluim
3257085443 Fix previous commit 
* doc/emacs/files.texi (Interlocking): Two spaces at end of sentence
 2018-06-01 15:34:33 +02: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
Michael Albinus
b8e7749b33 Fix example in Tramp manual 
* doc/misc/tramp.texi (Frequently Asked Questions): Fix wording
for the zsh example.
 2018-05-30 09:00:04 +02:00
Michael Albinus
186280fbbc * doc/misc/tramp.texi (Frequently Asked Questions): Adapt zsh example. 2018-05-29 19:45:23 +02:00
Michael Albinus
13963a3a5c * doc/misc/tramp.texi (All): Use @code instead of @option for user options. 2018-05-29 12:42:17 +02:00
Michael Albinus
6e5f19ada4 Fix Bug#31605 
* doc/misc/tramp.texi (All): Add @vindex entries for
environment variables.
(Remote shell setup): New items `tramp-terminal-type' and
"Determining a Tramp session".
(Frequently Asked Questions): Adapt zsh example.  (Bug#31605)
 2018-05-29 12:28:01 +02:00
Michael Albinus
e8912d5be9 Sync with Tramp 2.3.4-pre 
* doc/misc/trampver.texi: Change version to "2.3.4-pre

* lisp/net/tramp.el (tramp-mode, tramp-verbose)
(tramp-backup-directory-alist, tramp-auto-save-directory)
(tramp-encoding-shell, tramp-encoding-command-switch)
(tramp-encoding-command-interactive, tramp-default-method)
(tramp-default-method-alist, tramp-default-user)
(tramp-default-user-alist, tramp-default-host)
(tramp-default-host-alist, tramp-default-proxies-alist)
(tramp-save-ad-hoc-proxies, tramp-restricted-shell-hosts-alist)
(tramp-local-end-of-line, tramp-rsh-end-of-line)
(tramp-login-prompt-regexp, tramp-shell-prompt-pattern)
(tramp-password-prompt-regexp, tramp-wrong-passwd-regexp)
(tramp-yesno-prompt-regexp, tramp-yn-prompt-regexp)
(tramp-terminal-prompt-regexp)
(tramp-operation-not-permitted-regexp, tramp-copy-failed-regexp)
(tramp-process-alive-regexp, tramp-chunksize)
(tramp-process-connection-type, tramp-connection-timeout)
(tramp-connection-min-time-diff)
(tramp-completion-reread-directory-timeout):
* lisp/net/tramp-adb.el (tramp-adb-program)
(tramp-adb-connect-if-not-connected, tramp-adb-prompt):
* lisp/net/tramp-cache.el (tramp-connection-properties)
(tramp-persistency-file-name):
* lisp/net/tramp-gvfs.el (tramp-gvfs-methods)
(tramp-gvfs-zeroconf-domain, tramp-bluez-discover-devices-timeout):
* lisp/net/tramp-sh.el (tramp-inline-compress-start-size)
(tramp-copy-size-limit, tramp-terminal-type)
(tramp-histfile-override, tramp-use-ssh-controlmaster-options)
(tramp-remote-path, tramp-remote-process-environment)
(tramp-sh-extra-args):
* lisp/net/tramp-smb.el (tramp-smb-program, tramp-smb-acl-program)
(tramp-smb-conf, tramp-smb-winexe-program)
(tramp-smb-winexe-shell-command)
(tramp-smb-winexe-shell-command-switch):
Dont't require 'tramp.  (Bug#31558)

* lisp/net/tramp.el (tramp-accept-process-output):
* lisp/net/tramp-adb.el (tramp-adb-handle-start-file-process):
* lisp/net/tramp-sh.el (tramp-do-copy-or-rename-file-out-of-band)
(tramp-sh-handle-start-file-process):
* lisp/net/tramp-smb.el (tramp-smb-handle-copy-directory)
(tramp-smb-handle-file-acl, tramp-smb-handle-process-file)
(tramp-smb-handle-set-file-acl)
(tramp-smb-handle-start-file-process): Suppress timers.

* lisp/net/tramp-adb.el (tramp-adb-handle-write-region):
* lisp/net/tramp-gvfs.el (tramp-gvfs-handle-write-region):
* lisp/net/tramp-sh.el (tramp-sh-handle-write-region):
* lisp/net/tramp-smb.el (tramp-smb-handle-write-region):
Write proper message.

* lisp/net/tramp-cmds.el (tramp-change-syntax):
Use `customize-set-variable'.

* lisp/net/tramp-sh.el (tramp-open-connection-setup-interactive-shell):
Ensure proper EOL handling for Darwin.
(tramp-find-inline-compress): Improve command quoting for w32.
Reported by Chris Zheng <chriszheng99@gmail.com>.
(tramp-open-connection-setup-interactive-shell): Wrap both echo
calls in parentheses, in order to avoid double prompt.

* lisp/net/tramp-smb.el (tramp-smb-errors):
Add "NT_STATUS_RESOURCE_NAME_NOT_FOUND".

* lisp/net/tramp.el (tramp-default-user-alist)
(tramp-default-host-alist): Fix docstring.
(tramp-dissect-file-name): Adapt docstring.  (Bug#30904)
(tramp-make-tramp-file-name): Check, that method is
not empty.  (Bug#30038)
(tramp-message-show-message): Change default.

* lisp/net/trampver.el: Change version to "2.3.4-pre".

* test/lisp/net/tramp-tests.el (ert-x): Require it.
(tramp-test10-write-region): Extend test.
(tramp--test-emacs27-p, tramp--test-windows-nt): New defuns.
(tramp-test11-copy-file, tramp-test12-rename-file)
(tramp-test21-file-links, tramp-test24-file-acl)
(tramp-test25-file-selinux, tramp--test-check-files): Use them.
(tramp-test21-file-links): Do not call `make-symbolic-link' on w32.
Fix file name quoting test.
(tramp-test32-environment-variables-and-port-numbers):
Adapt check for systems which do not support "echo -n".  (Bug#29712)
(tramp-test36-find-backup-file-name): Call also
`convert-standard-filename' due to w32.
(tramp-test41-asynchronous-requests):
Use $REMOTE_PARALLEL_PROCESSES.  Flush cache prior file operations.
(tramp-test42-auto-load, tramp-test42-delay-load)
(tramp-test42-recursive-load, tramp-test42-remote-load-path):
Quote command due to w32.
 2018-05-29 09:57:48 +02: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
Eli Zaretskii
3145d08cae Update backtrace in Emacs Lisp Intro 
* doc/lispintro/emacs-lisp-intro.texi (Making Errors): Update the
backtrace to match Emacs 26.  (Bug#31589)
 2018-05-25 11:35:42 +03:00
Eli Zaretskii
4bb2741b7e More fixes of Intro to Emacs Lisp 
* doc/lispintro/emacs-lisp-intro.texi (Finding More): Tell the
reader how to invoke 'M-.' without a tags table.  Add a
cross-reference to the Emacs manual for when a tags table does
need to be created.
(append save-excursion): Rephrase a confusing sentence.
(Bug#31578)
 2018-05-24 20:37:15 +03:00
Eli Zaretskii
c57c226839 ; * doc/emacs/misc.texi (FFAP): Fix a typo. (Bug#31580) 2018-05-24 19:55:40 +03:00