aboutsummaryrefslogtreecommitdiffstats
path: root/doc/lispref (follow)
Commit message (Collapse)AuthorAgeFilesLines
* Doc changes for kqueueMichael Albinus2015-11-251-19/+22
| | | | | * doc/lispref/os.texi (File Notifications): Add kqueue as backend. Fix some glitches in the example.
* Remove support for ':timeout' from w32 tray notificationsEli Zaretskii2015-11-131-6/+0
| | | | | | | | | | * src/w32fns.c (Fw32_notification_notify): Delete the code that supports ':timeout'. (syms_of_w32fns): Don't DEFSYM ':timeout'. This avoids clashes with dbusbind.c when D-Bus is compiled in. * doc/lispref/os.texi (Desktop Notifications): Don't mention ':timeout'.
* ; * doc/lispref/os.texi: Fix indentation of sample code.Juanma Barranquero2015-11-111-1/+1
|
* Rename seq-p and map-p to seqp and mappNicolas Petton2015-11-111-3/+3
| | | | | | | * lisp/emacs-lisp/seq.el (seqp): New name. * lisp/emacs-lisp/map.el (mapp): New name. * doc/lispref/sequences.texi: Update the documentation for seqp. * test/automated/map-tests.el: Update the tests for mapp.
* Implement tray notifications for MS-WindowsEli Zaretskii2015-11-111-4/+84
| | | | | | | | | | | | | | | | | * src/w32fns.c (MY_NOTIFYICONDATAW): New typedef. (NOTIFYICONDATAW_V1_SIZE, NOTIFYICONDATAW_V2_SIZE) (NOTIFYICONDATAW_V3_SIZE, NIF_INFO, NIIF_NONE, NIIF_INFO) (NIIF_WARNING, NIIF_ERROR, EMACS_TRAY_NOTIFICATION_ID) (EMACS_NOTIFICATION_MSG): New macros. (NI_Severity): New enumeration. (get_dll_version, utf8_mbslen_lim, add_tray_notification) (delete_tray_notification, Fw32_notification_notify) (Fw32_notification_close): New functions. (syms_of_w32fns): Defsubr functions exposed to Lisp. DEFSYM keywords used by w32-notification-notify. * doc/lispref/os.texi (Desktop Notifications): Describe the native w32 tray notifications.
* Spelling fixesPaul Eggert2015-11-101-1/+1
| | | | | * lisp/net/soap-inspect.el (soap-inspect-xs-simple-type): Fix misspelling in output.
* * doc/lispref/variables.texi (Directory Local Variables):Artur Malabarba2015-11-101-13/+26
| | | | | | | | | | | Document dir-locals wildcards * lisp/files.el (dir-locals-file): Point to Info node. * doc/emacs/custom.texi (Directory Variables): Document dir-locals wildcards. * etc/NEWS: Document new functionality.
* * doc/lispref/windows.texi (Coordinates and Windows): Fix typo.Martin Rudalics2015-11-071-1/+1
|
* Document behavior of collation on CygwinKen Brown2015-11-021-2/+5
| | | | | | | * test/automated/fns-tests.el (fns-tests-collate-sort): Mark as expected failure on Cygwin. * doc/lispref/strings.texi (Text Comparison): Document that punctuation and whitespace are not ignored for sorting on Cygwin.
* ; Improve documentation of 'unhandled-file-name-directory'Eli Zaretskii2015-10-291-6/+6
| | | | | * doc/lispref/files.texi (Magic File Names): Better wording for the last change in the documentation of 'unhandled-file-name-directory'.
* Don't require default-directory to end with a slashDmitry Gutov2015-10-291-1/+1
| | | | | | | | | | | | | | * doc/lispref/files.texi (Magic File Names): Document the change in unhandled-file-name-directory. * lisp/url/url-handlers.el (url-handler-unhandled-file-name-directory): Update accordingly. * src/buffer.c (default-directory): Update the docsting. * src/fileio.c (unhandled-file-name-directory): Default to calling `file-name-as-directory' (http://lists.gnu.org/archive/html/emacs-devel/2015-10/msg02294.html).
* * doc/lispref/sequences.texi (Sequence Functions): Fix typoArtur Malabarba2015-10-281-1/+1
|
* * lisp/emacs-lisp/seq.el (seq-mapn): New functionArtur Malabarba2015-10-281-0/+18
| | | | * doc/lispref/sequences.texi (Sequence Functions): Document seq-mapn
* Clarify that load-path contents should be directory file namesStephen Leake2015-10-261-20/+30
| | | | | | | | * doc/lispref/files.texi (Directory Names): Define and use "directory file name". Recommend `expand-file-name'. * src/lread.c (load-path): Fix doc string; elements are directory file names.
* Further work on `stopped' events in filenotify.elMichael Albinus2015-10-261-8/+37
| | | | | | | | | | | | | | | | | | | | * doc/lispref/os.texi (File Notifications): Rework examples. * lisp/filenotify.el (file-notify--rm-descriptor): Optional parameter. (file-notify--rm-descriptor, file-notify-callback): Improve check for sending `stopped' event. (file-notify-add-watch): Check for more events for `inotify'. * test/automated/file-notify-tests.el (file-notify--test-expected-events): New defvar. (file-notify--test-with-events): Use it. (file-notify--test-cleanup): Make it more robust when deleting directories. (file-notify--test-event-test): Check also for watched directories. (file-notify--test-event-handler): Suppress temporary .#files. (file-notify-test02-events, file-notify-test04-file-validity): Rework `stopped' events. (file-notify-test05-dir-validity): Wait for events when appropriate.
* Document file notification `stopped' eventMichael Albinus2015-10-251-0/+37
| | | | * doc/lispref/os.texi (File Notifications): Document `stopped event'.
* New lispref section “Security Considerations”Paul Eggert2015-10-213-1/+106
| | | | | | | | | | | | | This attempts to document some of the issues recently discussed on emacs-devel, and to indicate other such issues. The section could be a lot longer. * doc/lispref/os.texi (Security Considerations): New node. * doc/lispref/elisp.texi (Top): * doc/lispref/processes.texi (Shell Arguments): * lisp/subr.el (shell-quote-argument): * src/callproc.c (syms_of_callproc): Reference it.
* (/ N) now returns the reciprocal of NPaul Eggert2015-10-201-4/+13
| | | | | | | | | | | | | | | This is more compatible with Common Lisp and XEmacs (Bug#21690). See: http://lists.gnu.org/archive/html/emacs-devel/2015-10/msg01053.html * lisp/color.el (color-hue-to-rgb, color-hsl-to-rgb) (color-xyz-to-srgb, color-xyz-to-lab): * lisp/emacs-lisp/cl-extra.el (cl-float-limits): * lisp/net/shr-color.el (shr-color-hue-to-rgb) (shr-color-hsl-to-rgb-fractions): Exploit the change to simplify the code a bit. * lisp/emacs-lisp/bytecomp.el (byte-compile-quo): Don’t complain about single-argument calls to ‘/’. * src/data.c (arith_driver, float_arith_driver): Implement the change.
* New function seq-positionNicolas Petton2015-10-201-0/+19
| | | | | | * lisp/emacs-lisp/seq.el (seq-position): New function. * test/automated/seq-tests.el: New tests for seq-position. * doc/lispref/sequences.texi: Add documentation for `seq-position'.
* Fix return value of 'set-file-extended-attributes'Eli Zaretskii2015-10-191-0/+2
| | | | | | | | | * lisp/files.el (set-file-extended-attributes): Return non-nil when setting either ACLs or SELinux context succeeds. Document the return value. (Bug#21699) * doc/lispref/files.texi (Changing Files): Document the return value of set-file-extended-attributes.
* ; * doc/lispref/processes.texi (Synchronous Processes): Minor copyedit.Eli Zaretskii2015-10-191-1/+1
|
* Improve documentation of functions that change filesEli Zaretskii2015-10-191-1/+4
| | | | | * doc/lispref/files.texi (Changing Files): Document that these functions signal an error on failure.
* Minor improvement in documentation of internalsEli Zaretskii2015-10-161-0/+9
| | | | * doc/lispref/internals.texi (Writing Emacs Primitives): Document QUIT.
* Improve documentation of COLLECTION in completion functionsEli Zaretskii2015-10-161-0/+3
| | | | | | | | * doc/lispref/minibuf.texi (Minibuffer Completion): Add a cross-reference to "Programmed Completion". * src/minibuf.c (Fcompleting_read): Improve the doc string. (Bug#21644)
* Use ‘echo’ safely with ‘\’ or leading ‘-’Paul Eggert2015-10-101-24/+23
| | | | | | | | | | | | | | | | | | | | | | POSIX says that ‘echo FOO’ produces implementation-defined output if FOO contains leading ‘-’, or ‘\’ anywhere, so don’t assume GNU behavior in that case. * Makefile.in (removenullpaths): Remove. (epaths-force): Rewrite to avoid the need for ‘echo’. (install-etc): Be clearer about escaping the shell metacharacters ‘\’ and ‘$’. * Makefile.in (install-arch-indep, install-etcdoc): * admin/charsets/mapconv, admin/merge-gnulib, admin/merge-pkg-config: * admin/quick-install-emacs, build-aux/gitlog-to-emacslog: * configure.ac, lib-src/rcs2log, make-dist: * src/Makefile.in (lisp.mk): Don’t assume ‘echo’ outputs ‘\’ and leading ‘-’ unscathed. For example, use ‘printf '%s\n' "$foo"’ rather than ‘echo "$foo"’ if $foo can contain arbitrary characters. * lisp/Makefile.in (TAGS): Use ‘ls’, not ‘echo’, to avoid ‘\’ issues. * doc/lispref/two-volume.make (vol1.pdf): * test/etags/make-src/Makefile (web ftp publish): Use ‘printf’ rather than ‘echo -e’.
* * doc/lispref/objects.texi (Window Type): Add a cross reference.Xue Fuqiao2015-10-061-2/+2
|
* Doc fix for `defmacro'Xue Fuqiao2015-10-031-2/+2
| | | | * doc/lispref/objects.texi (Macro Type): `defmacro' is a macro now.
* Fix a few problems with directed quotesPaul Eggert2015-10-012-11/+27
| | | | | | | | | | This is in response to a problem report by Kaushal Modi in: http://bugs.gnu.org/21588#25 * lisp/cedet/mode-local.el (describe-mode-local-overload): * lisp/emacs-lisp/bytecomp.el (byte-compile-fix-header): * lisp/info-xref.el (info-xref-check-all-custom): * lisp/mail/emacsbug.el (report-emacs-bug-hook): Prefer directed to undirected single quotes in diagnostics.
* ; Clarify docs of pos-visible-in-window-p some moreEli Zaretskii2015-09-301-6/+8
|
* Clarify documentation of pos-visible-in-window-pEli Zaretskii2015-09-301-1/+1
| | | | | | | | | | * src/window.c (Fpos_visible_in_window_p): Clarify the meaning of t for POS. See http://lists.gnu.org/archive/html/emacs-devel/2015-09/msg01040.html for the original report. * doc/lispref/windows.texi (Window Start and End): Clarify the meaning of t for the POSITION argument of pos-visible-in-window-p.
* Add documentation for seq.elNicolas Petton2015-09-281-0/+75
| | | | | | * doc/lispref/sequences.texi: Add documentation regarding extending seq.el, as well as missing documentation for seq-elt, seq-length, seq-p, seq-do and seq-map.
* Better documentation for seq-someNicolas Petton2015-09-281-3/+6
| | | | | | | * doc/lispref/sequences.texi: * lisp/emacs-lisp/seq.el: Update the documentation of seq-some to guarantee that the returned value is the first non-nil value that resulted from applying the predicate.
* Resurrect edebug-set-initial-mode, repurposing it to set the global mode.Alan Mackenzie2015-09-251-5/+17
| | | | | | | | | | | | | | | | lisp/emacs-lisp/edebug.el (edebug-initial-mode-alist): Uncomment, and amend to match current modes and functions. (edebug-set-initial-mode): Uncomment and change from setting a defun's `edebug-initial-mode''s property to setting the variable `edebug-initial-mode'. (top level): Create new binding C-x C-a C-m for `edebug-set-initial-mode'. doc/lispref/edebug.texi (Edebug Execution Modes): document `edebug-set-initial-mode' and its new key binding. (Edebug Options): Mention the new command in the pertinent place. etc/NEWS: Write entry for this change.
* Avoid non-ASCII decoding errors in Texinfo filesEli Zaretskii2015-09-256-6/+6
| | | | | | | | | | | | | | | | | | * doc/misc/tramp.texi: * doc/lispref/strings.texi: * doc/lispref/positions.texi: * doc/lispref/help.texi: * doc/lispref/functions.texi: * doc/lispintro/emacs-lisp-intro.texi: * doc/emacs/text.texi: * doc/emacs/modes.texi: * doc/emacs/mini.texi: * doc/emacs/display.texi: * doc/emacs/custom.texi: * doc/emacs/basic.texi: Add 'coding' cookies -- these files use Unicode characters and should be decoded as UTF-8. * doc/lispref/frames.texi (Size Parameters): Don't use a non-ASCII apostrophe unnecessarily.
* Support ':relative-width' space display spec on text-mode terminalsEli Zaretskii2015-09-231-2/+3
| | | | | | | * src/xdisp.c (produce_stretch_glyph): Support ':relative-width' space display spec on text-mode terminals, by calling PRODUCE_GLYPHS instead of x_produce_glyphs. Remove the HAVE_WINDOW_SYSTEM guards from the supporting code, as well as the test for a GUI frame.
* Clarify documentation of ':relative-width'Eli Zaretskii2015-09-221-2/+3
| | | | | * doc/lispref/display.texi (Specified Space): Document that ':relative-width' is only supported on GUI frames.
* Make description of `edebug-initial-mode' user friendly.Alan Mackenzie2015-09-221-7/+9
| | | | | | | | | Fixes debbugs#21365. dec/lispref/edebug.texi (Edebug Execution Modes): Change the desscription of `edebug-initial-mode' from that of its implementation to that of its visual effect and use. Move the paragraph higher up.
* ; * doc/lispref/os.texi (File Notifications): Minor copy-edits.Eli Zaretskii2015-09-221-3/+4
|
* Clarify or replace a few \u escapes.Paul Eggert2015-09-211-3/+3
| | | | | | | | | | | | | * doc/lispref/nonascii.texi (Character Properties) More-detailed commentary for \u escapes. * lisp/progmodes/python.el (python--prettify-symbols-alist): * lisp/replace.el (query-replace-from-to-separator): * lisp/textmodes/rst.el (rst-bullets, rst-re-alist-def) (rst-mode-syntax-table): * lisp/whitespace.el (whitespace-display-mappings): Prefer actual character to \u escape when this makes the code easier to follow in the usual case where Unicode chars can be displayed.
* Adapt tests and manual for w32notifyMichael Albinus2015-09-211-1/+6
| | | | | | | | | | | | * doc/lispref/os.texi (File Notifications): w32notify does not send `attribute-changed' events. * test/automated/file-notify-tests.el (file-notify--test-with-events): Simplify parameters. Adapt all callees. (file-notify-test02-events): w32notify does not send `attribute-changed' events. (file-notify-test04-file-validity, file-notify-test05-dir-validity): Do not skip in case of w32notify. Simply ignore this part of the test.
* Better docstring and parameter name for seq-findNicolas Petton2015-09-211-5/+4
| | | | | | | | * lisp/emacs-lisp/seq.el (seq-find): Improve the docstring and rename the parameter `sentinel' to `default'. * doc/lispref/sequences.texi (Sequence Functions): Update the documentation for `seq-find' accordingly.
* Improve file notifications, especially for TrampMichael Albinus2015-09-202-0/+13
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/lispref/files.texi (Magic File Names): Mention `file-notify-valid-p'. * doc/lispref/os.texi (File Notifications): Describe `file-notify-valid-p'. * etc/NEWS: Add `file-notify-valid-p'. * lisp/net/tramp-gvfs.el (tramp-gvfs-handle-file-notify-add-watch): Improve implementation. (tramp-gvfs-monitor-file-process-filter): Rename from `tramp-gvfs-file-gvfs-monitor-file-process-filter'. Delete process if appropriate. * lisp/net/tramp-sh.el (tramp-sh-handle-file-notify-add-watch): Improve implementation. (tramp-sh-gvfs-monitor-dir-process-filter): Rename from `tramp-sh-file-gvfs-monitor-dir-process-filter'. Delete process if appropriate. (tramp-sh-inotifywait-process-filter): Rename from `tramp-sh-file-inotifywait-process-filter'. Delete process if appropriate. * lisp/net/tramp.el (tramp-handle-file-notify-rm-watch): Use `delete-process' (tramp-handle-file-notify-valid-p): Check also, that file or directory to be watched still exists. * test/automated/file-notify-tests.el (file-notify--test-timeout): New defun. Use it at all places a timeout is needed. (file-notify--test-cleanup): Delete directories recursively. Cleanup also Tramp connections. (file-notify-test02-events): Add tests for `attribute-change'. (file-notify-test04-file-validity, file-notify-test05-dir-validity): Add tests for `file-notify-rm-watch'.
* * lisp/font-lock.el (font-lock-beginning-of-syntax-function): RemoveStefan Monnier2015-09-171-26/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | (font-lock-fontify-block): Don't let-bind it. (font-lock-compile-keywords): Don't use it. (font-lock-set-defaults): Don't set it. Allow the variable alist to start one slot earlier, instead. * lisp/emacs-lisp/syntax.el (font-lock-beginning-of-syntax-function): Don't declare. (syntax-ppss): Don't use it either. * lisp/font-core.el (font-lock-defaults): Remove SYNTAX-BEGIN from docstring. * doc/emacs/display.texi (Font Lock): Don't mention font-lock-beginning-of-syntax-function. * doc/lispref/modes.texi (Font Lock Basics): Update description of font-lock-defaults. (Syntactic Font Lock): Remove font-lock-beginning-of-syntax-function. * lisp/loadhist.el (unload-feature-special-hooks): Remove font-lock-beginning-of-syntax-function. * lisp/obsolete/lazy-lock.el (lazy-lock-fontify-region): * lisp/emacs-lisp/lisp.el (beginning-of-defun-raw): Don't let-bind font-lock-beginning-of-syntax-function.
* * doc/lispref/frames.texi (Cursor Parameters): Document 'x-stretch-cursor'.Eli Zaretskii2015-09-171-0/+13
|
* Restore some of the quoting in the manualsEli Zaretskii2015-09-1622-56/+57
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/lispref/windows.texi (Coordinates and Windows) (Coordinates and Windows): * doc/lispref/variables.texi (Lexical Binding) (File Local Variables): * doc/lispref/text.texi (Format Properties): * doc/lispref/symbols.texi (Symbol Components): * doc/lispref/strings.texi (Creating Strings): * doc/lispref/sequences.texi (Sequence Functions): * doc/lispref/searching.texi (Regexp Special, Regexp Search) (Search and Replace): * doc/lispref/processes.texi (Bindat Spec): * doc/lispref/os.texi (Idle Timers): * doc/lispref/objects.texi (Basic Char Syntax): * doc/lispref/numbers.texi (Float Basics, Random Numbers): * doc/lispref/nonascii.texi (Character Properties): * doc/lispref/modes.texi (Major Mode Conventions, Mode Hooks) (Mode Line Variables): * doc/lispref/minibuf.texi (Text from Minibuffer): * doc/lispref/loading.texi (Autoload): * doc/lispref/keymaps.texi (Controlling Active Maps): * doc/lispref/frames.texi (Frame Layout, Size and Position) (Size Parameters, Implied Frame Resizing): * doc/lispref/files.texi (Changing Files, Magic File Names): * doc/lispref/eval.texi (Self-Evaluating Forms): * doc/lispref/display.texi (Progress, Abstract Display) (Abstract Display Example, Bidirectional Display): * doc/lispref/commands.texi (Event Mod): * doc/emacs/windows.texi (Displaying Buffers): * doc/emacs/trouble.texi (Bug Criteria, Checklist): * doc/emacs/text.texi (Enriched Text): * doc/emacs/programs.texi (MixedCase Words): * doc/emacs/picture-xtra.texi (Insert in Picture) (Tabs in Picture): * doc/emacs/misc.texi (Emacs Server, Printing): * doc/emacs/mini.texi (Minibuffer History): * doc/emacs/maintaining.texi (Old Revisions, VC Change Log) (Pulling / Pushing): * doc/emacs/killing.texi (Yanking, Cut and Paste, Clipboard): * doc/emacs/help.texi (Help, Help Echo): * doc/emacs/glossary.texi (Glossary): * doc/emacs/frames.texi (Mouse Commands, Creating Frames) (Frame Commands): * doc/emacs/files.texi (Reverting, Saving, Directories): * doc/emacs/entering.texi (Exiting): * doc/emacs/emacs.texi (Top): * doc/emacs/cmdargs.texi (Window Size X, Icons X): * doc/emacs/anti.texi (Antinews): Restore quoting of text where appropriate or replace quoting with @dfn. * doc/misc/ediff.texi (Window and Frame Configuration): * doc/lispref/processes.texi (Network Feature Testing): * doc/lispref/display.texi (Display Margins): Quote the phrase after "a.k.a." where appropriate.
* Revert premature commitStephen Leake2015-09-151-7/+5
| | | | | * doc/lispref/files.texi: Revert premature commit of change to file-name-all-completions.
* Fix a bug in elisp--xref-find-definitions related to cl-generic defaultsStephen Leake2015-09-151-5/+7
| | | | | | | | | * lisp/progmodes/elisp-mode.el (elisp--xref-find-definitions): Fix bug with cl-generic defaults. (elisp--xref-find-references): Add doc string. * test/automated/elisp-mode-tests.el (xref-elisp-generic-*): Improve tests to find bug.
* ; Spelling fixesPaul Eggert2015-09-151-1/+1
|
* Quote “fullboth” when defining itPaul Eggert2015-09-151-10/+11
| | | | | * doc/lispref/frames.texi (Size Parameters): Use @dfn for “fullboth” and rewrite the containing paragraph, which was awkward. (Bug#21472).
* Quote less in manualsPaul Eggert2015-09-1547-473/+482
| | | | | | | | | | The manuals often used quotes ``...'' when it is better to use @dfn or @code or capitalized words or no quoting at all. For example, there is no need for the `` and '' in “if a variable has one effect for @code{nil} values and another effect for ``non-@code{nil}'' values”. Reword the Emacs, Lisp intro, and Lisp reference manuals to eliminate unnecessary quoting like this, and to use @dfn etc. instead when called for (Bug#21472).