summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* ;Corrected display-fill-column-indicator mode.fill_column_indicatorJimmy Aguilar Mena2019-05-031-3/+4
| | | | Small corrections in the documentation and code format to merge into master.
* ;Small changes in the documentationJimmy Aguilar Mena2019-05-031-1/+1
| | | | | | *src/xdisp.c: Fixed docstring for display-fill-column-indicator-column *etc/NEWS: Concordance fix in the display-fill-column-indicator part. *doc/emacs/display.texi: Name mismatch fix.
* Added correction in the texinfo manual.Jimmy Aguilar Mena2019-05-032-22/+28
| | | | | *doc/emacs/text.texi: Added a reference to the display-fill-column-indicator section.
* Added fill-column-indicator manual documentationJimmy Aguilar Mena2019-05-031-0/+45
| | | | | | *etc/NEWS: reduced the comments about fill-column-indicator *doc/emacs/display.texi: Added documentation for fill-column-indicator in this section in the manual
* Update from GnulibPaul Eggert2019-04-301-303/+213
| | | | | | | * build-aux/config.guess, doc/misc/texinfo.tex: * lib/mktime-internal.h, lib/mktime.c, lib/timegm.c: Copy from Gnulib. * lib/gnulib.mk.in: Regenerate.
* Don't poll auto-revert files that use notification (bug#35418)Mattias EngdegÄrd2019-04-301-0/+14
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | It is a waste to periodically poll files that use change notification in auto-revert mode; stop doing that. If no files need polling, turn off the periodic execution entirely to further avoid wasting power. Use a timer to inhibit immediate reversion for some time after a notification, for throttling. This change does not apply to files in global-auto-revert-mode, where polling is still necessary. It is disabled by default, and enabled by setting `auto-revert-avoid-polling' to non-nil. * lisp/autorevert.el (toplevel): Require cl-lib. (auto-revert-avoid-polling, auto-revert--polled-buffers) (auto-revert--need-polling-p, auto-revert--lockout-interval) (auto-revert--lockout-timer, auto-revert--end-lockout): New. (global-auto-revert-mode): Keep notifiers for buffers in auto-revert mode. (auto-revert-set-timer): Use auto-revert--need-polling-p. (auto-revert-notify-handler): Restart polling if notification stopped. Use new lockout timer. (auto-revert-buffers): Use auto-revert--polled-buffers and auto-revert--need-polling-p. (auto-revert-buffers-counter, auto-revert-buffers-counter-lockedout): Remove. * etc/NEWS (Changes in Specialized Modes and Packages): Describe the new auto-revert-avoid-polling variable. * doc/emacs/files.texi (Reverting): Add paragraph describing auto-revert-avoid-polling.
* Merge from origin/emacs-26Glenn Morris2019-04-291-1/+6
|\ | | | | | | | | | | | | | | | | c26d452 (origin/emacs-26) * src/macfont.m (macfont_shape): Use conven... 140e7f8 Recommend using font-lock-face over face (Bug#35044) 7cb5364 Check if mouse_face_overlay was deleted (Bug#35273) # Conflicts: # src/macfont.m
| * Recommend using font-lock-face over face (Bug#35044)Noam Postavsky2019-04-281-1/+6
| | | | | | | | | | * doc/lispref/modes.texi (Precalculated Fontification): Explain advantages of using font-lock-face over face.
* | Merge from origin/emacs-26Glenn Morris2019-04-292-2/+2
|\ \ | |/ | | | | | | | | | | 0e8d452 ; * doc/lispref/nonascii.texi (Coding System Basics): Fix gra... 25a2ff7 ; Add missing space in custom.texi 9ec18fb * admin/admin.el (set-version): Check for increase in version... 93912ba Be more careful about indent-sexp going over eol (Bug#35286)
| * ; * doc/lispref/nonascii.texi (Coding System Basics): Fix grammar.Charles A. Roelli2019-04-261-1/+1
| |
| * ; Add missing space in custom.texiMichael Albinus2019-04-251-1/+1
| |
| * Backport: Improve pure and side-effect-free docsBasil L. Contovounesios2019-04-225-13/+25
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | For discussion, see thread starting at: https://lists.gnu.org/archive/html/emacs-devel/2019-04/msg00316.html * doc/lispref/customize.texi (Composite Types): Do not overspecify :match-alternatives predicates. * doc/lispref/eval.texi (Intro Eval): Anchor definition of "side effect" for cross-referencing... * doc/lispref/functions.texi (What Is a Function): ...from here. Define what a pure function is. * doc/lispref/internals.texi (Writing Emacs Primitives): Describe currently preferred approach to marking primitives as pure and side-effect-free. * doc/lispref/symbols.texi (Standard Properties): Expand description of pure and side-effect-free properties. (cherry picked from commit 4430a9b54fca266e48d0eb8b72d83706910f10b8)
* | Export major version of latest Emacs supported by emacs-module.h.Philipp Stephani2019-04-281-0/+11
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This is useful if module authors want to support multiple versions of emacs-module.h. * configure.ac (emacs_major_version): Define substitution. * src/emacs-module.h.in (EMACS_MAJOR_VERSION): Define macro. * doc/lispref/internals.texi (Module Initialization): Document EMACS_MAJOR_VERSION preprocessor macro. * test/data/emacs-module/mod-test.c (emacs_module_init): Verify behavior of EMACS_MAJOR_VERSION.
* | * doc/lispref/internals.texi (Module Values): Add a GMP examplePhilipp Stephani2019-04-241-0/+25
| |
* | Clarify rounding mode when converting to struct timespec.Philipp Stephani2019-04-241-6/+6
| | | | | | | | | | | | | | | | | | | | | | * doc/lispref/internals.texi (Module Values): Clarify that the truncation is towards negative infinity. * test/data/emacs-module/mod-test.c (Fmod_test_nanoseconds): Add test function. (emacs_module_init): Define it. * test/src/emacs-module-tests.el (mod-test-nanoseconds): New unit test.
* | Add module functions to convert from and to big integers.Philipp Stephani2019-04-241-0/+35
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * src/module-env-27.h: Add new module functions to convert big integers. * src/emacs-module.h.in (emacs_mpz): Define if GMP is available. * src/emacs-module.c (module_extract_big_integer) (module_make_big_integer): New functions. (initialize_environment): Use them. * test/data/emacs-module/mod-test.c (Fmod_test_double): New test function. (emacs_module_init): Define it. * test/src/emacs-module-tests.el (mod-test-double): New unit test. * doc/lispref/internals.texi (Module Values): Document new functions.
* | Add conversions to and from struct timespec to module interface.Philipp Stephani2019-04-241-0/+44
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Time values are a fundamental data type, and such conversions are hard to implement within modules because of the various forms of time values in Emacs Lisp. Adding dedicated conversion functions can significantly simplify module code dealing with times. This approach uses nanosecond precision. While Emacs in theory has support for higher-precision time values, in practice most languages and standards, such as POSIX, C, Java, and Go, have settled on nanosecond-precision integers to represent time. * src/emacs-module.h.in: Add header for struct timespec. * src/module-env-27.h: Add module functions for time conversion. * src/emacs-module.c (module_extract_time, module_make_time): New functions. (initialize_environment): Use them. * test/data/emacs-module/mod-test.c (Fmod_test_add_nanosecond): New test function. (emacs_module_init): Define it. * test/src/emacs-module-tests.el (mod-test-add-nanosecond/valid) (mod-test-add-nanosecond/nil, mod-test-add-nanosecond/invalid): New unit tests. * doc/lispref/internals.texi (Module Values): Document time conversion functions.
* | Remote processes cannot use a pipe process for stderrMichael Albinus2019-04-231-1/+8
| | | | | | | | | | | | * doc/lispref/processes.texi (Asynchronous Processes): (Accepting Output): Remote processes cannot use a pipe process for stderr.
* | Improve documentation around standard error pipes (Bug#35328).Philipp Stephani2019-04-221-0/+26
| | | | | | | | | | | | | | * doc/lispref/processes.texi (Asynchronous Processes): Document existence and properties of the standard error process. (Accepting Output): Document that one has to accept output from the standard error process separately.
* | Improve pure and side-effect-free docsBasil L. Contovounesios2019-04-225-13/+25
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | For discussion, see thread starting at: https://lists.gnu.org/archive/html/emacs-devel/2019-04/msg00316.html * doc/lispref/customize.texi (Composite Types): Do not overspecify :match-alternatives predicates. * doc/lispref/eval.texi (Intro Eval): Anchor definition of "side effect" for cross-referencing... * doc/lispref/functions.texi (What Is a Function): ...from here. Define what a pure function is. * doc/lispref/internals.texi (Writing Emacs Primitives): Describe currently preferred approach to marking primitives as pure and side-effect-free. * doc/lispref/symbols.texi (Standard Properties): Expand description of pure and side-effect-free properties.
* | Merge from origin/emacs-26Glenn Morris2019-04-214-9/+9
|\ \ | |/ | | | | | | | | | | | | | | | | | | 9d7e08d (origin/emacs-26) Avoid false positives and false negatives o... 75b589c Fix markup related to quoting in Info fd6ff29 Merge branch 'emacs-26' of git.savannah.gnu.org:/srv/git/emac... cd2204f Add a package: line to c-submit-bug-report. a992dca ; Remove empty NEWS sections ea67270 ; Add NEWS sections for 26.3 45b0946 ; Bump Emacs version to 26.2.50 aae8cc3 * admin/admin.el (set-version): Add NEWS headers for a .50 ve...
| * Fix markup related to quoting in InfoEli Zaretskii2019-04-214-9/+9
| | | | | | | | | | | | | | | | * doc/misc/sc.texi (Citations): Fix markup of '>'. * doc/misc/mh-e.texi (Speedbar): Fix markup in a @table. * doc/misc/calc.texi (Yacas Language Mode): Fix a typo. * doc/emacs/mark.texi (Setting Mark): Remove duplicate quoting. (Bug#35202)
| * Backport doc improvement in ELisp manualEli Zaretskii2019-04-201-0/+20
| | | | | | | | | | | | * doc/lispref/processes.texi (Accepting Output): Backport: document how do avoid race conditions while waiting for all of the process's output to arrive.
* | Fix Pike Mode's autodoc doc comments style's continued lines.Alan Mackenzie2019-04-201-1/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * lisp/progmodes/cc-engine.el (c-forward-sws, c-backward-sws): Recognize matches of c-doc-line-join-re as syntactic whitespace. (c-find-decl-prefix-search): Recognize and move over matches of c-doc-line-join-re as whitespace. (c-find-decl-spots): Before moving backward a char, check (bobp). Before moving forward over a comment, check it isn't possibly a "bright" comment. * lisp/progmodes/cc-fonts.el (c-get-doc-comment-style): New function, extracted from c-compose-keywords-list. (c-compose-keywords-list): Call the above new function. (pike-font-lock-keywords, pike-font-lock-keywords-2) (pike-font-lock-keywords-3): Call c-set-doc-comment-res. (c-doc-line-join-re, c-doc-bright-comment-start-re, c-doc-line-join-end-ch): New variables. (c-set-doc-comment-re-element, c-set-doc-comment-char-list): New macros. (c-set-doc-comment-res): New function. (c-font-lock-doc-comments): For consistency and repeatability, in a sequence of C++ style doc comments, don't fontify the region between BOL and the comment marker. (autodoc-line-join-re, autodoc-bright-comment-start-re) (autodoc-line-join-end-ch): New variables. * lisp/progmodes/cc-mode.el (c-doc-fl-decl-start, c-doc-fl-decl-end): New functions. (c-change-expand-fl-region, c-context-expand-fl-region): Call the above two new functions for extra possibilities for the start and end of a construct. * doc/misc/cc-mode.texi (Doc Comments): Add a sentence drawing attention to the possibility of fontifying constructs within a doc comment.
* | ; Minor improvement in documentation from recent commitEli Zaretskii2019-04-191-4/+5
| | | | | | | | | | | | * doc/lispref/processes.texi (Asynchronous Processes): Say explicitly that it's an error to pass non-nil value for :stopped when starting a process. (Bug#30460)
* | Remove :stop key from make-process.Philipp Stephani2019-04-191-1/+3
| | | | | | | | | | | | | | | | | | | | | | | | This has never worked and caused issues such as Bug#30460. * src/process.c (Fmake_process): Don't accept :stop key any more. (syms_of_process): Define needed symbol 'null'. * test/src/process-tests.el (make-process/stop): New unit test. * doc/lispref/processes.texi (Asynchronous Processes): Remove :stop key from manual.
* | Update module documentation for bignum support.Philipp Stephani2019-04-181-6/+7
| | | | | | | | | | * doc/lispref/internals.texi (Module Values): Update documentation for 'make_integer' and 'extract_integer' for bignum support.
* | Merge from origin/emacs-26Glenn Morris2019-04-173-5/+19
|\ \ | |/ | | | | | | | | | | | | | | a1c53d4 (origin/emacs-26) * admin/admin.el (make-manuals-dist--1): Up... d0f745f Document some compilation-mode faces 23ccba0 Mention the assignment form in "Copyright Assignment" 0f5568e Fix confusing wording in the user manual 70ec392 Fix the MSDOS build when running under CWSDPMI 7a608fc * lisp/progmodes/python.el: Be more careful about temp file r...
| * Document some compilation-mode facesRobert Pluim2019-04-161-0/+14
| | | | | | | | | | * doc/emacs/building.texi (Compilation Mode): Describe faces available to affect appearance of compilation-mode buffers.
| * Mention the assignment form in "Copyright Assignment"Eli Zaretskii2019-04-161-3/+4
| | | | | | | | | | | | * doc/emacs/trouble.texi (Copyright Assignment): Mention the copyright assignment form explicitly. Suggested by Konstantin Kharlamov <hi-angel@yandex.ru>.
| * Fix confusing wording in the user manualEli Zaretskii2019-04-161-2/+1
| | | | | | | | | | * doc/emacs/maintaining.texi (VC Undo): Remove a potentially inaccurate, outdated, and/or confusing sentence. (Bug#35290)
* | Merge from origin/emacs-26Glenn Morris2019-04-171-2/+2
|\ \ | |/ | | | | | | | | 266c622 Downcase charset 92f3459 Update for Emacs-26 beb4eac * doc/lispref/display.texi (Showing Images): Fix a typo. (Bu...
| * * doc/lispref/display.texi (Showing Images): Fix a typo. (Bug#35240Eli Zaretskii2019-04-121-2/+2
| |
* | * doc/misc/tramp.texi: Fix direntry.Michael Albinus2019-04-151-4/+4
| |
* | Explain ad-hoc multi-hop in the Tramp Quick Start GuideMichael Albinus2019-04-141-0/+21
| | | | | | | | | | * doc/misc/tramp.texi (Quick Start Guide): New section "Combining @option{ssh} or @option{plink} with @option{su} or @option{sudo}".
* | Update from GnulibPaul Eggert2019-04-131-151/+297
| | | | | | | | | | | | | | | | This incorporates: 2019-04-07 Add copyright notices in several files * build-aux/config.sub, doc/misc/texinfo.tex, lib/_Noreturn.h: Copy from Gnulib. * lib/gnulib.mk.in: Regenerate.
* | * doc/misc/tramp.texi: Fix minor glitches.Michael Albinus2019-04-131-13/+12
| |
* | Improve documentation of JSONRPCEli Zaretskii2019-04-131-43/+66
| | | | | | | | | | | | | | * doc/lispref/text.texi (JSONRPC Overview) (Process-based JSONRPC connections) (JSONRPC JSON object format): Fix wording and markup. Add indexing.
* | Improve documentation changes of a recent commitEli Zaretskii2019-04-131-5/+8
| | | | | | | | | | | | | | * doc/lispref/text.texi (Parsing JSON): Improve wording of the documentation of 'json-parse-string' and 'json-parse-buffer'. * src/json.c (Fjson_parse_string, Fjson_parse_buffer): Doc fix. (Bug#34763)
* | Add :array-type option to json-parse-stringDmitry Gutov2019-04-131-0/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | * src/json.c (enum json_array_type): New type. (struct json_configuration): New field array_type. (json_parse_args): Rename the last argument. Handle the :array-type keyword argument (bug#32793). (Fjson_parse_string): Update the docstring accordingly. (json_to_lisp): Handle the case of :array-type being `list'. Add a call to 'rarely_quit' inside the loop. (syms_of_json): Define new symbols. (Fjson_serialize, Fjson_insert, Fjson_parse_string) (Fjson_parse_buffer): Update the config struct initializers.
* | Merge from origin/emacs-26Glenn Morris2019-04-121-1/+2
|\ \ | |/ | | | | | | | | | | | | | | 818a68b * etc/HISTORY: Update for Emacs 26.2 release. e04aa5a ; ChangeLog.3 update 8297e97 * etc/AUTHORS: Update. 8582936 Improve documentation of 'read-command' dc81c05 ; * CONTRIBUTE: Mention where to ask for the copyright assign... b77723a Fix an outdated URL in a comment
| * Improve documentation of 'read-command'Eli Zaretskii2019-04-111-1/+2
| | | | | | | | | | | | | | | | * src/minibuf.c (Fread_command): Document the return value when DEFAULT-VALUE is nil and the user enters nothing. * doc/lispref/minibuf.texi (High-Level Completion): Document the printed representation of a symbol whose name is empty. (Bug#3522)
| * Backport: Update documentation for indent-relative functionsAlex Branham2019-04-111-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | * lisp/indent.el (indent-relative): Document what happens when there is no previous nonblank line. * doc/lispref/text.texi (Relative Indent): Document indent-relative-first-indent-point instead of obsolete indent-relative-maybe. Fix documentation of which argument from 'indent-relative' is used. Bug#34858 (cherry picked from commit 10cd65878c741d2a22a1f2c36c54fcad4e516f72)
* | Merge from origin/emacs-26Glenn Morris2019-04-121-1/+1
|\ \ | |/ | | | | cb5a340 Update nxml-mode.texi: completion now gives xmlns="-!-"
| * Update nxml-mode.texi: completion now gives xmlns="-!-"Noam Postavsky2019-04-101-1/+1
| | | | | | | | | | | | | | * doc/misc/nxml-mode.texi (Completion): As of 2016-01-16 "* lisp/nxml: Use standard completion; it also works for company-mode", completing an attribute when there is only one candidate inserts both quotes. Update the example accordingly.
* | Merge from origin/emacs-26Glenn Morris2019-04-101-22/+30
|\ \ | |/ | | | | | | 5999401 (origin/emacs-26) Note that choose-completion-string-function... 8d2f1df Address name conflicts in EIEIO documentation (bug#31660)
| * Address name conflicts in EIEIO documentation (bug#31660)Gemini Lasswell2019-04-091-22/+30
| | | | | | | | | | | | | | | | | | * doc/misc/eieio.texi (Quick Start): Rename the class used in the example from 'record' to 'person'. (Building Classes): Advise user to check for name conflicts before naming a class. Add a missing apostrophe. (Making New Objects): Correct grammar. Rename the class used in the example from 'record' to 'my-class'.
* | Merge from origin/emacs-26Glenn Morris2019-04-101-49/+66
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | a5da653 * src/editfns.c (Fnarrow_to_region): Doc fix. (Bug#35163) 646d33d Fix doc strings of 'vc-version-diff' and 'vc-version-ediff' a30a6c3 Improve documentation of set-window-start 92ce2dd Improve documentation of window parameters 6dc42c5 Improve commentary in frame.el a8cffcf Fix typo in a doc string 9e79f19 (emacs-26) ; * src/fontset.c (set-fontset-font): Use uppercas... # Conflicts: # lisp/vc/vc.el
| * Improve documentation of set-window-startEli Zaretskii2019-04-061-7/+15
| | | | | | | | | | | | | | * doc/lispref/windows.texi (Window Start and End): * src/window.c (Fset_window_start): Document that reliable setting of a window start position requires to adjust point to be visible. (Bug#34038)
| * Improve documentation of window parametersEli Zaretskii2019-04-061-42/+51
| | | | | | | | | | | | | | | | | | * doc/lispref/windows.texi (Cyclic Window Ordering): Describe the effect of the 'other-window' window parameter. (Window Parameters): Improve the descriptions of window parameters. Move the detailed description of the 'quit-restore' window parameter from here... (Quitting Windows): ...to here. (Bug#35063)