aboutsummaryrefslogtreecommitdiffstats
path: root/doc (follow)
Commit message (Collapse)AuthorAgeFilesLines
* Fix wording in Elisp manual's child frames section (Bug#28819)Martin Rudalics2017-10-141-1/+1
| | | | * doc/lispref/frames.texi (Child Frames): Fix wording (Bug#28819).
* Simplify Flymake user documentationJoão Távora2017-10-121-109/+57
| | | | | | | | | | | | | | | | | | | | | | | Fix some confusing parts of Flymake user documentation, like a repeated listing of situations leading to a syntax check. Documentation is now divided into three chapters only: "Using Flymake", "Extending Flymake", and a chapter for the legacy backend. Obsolete mention of "errors" and "lines" is replaced by "diagnostics/problems" and "regions" where appropriate. * doc/misc/flymake.texi (Overview of Flymake): Delete chapter. (Using Flymake): Merge with chapter "Overview of Flymake". (Installing Flymake): Delete chapter. (Flymake mode, Running the syntax check) (Navigating to error lines): Delete sections. (Syntax check statuses): Review and augment with x-references. (Backend exceptions): Mention shortcut in menu. * lisp/progmodes/flymake.el (flymake-menu): Tweak minor mode menu to not speak of "errors". (flymake-goto-next-error, flymake-goto-prev-error): Fix wording.
* Format shell commands in tramp.texiMichael Albinus2017-10-111-11/+11
| | | | | * doc/misc/tramp.texi (Obtaining Tramp, Remote shell setup): Format shell commands better.
* Improve the Flymake manualEli Zaretskii2017-10-101-166/+219
| | | | | | | | | | | | | | | | | | | | | | | | * doc/misc/flymake.texi: Add a 'coding' cookie. Add a @syncodeindex directive for @vindex. Use 2 spaces between sentences. Lower-case @cindex entries. (Overview of Flymake): Fix use of @itemize and @pxref. Fix punctuation and markup. (Backend exceptions): Use @emph instead of @dfn. Add more indexing. (Customizable variables, Extending Flymake): Improve wording. (Flymake error types): Fix usage of @itemize. Improve wording. (Backend functions): Fix punctuation. Fix markup. Add a cross-reference to ELisp manual. (Flymake utility functions): Add a cross-reference to ELisp manual. (An annotated example backend): Fix punctuation and typos. (Flymake mode, Running the syntax check) (Navigating to error lines, Backend exceptions) (Customizable variables, Flymake error types, Backend functions) (Flymake utility functions, Proc customization variables) (Locating a master file, Locating the buildfile) (Starting the syntax check process, Parsing the output) (Interaction with other modes): Fix indexing. Add index entries for functions, variables, and concepts.
* Add full documentation on new Flymake APIJoão Távora2017-10-101-41/+423
| | | | | | | | | | | | | | | | | | | | Also, as a minor addition to this API, set flymake-text on the diagnostic overlay. This enables a good example in the section "Customization Flymake annotations". * doc/misc/flymake.texi (Overview of Flymake) (Syntax check statuses): Rework. (Backend exceptions): Rename from "Troubleshooting" (Customizable variables): Add flymake-start-on-flymake-mode. Rework. (Extending Flymake): Write chapter. (Customizing Flymake annotations, Flymake backends) (Flymake utility functions, An annotated example backend): New sections and subsections * lisp/progmodes/flymake.el (flymake-diagnostic-functions) (flymake-diagnostic-types-alist): Rework docstring. (flymake--highlight-line): Set and use flymake-text property in overlay. (flymake-goto-next-error, flymake-goto-prev-error): Fix funny quotes.
* ; Typo fixes, mostly repeated wordsPaul Eggert2017-10-099-9/+9
|
* Describe how window dividers can replicate vertical borders (Bug#27830)Martin Rudalics2017-10-091-1/+20
| | | | | | | | * doc/emacs/frames.texi (Scroll Bars): Describe how window dividers can be used to replicate vertical borders when scroll bars are disabled (Bug#27830). * doc/emacs/frames.texi (Window Dividers): Mention their use in replicating vertical borders.
* Fix @include directive in Flymake docJoão Távora2017-10-061-1/+1
| | | | * doc/misc/flymake.texi: Don't @include a relative path.
* Fix typos in Flymake documentationLele Gaifax2017-10-061-5/+5
| | | | | | | | | | | | | | | | | | | | * doc/misc/flymake.texi (Syntax check statuses) (Adding support for a new syntax check tool) (Implementation overview, Locating the buildfile): Fix typos. * lisp/progmodes/flymake-proc.el (flymake-proc--report-fn) (flymake-proc--find-possible-master-files):Fix typos. (flymake-proc--panic) (flymake-proc-legacy-flymake): Fix function reference in doc. * lisp/progmodes/flymake.el (flymake-error) (flymake-diagnostic-functions): Fix typos. (flymake-diagnostic-types-alist): Rephrase and fix typos. (flymake--backend-state): Fix typos and rephrase. (flymake--handle-report): Delete empty line. (flymake--disable-backend) (flymake--run-backend): Fix typos. (flymake-goto-next-error, flymake-goto-prev-error): Rephrase.
* Update Org to v9.1.2Rasmus2017-10-051-10/+9
| | | | Please note this is a bugfix release. See etc/ORG-NEWS for details.
* Speed up (format "%s" STRING) and the likePaul Eggert2017-10-041-3/+7
| | | | | | | | | | | | | | | | | | | | | | Although the Lisp manual said that ‘format’ returns a newly-allocated string, this was not true for a few cases like (format "%s" ""), and fixing the documentation to allow reuse of arguments lets us improve performance in common cases like (format "foo") and (format "%s" "foo") (Bug#28625). * doc/lispref/strings.texi (Formatting Strings): * etc/NEWS: Say that the result of ‘format’ might not be newly allocated. * src/callint.c (Fcall_interactively): * src/dbusbind.c (XD_OBJECT_TO_STRING): * src/editfns.c (Fmessage, Fmessage_box): * src/xdisp.c (vadd_to_log, Ftrace_to_stderr): Just use Fformat or Fformat_message, as that’s simpler and no longer makes unnecessary copies. * src/editfns.c (styled_format): Remove last argument, as it is no longer needed: all callers now want it to behave as if it were true. All remaining callers changed. Make this function static again. Simplify the function now that we no longer need to worry about whether the optimization is allowed.
* Start rewriting Flymake manualJoão Távora2017-10-031-301/+237
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Missing the parts pertaining to the new customization API. * doc/misc/flymake.texi (Overview of Flymake): Rewrite a bit. (Installing Flymake): Delete most of this. (Running the syntax check): Mention flymake-start. (Navigating to error lines): Rewrite. (Viewing error messages): Commente out. (Syntax check statuses, Troubleshooting): Rewrite a bit. (Customizable variables): New section under "Using Flymake". Don't mention any proc variables here. (Configuring Flymake): Delete (Proc backend): New chapter (Proc customization variables): New chapter. * doc/misc/flymake.texi (Overview of Flymake): Rewrite a bit. (Installing Flymake): Mostly scratch. Flymake comes with Emacs. (Running the syntax check): Simplify. (Viewing error messages): Dekete, (Syntax check statuses): Rewrite. (Troubleshooting): Simplify. (Customizable variables): Rewrite. (Extending Flymake): New chapter, empty for now. (The legacy Proc backend): New chapter. (Proc customizable variables) (Adding support for a new syntax check tool) (Implementation overview) (Making a temporary copy) (Locating a master file) (Getting the include directories) (Locating the buildfile) (Starting the syntax check process) (Parsing the output) (Interaction with other modes) (Example---Configuring a tool called via make) (Example---Configuring a tool called directly): Rewrite a bit.
* Fix three Flymake bugs when checking C header filesJoão Távora2017-10-031-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The first of these problems is longstanding: if an error-less B.h is included from error-ridden A.h, flymake's legacy parser will panic (and disable itself) since it sees a non-zero exit for a clean file. To fix this, recommend returning 'true' in the documentation for the check-syntax target. Another problem was introduced by the parser rewrite. For error patterns spanning more than one line, point may be left in the middle of a line and thus render other patterns useless. Those patterns were written for the old line-by-line parser. To make them useful again, move to the beginning of line in those situations. The third problem was also longstanding and happened on newer GCC's: The "In file included from" prefix confused flymake-proc-get-real-file-name. Fix this. Also updated flymake--diag-region to fallback to highlighting a full line less often. Add automatic tests to check this. * lisp/progmodes/flymake-proc.el (flymake-proc--diagnostics-for-pattern): Fix bug when patterns accidentally spans more than one line. Don't create diagnostics without error messages. (flymake-proc-real-file-name-considering-includes): New helper. (flymake-proc-allowed-file-name-masks): Use it. * lisp/progmodes/flymake.el (flymake-diag-region): Make COL argument explicitly optional. Only fall back to full line in extreme cases. * test/lisp/progmodes/flymake-tests.el (included-c-header-files): New test. (different-diagnostic-types): Update. * test/lisp/progmodes/flymake-resources/Makefile (check-syntax): Always return success (0) error code. (CC_OPTS): Add -Wextra * test/lisp/progmodes/flymake-resources/errors-and-warnings.c (main): Rewrite comments. * test/lisp/progmodes/flymake-resources/errors-and-warnings.c: Include some dummy header files. * test/lisp/progmodes/flymake-resources/no-problems.h: New file. * test/lisp/progmodes/flymake-resources/some-problems.h: New file. * doc/misc/flymake.texi (Example---Configuring a tool called via make): Recommend adding "|| true" to the check-syntax target.
* Prefer HTTPS to HTTP for gnu.orgPaul Eggert2017-10-0111-25/+25
| | | | | | | | | This fixes some URLs I omitted from my previous pass, notably those in lists.gnu.org. Although lists.gnu.org does not yet support TLS 1.1, TLS 1.0 is better than nothing. * lisp/erc/erc.el (erc-official-location): * lisp/mail/emacsbug.el (report-emacs-bug): Use https:, not http:.
* Merge from GnulibPaul Eggert2017-10-017-19/+19
| | | | | | | | | | | | This is mostly to change http: to https: in licenses. * COPYING, build-aux/config.guess, build-aux/config.sub: * doc/emacs/doclicense.texi, doc/emacs/gpl.texi: * doc/lispintro/doclicense.texi, doc/lispref/doclicense.texi: * doc/lispref/gpl.texi, doc/misc/doclicense.texi: * doc/misc/gpl.texi, etc/COPYING, leim/COPYING: * lib-src/COPYING, lib/COPYING, lisp/COPYING, lwlib/COPYING: * msdos/COPYING, nt/COPYING, src/COPYING: Copy from Gnulib.
* Doc amendment for syntax-ppss.Alan Mackenzie2017-10-011-6/+7
| | | | | | * doc/elisp/syntax.texi (Position Parse): Note, twice, that syntax-ppss is equivalent to parse-partial-sexp from the beginning of THE VISIBLE PART OF the buffer. Final part of the fix for bug #22983.
* Remove inadvertent changes to syntax.texi in last commit.Alan Mackenzie2017-10-011-7/+6
| | | | * doc/lispref/syntax.texi (Position Parse): revert changes.
* Amend documentation for text-quoting-style becoming a user option.Alan Mackenzie2017-10-016-37/+70
| | | | | | | | | | | | | | * doc/lispref/control.texi (Signaling Errors): * doc/lispref/display.texi (Displaying Messages): * doc/lispref/strings.texi (Formatting Strings): Edit for brevity, farming out the details to the new Text Quoting Style node. * doc/lispref/help.texi (Text Quoting Style): New section. Move detailed discussion of text-quoting-style here. Add discussion about how to output grave accent and apostrophe in documentation and messages. Adjust xrefs to point to this section when appropriate. * etc/NEWS: text-quoting-style semantics have not changed.
* Make the value nil in text-quoting-style mean what it does in Emacs 25.Alan Mackenzie2017-10-014-11/+11
| | | | | | | | | | | | | | | | | | | | This is a partial reversion of yesterday's commit by the same author, which changed the meaning of nil and introduced the new value t. * src/doc.c (text_quoting_style, text-quoting-style) (internal--text-quoting-flag): Revert yesterday's changes. * lisp/cus-start.el: (top level): Amend the entry for text-quoting-style. * etc/NEWS: Amend the entry for text-quoting-style. * doc/lispref/control.texi (Signalling Errors) * doc/lispref/display.texi (Displaying Messages) * doc/lispref/strings.texi (Formatting Strings): Bind text-quoting-style to grave rather than nil to inhibit translation of quotes. * doc/lispref/help.texi (Keys in Documentation): Revert the description of the proposed new default, t.
* Make text-quoting-style customizable. Introduce t and new meaning for nil.Alan Mackenzie2017-10-015-21/+38
| | | | | | | | | | | | | | | | | | | | | | | | | | A value of nil for text-quoting-style now means "no translation". t means "Use curved quotes if displayable". * src/doc.c (text-quoting-style (function)): modify for new semantics. (text-quoting-style (variable)): Amend the doc string, set the default value to t. * lisp/cus-start.el: (top level): Create a customize entry for text-quoting-style in group display. * etc/NEWS: Amend the entry for text-quoting-style. * doc/emacs/display.texi (Text Display): Describe the translation of ASCII quotes to curved quotes, and how to influence or inhibit it. * doc/lispref/control.texi (Signalling Errors) * doc/lispref/display.texi (Displaying Messages) * doc/lispref/strings.texi (Formatting Strings): Describe binding text-quoting-style to nil to inhibit unwanted quote translation. * doc/lispref/help.texi (Keys in Documentation): Change text-quoting-style from a variable to a user option. Describe its changed set of values. State that it can be customized freely.
* eshell.texi improvementsMichael Albinus2017-10-011-2/+6
| | | | | | * doc/misc/eshell.texi (Built-ins): eshell/sudo is a compiled Lisp function in `em-tramp.el'. Mention also $*, $1, $2, ... (Aliases): Add $*, $1, $2, ... to the variable index.
* Fix reference style in org.texiMartin Rudalics2017-10-011-1/+1
| | | | * doc/misc/org.texi (A Texinfo example): Fix reference style.
* Improve handling of iconification of child frames (Bug#28611)Martin Rudalics2017-10-011-5/+25
| | | | | | | | | | * src/frame.c (Ficonify_frame): Handle `iconify-child-frame' option. (syms_of_frame): New symbols Qiconify_top_level and Qmake_invisible. (iconify_child_frame): New option. * lisp/cus-start.el (iconify-child-frame): Add customization properties. * doc/lispref/frames.texi (Child Frames): Describe new option `iconify-child-frame'. Don't index "top-level frame" twice.
* Revert "Don't lose arguments to eshell aliases (Bug#27954)"Noam Postavsky2017-09-301-1/+8
| | | | | | | | | It broke the established argument handling methods provided by eshell aliases (Bug#28568). * doc/misc/eshell.texi (Aliases): Fix example, call out use of arguments in aliases. * lisp/eshell/em-alias.el (eshell-maybe-replace-by-alias): Ignore ARGS.
* Bind vc-region-historyKaushal Modi2017-09-302-11/+11
| | | | | | | | | | * lisp/vc/vc-hooks.el (vc-prefix-map): Bind `vc-region-history' to 'C-x v h', which was earlier bound to `vc-insert-headers' (Bug#27644). * doc/emacs/maintaining.texi (VC Change Log): Mention the new binding. * doc/emacs/vc1-xtra.texi (Version Headers): Remove the association of 'C-x v h' with `vc-insert-headers'. (http://lists.gnu.org/archive/html/emacs-devel/2017-09/msg00957.html)
* Improve documentation of 'copy-sequence'Eli Zaretskii2017-09-301-1/+4
| | | | | | * src/fns.c (Fcopy_sequence): * doc/lispref/sequences.texi (Sequence Functions): Mention the exception when copying an empty sequence. (Bug#28627)
* Minor update of ack.texiEli Zaretskii2017-09-301-2/+2
| | | | | * doc/emacs/ack.texi (Acknowledgments): Update Eli Zaretskii's contributions.
* * doc/emacs/emacs.texi (Acknowledgments): Add more contributors.N. Jackson2017-09-301-7/+7
| | | | Copyright-paperwork-exempt: yes
* Improve indexing of multi-file/buffer Isearch commandsEli Zaretskii2017-09-302-10/+17
| | | | | | | | | * doc/emacs/maintaining.texi (Identifier Search): Change wording of index entries to make them different from those for multi-file isearch commands. (Bug#28584) * doc/emacs/search.texi (Other Repeating Search): Index the multi-* commands. (Bug#28584) Rearrange the indexing to keep each index entry close to its subject.
* Fix uses of @kindex in the Emacs manualEli Zaretskii2017-09-304-11/+11
| | | | | | | | | * doc/emacs/programs.texi (Expressions, Semantic, Hungry Delete): * doc/emacs/mark.texi (Global Mark Ring) (Disabled Transient Mark): * doc/emacs/buffers.texi (Select Buffer): * doc/emacs/mule.texi (File Name Coding): Fix @kindex entries which used @key. Reported by Marcin Borkowski <mbork@mbork.pl>.
* Prefer HTTPS to HTTP for gnu.orgPaul Eggert2017-09-295-6/+6
| | | | | This catches some URLs I missed in my previous scan, or perhaps were added after the scan.
* ; Spelling fixesPaul Eggert2017-09-291-1/+1
|
* Merge branch 'emacs-26' into scratch/org-mode-mergeRasmus2017-09-2913-57/+119
|\
| * Fix documentation of `make-frame' and related variables and hooksMartin Rudalics2017-09-251-24/+34
| | | | | | | | | | | | | | | | * lisp/frame.el (before-make-frame-hook) (after-make-frame-functions, frame-inherited-parameters) (make-frame): Fix doc-strings. * doc/lispref/frames.texi (Creating Frames): Fix description of `make-frame' and related variables and hooks.
| * Accept new `always' value for option `buffer-offer-save'Eric Abrahamsen2017-09-242-8/+10
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Also revert ee512e9a82 * lisp/files.el (buffer-offer-save): In addition to nil and t, now allows a third symbol value, `always'. A buffer where this option is set to `always' will always be offered for save by `save-some-buffers'. (save-some-buffers): Check the exact value of this buffer-local variable. No longer check the buffer name, or the value of `write-contents-functions'. * doc/lispref/buffers.texi (Killing Buffers): Note change in manual. * doc/lispref/files.texi (Saving Buffers): Remove note about buffer names. * etc/NEWS: Mention in NEWS.
| * Document 'replace-buffer-contents' in the manual.Philipp Stephani2017-09-241-0/+24
| | | | | | | | * doc/lispref/text.texi (Replacing): New node.
| * ; * doc/emacs/display.texi (Display Custom): Fix wording.Eli Zaretskii2017-09-231-1/+1
| |
| * Documentation improvements for 'display-line-numbers'Eli Zaretskii2017-09-231-1/+12
| | | | | | | | | | * doc/emacs/display.texi (Display Custom): Document a few more options for display-line-numbers. (Bug#28533) Fix a typo.
| * Document the 'list-FOO' conventionEli Zaretskii2017-09-221-4/+7
| | | | | | | | | | * doc/lispref/tips.texi (Coding Conventions): Document the list-FOO convention.
| * * doc/lispref/strings.texi (Formatting Strings): Improve indexing.Eli Zaretskii2017-09-201-2/+3
| |
| * Rename timer-list to list-timersMark Oteiza2017-09-192-3/+3
| | | | | | | | | | | | | | | | * doc/emacs/anti.texi (Antinews): * doc/lispref/os.texi (Timers): * etc/NEWS: * lisp/emacs-lisp/timer-list.el: (timer-list-mode): Rename timer-list to list-timers.
| * Fix a minor inaccuracy in the Emacs manualEli Zaretskii2017-09-191-5/+5
| | | | | | | | | | | | | | * doc/emacs/cmdargs.texi (Action Arguments): Don't mention 'find-file', as the implementation has changed. Reported by Everton J. Carpes <everton.carpes@gmail.com> in http://lists.gnu.org/archive/html/help-gnu-emacs/2017-09/msg00146.html.
| * Ignore buffers whose name begins with a space in save-some-buffersEric Abrahamsen2017-09-181-3/+6
| | | | | | | | | | | | * lisp/files.el (save-some-buffers): Consider these buffers "internal", and don't prompt the user to save them. * doc/lispref/files.texi: Document.
| * Minor Tramp doc updateMichael Albinus2017-09-181-0/+8
| | | | | | | | | | * doc/misc/tramp.texi (Frequently Asked Questions): Mention `vc-handled-backends'.
| * Merge from GnulibPaul Eggert2017-09-171-7/+7
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This incorporates: 2017-09-16 manywarnings: port to GCC on 64-bit MS-Windows 2017-09-13 all: Replace many more http URLs by https URLs * build-aux/config.guess, build-aux/config.sub: * build-aux/gitlog-to-changelog, doc/misc/texinfo.tex: * lib/allocator.h, lib/count-leading-zeros.h: * lib/count-trailing-zeros.h, lib/dup2.c, lib/filevercmp.c: * lib/fstatat.c, lib/fsync.c, lib/ftoastr.c, lib/ftoastr.h: * lib/intprops.h, lib/signal.in.h, lib/stdio-impl.h, lib/stdio.in.h: * lib/unistd.in.h, lib/utimens.c, m4/alloca.m4, m4/extern-inline.m4: * m4/fstatat.m4, m4/gnulib-common.m4, m4/manywarnings.m4: * m4/std-gnu11.m4, m4/sys_types_h.m4, m4/vararrays.m4: Copy from Gnulib. * lib/gnulib.mk.in: Regenerate.
| * Adapt Tramp version. Do not mergeMichael Albinus2017-09-171-1/+1
| | | | | | | | | | | | | | * doc/misc/trampver.texi: * lisp/net/trampver.el: Change version to "2.3.3.26.1". (customize-package-emacs-version-alist): Add Tramp version integrated in Emacs 26.1.
* | Update Org to v9.1.1Rasmus2017-09-181-187/+220
|/ | | | Please see etc/ORG-NEWS for major changes.
* Disable execution of unsafe Lisp by Enriched Text modeEli Zaretskii2017-09-162-0/+28
| | | | | | | | | | | | | | | | | | | | | | | | | | * src/xdisp.c (handle_display_spec): If the display property is wrapped in 'disable-eval' form, disable Lisp evaluation while processing this property. (handle_single_display_spec): Accept new argument ENABLE_EVAL_P. If that argument is false, don't evaluate Lisp while processing display properties. * lisp/textmodes/enriched.el (enriched-allow-eval-in-display-props): New defcustom. (enriched-decode-display-prop): If enriched-allow-eval-in-display-props is nil, wrap the display property with 'disable-eval' to disable Lisp evaluation when the display property is processed for display. (Bug#28350) * lisp/gnus/mm-view.el (mm-inline-text): Re-enable processing of enriched text. * doc/lispref/display.texi (Display Property): Document the 'disable-eval' wrapping of 'display' properties. * doc/emacs/text.texi (Enriched Properties): Document 'enriched-allow-eval-in-display-props'. * etc/NEWS: Describe the security issues with Enriched Text mode and their solution.
* Prefer HTTPS to FTP and HTTP in documentationPaul Eggert2017-09-1356-171/+169
| | | | | | | | | | | | | Most of this change is to boilerplate commentary such as license URLs. This change was prompted by ftp://ftp.gnu.org's going-away party, planned for November. Change these FTP URLs to https://ftp.gnu.org instead. Make similar changes for URLs to other organizations moving away from FTP. Also, change HTTP to HTTPS for URLs to gnu.org and fsf.org when this works, as this will further help defend against man-in-the-middle attacks (for this part I omitted the MS-DOS and MS-Windows sources and the test tarballs to keep the workload down). HTTPS is not fully working to lists.gnu.org so I left those URLs alone for now.
* Remove "baroque" use of prefix argument from gensymMark Oteiza2017-09-131-2/+1
| | | | | | | | | 'cl-gensym' was simply moved here, but let us take an opportunity to shed some historical baggage. * lisp/subr.el (gensym): Remove special treatment of PREFIX as a number. Use "g" as prefix to differentiate from cl-gensym defaults. * doc/lispref/symbols.texi (Creating Symbols): Update accordingly. * lisp/emacs-lisp/cl-macs.el (cl--gensym-counter, cl-gensym): Restore.
generated by cgit v1.2.1 (git 2.18.0) at 2026-03-06 13:34:32 +0000