1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-02-03 14:10:47 -08:00
emacs/doc/lispref
Basil L. Contovounesios 0185d76e74 Fix and extend format-spec (bug#41758)
* lisp/format-spec.el: Use lexical-binding.  Remove dependence on
subr-x.el.
(format-spec-make): Clarify docstring.
(format-spec--parse-modifiers): Rename to...
(format-spec--parse-flags): ...this and simplify.  In particular,
don't bother parsing :space-pad which is redundant and unused.
(format-spec--pad): Remove, replacing with...
(format-spec--do-flags): ...this new helper function which performs
more of format-spec's supported text manipulation.
(format-spec): Autoload.  Allow optional argument to take on special
values 'ignore' and 'delete' for more control over what happens when
a replacement for a format specification isn't provided.  Bring back
proper support for a precision modifier similar to that of 'format'.

* lisp/battery.el (battery-format): Rewrite in terms of format-spec.
(battery-echo-area-format, battery-mode-line-format): Mention
support of format-spec syntax in docstrings.

* doc/lispref/strings.texi (Custom Format Strings):
* etc/NEWS: Document and announce these changes.

* lisp/dired-aux.el (dired-do-compress-to):
* lisp/erc/erc-match.el (erc-log-matches):
* lisp/erc/erc.el (erc-update-mode-line-buffer):
* lisp/gnus/gnus-sieve.el (gnus-sieve-update):
* lisp/gnus/gssapi.el (open-gssapi-stream):
* lisp/gnus/mail-source.el (mail-source-fetch-file)
(mail-source-fetch-directory, mail-source-fetch-pop)
(mail-source-fetch-imap):
* lisp/gnus/message.el (message-insert-formatted-citation-line):
* lisp/image-dired.el:
* lisp/net/eww.el:
* lisp/net/imap.el (imap-kerberos4-open, imap-gssapi-open)
(imap-shell-open):
* lisp/net/network-stream.el (network-stream-open-shell):
* lisp/obsolete/tls.el (open-tls-stream):
* lisp/textmodes/tex-mode.el:
Remove extraneous loads and autoloads of format-spec now that it is
autoloaded and simplify its uses where possible.

* test/lisp/battery-tests.el (battery-format): Test new format-spec
support.
* test/lisp/format-spec-tests.el (test-format-spec): Rename to...
(format-spec) ...this, extending test cases.
(test-format-unknown): Rename to...
(format-spec-unknown): ...this, extending test cases.
(test-format-modifiers): Rename to...
(format-spec-flags): ...this.
(format-spec-make, format-spec-parse-flags, format-spec-do-flags)
(format-spec-do-flags-truncate, format-spec-do-flags-pad)
(format-spec-do-flags-chop, format-spec-do-flags-case): New tests.
2020-06-18 12:46:21 +01:00
..
abbrevs.texi Remove #' and function quoting from lambda forms in manual 2020-04-19 13:19:37 +02:00
anti.texi ; * doc/lispref/anti.texi (Antinews): Fix typo. 2020-01-11 14:14:11 +01:00
back.texi Update copyright year to 2020 2020-01-01 00:59:52 +00:00
backups.texi Remove #' and function quoting from lambda forms in manual 2020-04-19 13:19:37 +02:00
book-spine.texi Fix single-quoting style in PDF manuals 2015-05-01 12:06:38 -07:00
buffers.texi Update copyright year to 2020 2020-01-01 00:59:52 +00:00
ChangeLog.1 Update copyright year to 2020 2020-01-01 00:59:52 +00:00
commands.texi Update copyright year to 2020 2020-01-01 00:59:52 +00:00
compile.texi Document that 'byte-compile-dynamic' is obsolete 2020-03-07 14:23:23 +02:00
control.texi Fix some Texinfo markup 2020-06-17 13:07:51 +01:00
customize.texi Fix typo in "(elisp) Type Keywords" 2020-06-07 16:46:12 +01:00
debugging.texi Fix some Texinfo markup 2020-06-17 13:07:51 +01:00
display.texi Merge from origin/emacs-27 2020-06-07 09:03:59 -07:00
doclicense.texi Merge from Gnulib 2017-10-01 18:31:10 -07:00
edebug.texi Merge from origin/emacs-27 2020-05-28 07:50:26 -07:00
elisp.texi Don’t use “constant” for values you shouldn’t change 2020-05-16 18:24:07 -07:00
errors.texi Clean up D-Bus documentation (bug#41744) 2020-06-08 18:19:50 +01:00
eval.texi Don’t use “constant” for values you shouldn’t change 2020-05-16 18:24:07 -07:00
files.texi Merge from origin/emacs-27 2020-06-17 08:47:53 -07:00
frames.texi Merge from origin/emacs-27 2020-06-17 08:47:53 -07:00
functions.texi Remove #' and function quoting from lambda forms in manual 2020-04-19 13:19:37 +02:00
gpl.texi Merge from Gnulib 2017-10-01 18:31:10 -07:00
hash.texi Update copyright year to 2020 2020-01-01 00:59:52 +00:00
help.texi Remove #' and function quoting from lambda forms in manual 2020-04-19 13:19:37 +02:00
hooks.texi Update copyright year to 2020 2020-01-01 00:59:52 +00:00
index.texi Fix minor whitespace issues after "." in manual. 2012-12-05 14:27:56 -08:00
internals.texi ; * doc/lispref/internals.texi (Module Misc): Fix version 2020-03-29 10:22:35 +02:00
intro.texi Update copyright year to 2020 2020-01-01 00:59:52 +00:00
keymaps.texi Merge from origin/emacs-27 2020-04-20 07:50:19 -07:00
lay-flat.texi Update copyright year to 2020 2020-01-01 00:59:52 +00:00
lists.texi Don’t use “constant” for values you shouldn’t change 2020-05-16 18:24:07 -07:00
loading.texi Merge from origin/emacs-27 2020-05-28 07:50:26 -07:00
macros.texi Update copyright year to 2020 2020-01-01 00:59:52 +00:00
Makefile.in Prefer saying "Info manual" to "info page" in docs 2020-01-23 14:44:27 +01:00
maps.texi Update copyright year to 2020 2020-01-01 00:59:52 +00:00
markers.texi Update copyright year to 2020 2020-01-01 00:59:52 +00:00
minibuf.texi Merge from origin/emacs-27 2020-03-07 07:50:28 -08:00
modes.texi Add lisp-data-mode for editing non-code Lisp data 2020-05-01 12:11:10 +01:00
nonascii.texi Revert markup change in with-coding-priority docs 2020-06-13 17:54:51 +01:00
numbers.texi Clarify when fixnums are used. 2020-02-17 13:54:36 -08:00
objects.texi Merge from origin/emacs-27 2020-05-23 07:50:29 -07:00
os.texi Merge from origin/emacs-27 2020-06-17 08:47:53 -07:00
package.texi Update copyright year to 2020 2020-01-01 00:59:52 +00:00
positions.texi Update copyright year to 2020 2020-01-01 00:59:52 +00:00
processes.texi Introduce process-file-return-signal-string 2020-05-16 14:04:07 +02:00
README Update copyright year to 2020 2020-01-01 00:59:52 +00:00
records.texi Update copyright year to 2020 2020-01-01 00:59:52 +00:00
searching.texi Regexps cannot infloop; fix manual 2020-05-03 14:27:51 +02:00
sequences.texi Don’t use “constant” for values you shouldn’t change 2020-05-16 18:24:07 -07:00
spellfile Update lispref spellfile 2019-06-04 08:34:16 -07:00
streams.texi * doc/lispref/streams.texi (Output Functions): Improve indexing. 2020-01-25 19:15:32 +01:00
strings.texi Fix and extend format-spec (bug#41758) 2020-06-18 12:46:21 +01:00
symbols.texi Update copyright year to 2020 2020-01-01 00:59:52 +00:00
syntax.texi Remove #' and function quoting from lambda forms in manual 2020-04-19 13:19:37 +02:00
text.texi Merge from origin/emacs-27 2020-06-17 08:47:53 -07:00
threads.texi Update copyright year to 2020 2020-01-01 00:59:52 +00:00
tips.texi Recommend to avoid unnecessary abbreviations in doc 2020-04-30 18:02:28 +02:00
two-volume-cross-refs.txt Update copyright year to 2020 2020-01-01 00:59:52 +00:00
two-volume.make Update copyright year to 2020 2020-01-01 00:59:52 +00:00
variables.texi Document changes in lexical-binding 2020-03-07 13:32:52 +02:00
windows.texi Merge from origin/emacs-27 2020-04-15 07:50:15 -07:00

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Copyright (C) 2001-2020 Free Software Foundation, Inc.  -*- outline -*-
See the end of the file for license conditions.


README for the Emacs Lisp Reference Manual.

* This directory contains the texinfo source files for the Emacs Lisp
Reference Manual.

* Report bugs in the Lisp Manual (or in Emacs) using M-x report-emacs-bug.
To ask questions, use the help-gnu-emacs mailing list.

* The Emacs Lisp Reference Manual is quite large.  It totals around
1100 pages in smallbook format; the info files total around 3.0 megabytes.

* You can format this manual for Info, for printing hardcopy using TeX,
or for HTML.

* You can buy nicely printed copies from the Free Software Foundation.
Buying a manual from the Free Software Foundation helps support our GNU
development work.  See <https://shop.fsf.org/>.
(At time of writing, this manual is out of print.)

* The master file for formatting this manual for Tex is called 'elisp.texi'.
It contains @include commands to include all the chapters that make up
the manual.

* This distribution contains a Makefile that you can use with GNU Make.

** To make an Info file, you need to install Texinfo, then run 'make info'.

** Use 'make elisp.pdf' or 'make elisp.html' to create PDF or HTML versions.


This file is part of GNU Emacs.

GNU Emacs is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

GNU Emacs is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with GNU Emacs.  If not, see <https://www.gnu.org/licenses/>.