1. 05 Jun, 2020 1 commit
  2. 02 Jun, 2020 1 commit
    • Basil L. Contovounesios's avatar
      Improve format-spec documentation (bug#41571) · b07e3b1d
      Basil L. Contovounesios authored
      * doc/lispref/text.texi (Interpolated Strings): Move from here...
      * doc/lispref/strings.texi (Custom Format Strings): ...to here,
      renaming the node and clarifying the documentation.
      (Formatting Strings): End node with sentence referring to the next
      one.
      * lisp/format-spec.el (format-spec): Clarify docstring.
      b07e3b1d
  3. 27 May, 2020 3 commits
  4. 24 May, 2020 1 commit
    • Basil L. Contovounesios's avatar
      Fix Elisp manual entry for format-spec · 4737d0af
      Basil L. Contovounesios authored
      * doc/lispref/text.texi (Interpolated Strings): Fix typos.  Don't
      document modifier for default space padding as it's redundant and
      inconsistent with the docstring and implementation of format-spec.
      4737d0af
  5. 23 May, 2020 1 commit
    • Eli Zaretskii's avatar
      Improve the documentation of setting up fontsets · 1a6d59ee
      Eli Zaretskii authored
      * doc/lispref/display.texi (Fontsets): Improve the accuracy of a
      cross-reference to "Character Properties".
      
      * doc/emacs/mule.texi (Fontsets, Modifying Fontsets): Improve the
      documentation of fontsets and how to modify them.
      1a6d59ee
  6. 21 May, 2020 1 commit
  7. 19 May, 2020 1 commit
  8. 17 May, 2020 2 commits
    • Paul Eggert's avatar
      Minor fixups for mutability doc · b48ab743
      Paul Eggert authored
      * doc/lispref/objects.texi (Mutability): Minor fixups in
      response to a comment by Dmitry Gutov (Bug#40671#477).
      b48ab743
    • Paul Eggert's avatar
      Don’t use “constant” for values you shouldn’t change · 6ac2326e
      Paul Eggert authored
      Inspired by patch proposed by Dmitry Gutov (Bug#40671#393)
      and by further comments by him and by Michael Heerdegen
      in the same bug report.
      * doc/lispintro/emacs-lisp-intro.texi (setcar):
      Don’t push mutability here.
      * doc/lispref/eval.texi (Self-Evaluating Forms, Quoting)
      (Backquote):
      * doc/lispref/lists.texi (Modifying Lists):
      * doc/lispref/objects.texi (Lisp Data Types, Mutability):
      * doc/lispref/sequences.texi (Array Functions, Vectors):
      * doc/lispref/strings.texi (String Basics, Modifying Strings):
      Don’t use the word “constant” to describe all values that
      a program should not change.
      * doc/lispref/objects.texi (Mutability):
      Rename from “Constants and Mutability”.  All uses changed.
      In a footnote, contrast the Emacs behavior with that of Common
      Lisp, Python, etc. for clarity, and say the goal is to be nicer.
      6ac2326e
  9. 14 May, 2020 1 commit
    • Philipp Stephani's avatar
      Fix documentation related to 'command-switch-alist'. · 406fb074
      Philipp Stephani authored
      While there, add a unit test to verify the behavior.
      
      * doc/lispref/os.texi (Command-Line Arguments): Fix documentation: the
      option string in 'command-switch-alist' does include leading hyphens.
      Also mention that 'command-switch-alist' parsing ignores equals signs
      in options.
      
      * test/lisp/startup-tests.el
      (startup-tests/command-switch-alist): New unit test.
      406fb074
  10. 02 May, 2020 1 commit
  11. 30 Apr, 2020 1 commit
  12. 25 Apr, 2020 4 commits
  13. 24 Apr, 2020 1 commit
  14. 22 Apr, 2020 1 commit
    • Paul Eggert's avatar
      Improve wording about constants · 400ff5cd
      Paul Eggert authored
      Thanks to Štěpán Němec and Drew Adams for reviews of recent changes.
      * doc/lispref/eval.texi (Quoting): Give an example.
      * doc/lispref/lists.texi (Association Lists): Simplify example code.
      * doc/lispref/objects.texi (Lisp Data Types)
      (Constants and Mutability): Clarify wording.
      400ff5cd
  15. 20 Apr, 2020 1 commit
  16. 19 Apr, 2020 7 commits
    • Paul Eggert's avatar
      Tweak setcar-related wording · a1040861
      Paul Eggert authored
      * doc/lispref/eval.texi (Self-Evaluating Forms):
      Change “primitives” to “operations”.
      Problem reported by Štěpán Němec in:
      https://lists.gnu.org/r/emacs-devel/2020-04/msg01146.html
      a1040861
    • Paul Eggert's avatar
      Fix mutability glitches reported by Drew Adams · e1d42da0
      Paul Eggert authored
      See Bug#40693#32.
      * doc/lispref/eval.texi (Self-Evaluating Forms, Backquote):
      Say that these yield constant conses, vectors and strings,
      not constant symbols.
      * doc/lispref/objects.texi (Constants and Mutability): Say that an
      attempt to modify a constant variable signals an error, instead of
      saying that it has undefined behavior.
      e1d42da0
    • Paul Eggert's avatar
      Improve mutability doc · 5805df74
      Paul Eggert authored
      See Eli Zaretskii’s suggestions (Bug#40671#33).
      * doc/lispref/lists.texi (Setcar, Setcdr, Rearrangement):
      * doc/lispref/sequences.texi (Sequence Functions)
      (Array Functions):
      Add commentary to examples.
      * doc/lispref/lists.texi (Sets And Lists):
      Revert change to delq example.
      5805df74
    • Paul Eggert's avatar
      Improve mutability documentation · dca35b31
      Paul Eggert authored
      This change was inspired by comments from Štěpán Němec in:
      https://lists.gnu.org/r/emacs-devel/2020-04/msg01063.html
      * doc/lispref/objects.texi (Lisp Data Types): Mention mutability.
      (Constants and mutability): New section.
      * doc/lispintro/emacs-lisp-intro.texi (Lists diagrammed)
      (Indent Tabs Mode): Improve wording.
      * doc/lispref/eval.texi (Self-Evaluating Forms):
      Say that they return constants.
      * doc/lispref/lists.texi (Sets And Lists):
      Fix memql mistake/confusion that I recently introduced.
      dca35b31
    • Paul Eggert's avatar
      Document that quoting yields constants · 81e7d7f1
      Paul Eggert authored
      * doc/lispref/eval.texi (Quoting, Backquote):
      Mention that quoted expressions yield a constant (Bug#40693).
      81e7d7f1
    • Stefan Monnier's avatar
      * doc/lispref/keymaps.texi (Extended Menu Items, Easy Menu) <:key-sequence>: · 5734339f
      Stefan Monnier authored
      Clarify the documentation further
      5734339f
    • Mattias Engdegård's avatar
      Remove #' and function quoting from lambda forms in manual · 14a570af
      Mattias Engdegård authored
      * doc/lispref/abbrevs.texi (Abbrev Expansion):
      * doc/lispref/backups.texi (Reverting):
      * doc/lispref/functions.texi (Mapping Functions):
      * doc/lispref/help.texi (Accessing Documentation):
      * doc/lispref/sequences.texi (Char-Tables):
      * doc/lispref/syntax.texi (Categories):
      * doc/lispref/text.texi (Sorting):
      Remove function quoting from lambda in examples where it still occurs,
      since examples should follow our best style and be consistent.
      14a570af
  17. 18 Apr, 2020 3 commits
    • Paul Eggert's avatar
    • Paul Eggert's avatar
      Document constant vs mutable objects better · eebfb72c
      Paul Eggert authored
      This patch builds on a suggested patch by Mattias Engdegård
      and on further comments by Eli Zaretskii.
      Original bug report by Kevin Vigouroux (Bug#40671).
      * doc/lispintro/emacs-lisp-intro.texi (set & setq, Review)
      (setcar, Lists diagrammed, Mail Aliases, Indent Tabs Mode):
      setq is a special form, not a function or command.
      * doc/lispintro/emacs-lisp-intro.texi (setcar):
      * doc/lispref/lists.texi (Modifying Lists, Rearrangement):
      * doc/lispref/sequences.texi (Sequence Functions)
      (Array Functions, Vectors):
      * doc/lispref/strings.texi (String Basics, Modifying Strings):
      Mention mutable vs constant objects.
      * doc/lispintro/emacs-lisp-intro.texi (setcar, setcdr)
      (kill-new function, cons & search-fwd Review):
      * doc/lispref/edebug.texi (Printing in Edebug):
      * doc/lispref/keymaps.texi (Changing Key Bindings):
      * doc/lispref/lists.texi (Setcar, Setcdr, Rearrangement)
      (Sets And Lists, Association Lists, Plist Access):
      * doc/lispref/sequences.texi (Sequence Functions)
      (Array Functions):
      * doc/lispref/strings.texi (Text Comparison):
      Fix examples so that they do not try to change constants.
      eebfb72c
    • Štěpán Němec's avatar
      067b0705
  18. 15 Apr, 2020 1 commit
  19. 13 Apr, 2020 1 commit
  20. 11 Apr, 2020 1 commit
  21. 10 Apr, 2020 1 commit
  22. 08 Apr, 2020 1 commit
    • Eli Zaretskii's avatar
      Improve documentation of 'jit-lock-contextually' · 18d1bc0a
      Eli Zaretskii authored
      * lisp/jit-lock.el (jit-lock-contextually): Clarify the jit-lock
      operation when 'jit-lock-contextually' is non-nil and non-t.
      
      * doc/lispref/modes.texi (Syntactic Font Lock)
      (Other Font Lock Variables): Document the relation between
      'jit-lock-register', 'font-lock-keywords-only', and syntactic
      refontification.
      18d1bc0a
  23. 09 Mar, 2020 1 commit
  24. 07 Mar, 2020 3 commits