1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-01-05 19:31:02 -08:00
emacs/doc/lispref
Paul Eggert 0921dbc3ab Improve time stamp handling, and be more consistent about it.
This implements a suggestion made in:
http://lists.gnu.org/archive/html/emacs-devel/2014-10/msg00587.html
Among other things, this means timer.el no longer needs to
autoload the time-date module.
* doc/lispref/os.texi (Time of Day, Time Conversion, Time Parsing)
(Processor Run Time, Time Calculations):
Document the new behavior, plus be clearer about the old behavior.
(Idle Timers): Take advantage of new functionality.
* etc/NEWS: Document the changes.
* lisp/allout-widgets.el (allout-elapsed-time-seconds): Doc fix.
* lisp/arc-mode.el (archive-ar-summarize):
* lisp/calendar/time-date.el (seconds-to-time, days-to-time, time-since):
* lisp/emacs-lisp/timer.el (timer-relative-time, timer-event-handler)
(run-at-time, with-timeout-suspend, with-timeout-unsuspend):
* lisp/net/tramp.el (tramp-time-less-p, tramp-time-subtract):
* lisp/proced.el (proced-time-lessp):
* lisp/timezone.el (timezone-time-from-absolute):
* lisp/type-break.el (type-break-schedule, type-break-time-sum):
Simplify by using new functionality.
* lisp/calendar/cal-dst.el (calendar-next-time-zone-transition):
Do not return time values in obsolete and undocumented (HI . LO)
format; use (HI LO) instead.
* lisp/calendar/time-date.el (with-decoded-time-value):
Treat 'nil' as current time.  This is mostly for XEmacs.
(encode-time-value, with-decoded-time-value): Obsolete.
(time-add, time-subtract, time-less-p): Use no-op autoloads, for
XEmacs.  Define only if XEmacs, as they're now C builtins in Emacs.
* lisp/ldefs-boot.el: Update to match new time-date.el
* lisp/proced.el: Do not require time-date.
* src/editfns.c (invalid_time): New function.
Use it instead of 'error ("Invalid time specification")'.
(time_add, time_subtract, time_arith, Ftime_add, Ftime_less_p)
(decode_float_time, lisp_to_timespec, lisp_time_struct):
New functions.
(make_time_tail, make_time): Remove.  All uses changed to use
new functions or plain list4i.
(disassemble_lisp_time): Return effective length if successful.
Check that LOW is an integer, if it's combined with other components.
(decode_time_components): Decode into struct lisp_time, not
struct timespec, so that we can support a wide set of times
regardless of whether time_t is signed.  Decode plain numbers
as seconds since the Epoch, and nil as the current time.
(lisp_time_argument, lisp_seconds_argument, Ffloat_time):
Reimplement in terms of new functions.
(Fencode_time): Just use list2i.
(syms_of_editfns): Add time-add, time-subtract, time-less-p.
* src/keyboard.c (decode_timer): Don't allow the new formats (floating
point or nil) in timers.
* src/systime.h (LO_TIME_BITS): New constant.  Use it everywhere in
place of the magic number '16'.
(struct lisp_time): New type.
(decode_time_components): Use it.
(lisp_to_timespec): New decl.
2014-11-16 20:41:22 -08:00
..
.gitignore
abbrevs.texi Doc updates re abbrev-expand-function 2014-05-26 18:09:45 -07:00
anti.texi Doc fixes: markup (mainly nil -> @code{nil}) 2014-06-08 16:39:23 -07:00
back.texi Specify .texi encoding. 2014-01-05 21:25:46 -08:00
backups.texi Doc updates for buffer-stale-function now applying to file buffers too 2014-04-03 22:09:35 -04:00
book-spine.texi Specify .texi encoding. 2014-01-05 21:25:46 -08:00
buffers.texi Small doc/ fixes re @var usage. 2014-10-03 23:35:55 -07:00
ChangeLog Improve time stamp handling, and be more consistent about it. 2014-11-16 20:41:22 -08:00
commands.texi Merge from emacs-24; up to 2014-07-20T16:14:58Z!dmantipov@yandex.ru 2014-10-04 00:05:21 -07:00
compile.texi More doc updates. 2014-01-06 07:36:13 +08:00
control.texi Merge from emacs-24; up to 2014-07-26T11:58:24Z!schwab@linux-m68k.org 2014-10-12 15:56:45 -07:00
customize.texi Recommend not modifying :set's value arg in defcustom (bug#16755). 2014-03-19 00:31:17 +01:00
debugging.texi * doc/lispref/debugging.texi (Function Debugging, Debugger Commands): 2014-07-08 14:24:39 -04:00
display.texi Merge from trunk and resolve conflicts. 2014-10-14 21:10:37 +03:00
doclicense.texi Update licenses to latest version from FSF. 2012-12-06 00:33:32 -08:00
edebug.texi Update copyright year to 2014 by running admin/update-copyright. 2014-01-01 07:43:34 +00:00
elisp.texi Merge from emacs-24; up to 2014-07-26T11:58:24Z!schwab@linux-m68k.org 2014-10-12 15:56:45 -07:00
errors.texi Make up-list and backward-up-list get out of more spots 2014-04-09 09:58:08 -07:00
eval.texi * src/keyboard.c (Vtop_level_message): Rename to 2014-08-27 14:51:21 +04:00
files.texi Merge from emacs-24; up to 2014-06-02T11:35:40Z!michael.albinus@gmx.de 2014-06-08 16:41:43 -07:00
frames.texi Improve inhibiting of implied frame resizes. 2014-11-07 11:49:22 +01:00
functions.texi Merge from emacs-24; up to 2014-07-20T16:14:58Z!dmantipov@yandex.ru 2014-10-04 00:05:21 -07:00
gpl.texi Update licenses to latest version from FSF. 2012-12-06 00:33:32 -08:00
hash.texi Style fixes for floating-point doc. 2014-03-17 18:19:03 -07:00
help.texi Doc and comment fixes re "online" help 2014-06-28 19:33:50 -07:00
hooks.texi Doc updates re window-setup-hook 2014-06-06 00:19:23 -07:00
index.texi Fix minor whitespace issues after "." in manual. 2012-12-05 14:27:56 -08:00
internals.texi Improve doc for use of 'int', and discuss 'ssize_t'. 2014-10-01 13:34:55 -07:00
intro.texi Update copyright year to 2014 by running admin/update-copyright. 2014-01-01 07:43:34 +00:00
keymaps.texi * doc/lispref/keymaps.texi (Key Lookup): Remove mention of indirect entries. 2014-07-01 21:49:31 -04:00
lay-flat.texi Specify .texi encoding. 2014-01-05 21:25:46 -08:00
lists.texi * doc/lispref/lists.texi (Functions that Rearrange Lists): Remove 2014-08-29 15:02:56 +04:00
loading.texi Update copyright year to 2014 by running admin/update-copyright. 2014-01-01 07:43:34 +00:00
macros.texi Update copyright year to 2014 by running admin/update-copyright. 2014-01-01 07:43:34 +00:00
Makefile.in Merge from emacs-24; up to 117691 2014-11-08 18:06:29 -08:00
makefile.w32-in * doc/lispref/functions.texi (Advising Functions): New section. 2014-01-10 14:40:32 -05:00
maps.texi Update copyright year to 2014 by running admin/update-copyright. 2014-01-01 07:43:34 +00:00
markers.texi Undo in region after markers in undo history relocated 2014-03-24 22:47:39 -04:00
minibuf.texi Hide password in batch mode 2014-07-11 11:09:54 +02:00
modes.texi Small copyedits for doc/lispref 2014-10-03 23:45:19 -07:00
nonascii.texi Added BidiBrackets.txt and related Unicode properties to unidqata-gen.el. 2014-09-03 19:09:48 +03:00
numbers.texi Doc tweaks re < etc 2014-06-07 17:51:10 -07:00
objects.texi * objects.texi (Type Predicates): Don't mention display-table-p. 2014-10-20 13:20:29 -06:00
os.texi Improve time stamp handling, and be more consistent about it. 2014-11-16 20:41:22 -08:00
package.texi Spelling fixes. 2014-06-05 01:14:36 -07:00
positions.texi Merge from emacs-24; up to 2014-06-06T02:22:40Z!monnier@iro.umontreal.ca 2014-06-21 12:45:59 -07:00
processes.texi Say (accept-process-output P)'s result pertains to P if P is non-nil. 2014-06-09 13:31:06 -07:00
README Update copyright year to 2014 by running admin/update-copyright. 2014-01-01 07:43:34 +00:00
searching.texi * doc/lispref/searching.texi (Replacing Match): Remove incorrect return value 2014-03-05 21:10:33 -05:00
sequences.texi * doc/lispref/lists.texi (Functions that Rearrange Lists): Remove 2014-08-29 15:02:56 +04:00
spellfile Prefer typical American spelling for "acknowledgment". 2012-07-24 22:48:19 -07:00
streams.texi Enhance terpri to allow conditionally output a newline 2014-10-09 06:05:48 +08:00
strings.texi * strings.texi (Text Comparison): Describe `string-collate-equalp' 2014-09-07 13:02:33 +02:00
symbols.texi Update copyright year to 2014 by running admin/update-copyright. 2014-01-01 07:43:34 +00:00
syntax.texi Update copyright year to 2014 by running admin/update-copyright. 2014-01-01 07:43:34 +00:00
text.texi Implement an `inhibit-read-only' text property 2014-11-16 23:41:55 +01:00
tips.texi Lisp manaual improvements re docstrings 2014-01-03 13:49:06 +08:00
two-volume-cross-refs.txt Update copyright year to 2014 by running admin/update-copyright. 2014-01-01 07:43:34 +00:00
two-volume.make Update copyright year to 2014 by running admin/update-copyright. 2014-01-01 07:43:34 +00:00
variables.texi Style fixes for floating-point doc. 2014-03-17 18:19:03 -07:00
windows.texi Add documentation for horizontal scroll bars and fix some minor issues. 2014-10-04 10:20:24 +02: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-2014 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 <http://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 <http://www.gnu.org/licenses/>.