emacs-gpu/doc/misc
Paul Eggert 662bee7d70 file-attributes cleanup
Mostly, this replaces magic-number calls like (nth 4 A) with
more-informative calls like (file-attribute-access-time A).
It also fixes some documentation and minor timestamp coding
issues that I noticed while looking into this.
* doc/lispref/files.texi (File Attributes):
* lisp/files.el (file-attribute-size)
(file-attribute-inode-number, file-attribute-device-number):
* src/dired.c (Fdirectory_files_and_attributes)
(Ffile_attributes):
Mention which attributes must be integers, or nonnegative integers,
as opposed to merely being numbers.  Remove no-longer-correct
talk about representing large integers as conses of integers.
* doc/lispref/files.texi (Magic File Names):
* doc/misc/gnus.texi (Low-level interface to the spam-stat dictionary):
* lisp/autorevert.el (auto-revert-find-file-function)
(auto-revert-tail-mode, auto-revert-handler):
* lisp/auth-source.el (auth-source-netrc-parse):
* lisp/cedet/ede/files.el (ede--inode-for-dir):
* lisp/cedet/semantic/db-file.el (object-write):
* lisp/cedet/semantic/db-mode.el (semanticdb-kill-hook):
* lisp/cedet/semantic/db.el (semanticdb-needs-refresh-p)
(semanticdb-synchronize):
* lisp/cedet/srecode/table.el (srecode-mode-table-new):
* lisp/desktop.el (desktop-save, desktop-read):
* lisp/dired-aux.el (dired-file-set-difference)
(dired-do-chxxx, dired-do-chmod, dired-copy-file-recursive)
(dired-create-files):
* lisp/dired.el (dired-directory-changed-p, dired-readin):
* lisp/dos-w32.el (w32-direct-print-region-helper):
* lisp/emacs-lisp/autoload.el (autoload-generate-file-autoloads)
(autoload-find-destination, update-directory-autoloads):
* lisp/emacs-lisp/shadow.el (load-path-shadows-same-file-or-nonexistent):
* lisp/epg.el (epg--start, epg-wait-for-completion):
* lisp/eshell/em-ls.el (eshell-ls-filetype-p)
(eshell-ls-applicable, eshell-ls-size-string)
(eshell-ls-file, eshell-ls-dir, eshell-ls-files)
(eshell-ls-entries):
* lisp/eshell/em-pred.el (eshell-predicate-alist)
(eshell-pred-file-type, eshell-pred-file-links)
(eshell-pred-file-size):
* lisp/eshell/em-unix.el (eshell-shuffle-files, eshell/cat)
(eshell-du-sum-directory, eshell/du):
* lisp/eshell/esh-util.el (eshell-read-passwd)
(eshell-read-hosts):
* lisp/files.el (remote-file-name-inhibit-cache)
(find-file-noselect, insert-file-1, dir-locals-find-file)
(dir-locals-read-from-dir, backup-buffer)
(file-ownership-preserved-p, copy-directory)
(read-file-modes):
* lisp/find-lisp.el (find-lisp-format):
* lisp/gnus/gnus-agent.el (gnus-agent-unfetch-articles)
(gnus-agent-read-agentview, gnus-agent-expire-group-1)
(gnus-agent-request-article, gnus-agent-regenerate-group)
(gnus-agent-update-files-total-fetched-for)
(gnus-agent-update-view-total-fetched-for):
* lisp/gnus/gnus-cache.el (gnus-cache-read-active)
(gnus-cache-update-file-total-fetched-for)
(gnus-cache-update-overview-total-fetched-for):
* lisp/gnus/gnus-cloud.el (gnus-cloud-file-new-p):
* lisp/gnus/gnus-score.el (gnus-score-score-files):
* lisp/gnus/gnus-start.el (gnus-save-newsrc-file)
(gnus-master-read-slave-newsrc):
* lisp/gnus/gnus-sum.el (gnus-summary-import-article):
* lisp/gnus/gnus-util.el (gnus-file-newer-than)
(gnus-cache-file-contents):
* lisp/gnus/mail-source.el (mail-source-delete-old-incoming)
(mail-source-callback, mail-source-movemail):
* lisp/gnus/nneething.el (nneething-create-mapping)
(nneething-make-head):
* lisp/gnus/nnfolder.el (nnfolder-read-folder):
* lisp/gnus/nnheader.el (nnheader-file-size)
(nnheader-insert-nov-file):
* lisp/gnus/nnmail.el (nnmail-activate):
* lisp/gnus/nnmaildir.el (nnmaildir--group-maxnum)
(nnmaildir--new-number, nnmaildir--update-nov)
(nnmaildir--scan, nnmaildir-request-scan)
(nnmaildir-request-update-info)
(nnmaildir-request-expire-articles):
* lisp/gnus/nnmh.el (nnmh-request-list-1)
(nnmh-request-expire-articles, nnmh-update-gnus-unreads):
* lisp/gnus/nnml.el (nnml-request-expire-articles):
* lisp/gnus/spam-stat.el (spam-stat-save, spam-stat-load)
(spam-stat-process-directory, spam-stat-test-directory):
* lisp/ido.el (ido-directory-too-big-p)
(ido-file-name-all-completions):
* lisp/image-dired.el (image-dired-get-thumbnail-image)
(image-dired-create-thumb-1):
* lisp/info.el (info-insert-file-contents):
* lisp/ls-lisp.el (ls-lisp-insert-directory)
(ls-lisp-handle-switches, ls-lisp-classify-file)
(ls-lisp-format):
* lisp/mail/blessmail.el:
* lisp/mail/feedmail.el (feedmail-default-date-generator)
(feedmail-default-message-id-generator):
* lisp/mail/mailabbrev.el (mail-abbrevs-sync-aliases)
(mail-abbrevs-setup):
* lisp/mail/mspools.el (mspools-size-folder):
* lisp/mail/rmail.el (rmail-insert-inbox-text):
* lisp/mail/sendmail.el (sendmail-sync-aliases):
* lisp/mh-e/mh-alias.el (mh-alias-tstamp):
* lisp/net/ange-ftp.el (ange-ftp-parse-netrc)
(ange-ftp-write-region, ange-ftp-file-newer-than-file-p)
(ange-ftp-cf1):
* lisp/net/eudcb-mab.el (eudc-mab-query-internal):
* lisp/net/eww.el (eww-read-bookmarks):
* lisp/net/netrc.el (netrc-parse):
* lisp/net/newst-backend.el (newsticker--image-get):
* lisp/nxml/rng-loc.el (rng-get-parsed-schema-locating-file):
* lisp/obsolete/fast-lock.el (fast-lock-save-cache):
* lisp/obsolete/vc-arch.el (vc-arch-state)
(vc-arch-diff3-rej-p):
* lisp/org/ob-eval.el (org-babel--shell-command-on-region):
* lisp/org/org-attach.el (org-attach-commit):
* lisp/org/org-macro.el (org-macro-initialize-templates):
* lisp/org/org.el (org-babel-load-file)
(org-file-newer-than-p):
* lisp/org/ox-html.el (org-html-format-spec):
* lisp/org/ox-publish.el (org-publish-find-date)
(org-publish-cache-ctime-of-src):
* lisp/pcmpl-gnu.el (pcomplete/tar):
* lisp/pcmpl-rpm.el (pcmpl-rpm-packages):
* lisp/play/cookie1.el (cookie-snarf):
* lisp/progmodes/cmacexp.el (c-macro-expansion):
* lisp/ps-bdf.el (bdf-file-mod-time):
* lisp/server.el (server-ensure-safe-dir):
* lisp/simple.el (shell-command-on-region):
* lisp/speedbar.el (speedbar-item-info-file-helper)
(speedbar-check-obj-this-line):
* lisp/thumbs.el (thumbs-cleanup-thumbsdir):
* lisp/time.el (display-time-mail-check-directory)
(display-time-file-nonempty-p):
* lisp/url/url-cache.el (url-is-cached):
* lisp/url/url-file.el (url-file-asynch-callback):
* lisp/vc/diff-mode.el (diff-delete-if-empty):
* lisp/vc/pcvs-info.el (cvs-fileinfo-from-entries):
* lisp/vc/vc-bzr.el (vc-bzr-state-heuristic):
* lisp/vc/vc-cvs.el (vc-cvs-checkout-model)
(vc-cvs-state-heuristic, vc-cvs-merge-news)
(vc-cvs-retrieve-tag, vc-cvs-parse-status, vc-cvs-parse-entry):
* lisp/vc/vc-hg.el (vc-hg--slurp-hgignore-1)
(vc-hg--ignore-patterns-valid-p)
(vc-hg--cached-dirstate-search, vc-hg-state-fast):
* lisp/vc/vc-hooks.el (vc-after-save):
* lisp/vc/vc-rcs.el (vc-rcs-workfile-is-newer):
* lisp/vc/vc-svn.el (vc-svn-merge-news, vc-svn-parse-status):
* lisp/vc/vc.el (vc-checkout, vc-checkin, vc-revert-file):
* lisp/xdg.el (xdg-mime-apps):
Prefer (file-attribute-size A) to (nth 7 A), and similarly
for other file attributes accessors.
* doc/lispref/files.texi (File Attributes):
* doc/lispref/intro.texi (Version Info):
* doc/lispref/os.texi (Idle Timers):
* lisp/erc/erc.el (erc-string-to-emacs-time):
* lisp/files.el (file-attribute-access-time)
(file-attribute-modification-time)
(file-attribute-status-change-time):
* lisp/net/tramp-compat.el:
(tramp-compat-file-attribute-modification-time)
(tramp-compat-file-attribute-size):
* src/buffer.c (syms_of_buffer):
* src/editfns.c (Fget_internal_run_time):
* src/fileio.c (Fvisited_file_modtime)
(Fset_visited_file_modtime):
* src/keyboard.c (Fcurrent_idle_time):
* src/process.c (Fprocess_attributes):
Defer implementation details about timestamp format to the
section that talks about timestamp format, to make it easier
to change the documentation later if timestamp formats are
extended.
* lisp/gnus/gnus-util.el (gnus-file-newer-than):
* lisp/speedbar.el (speedbar-check-obj-this-line):
* lisp/vc/vc-rcs.el (vc-rcs-workfile-is-newer):
Prefer time-less-p to doing it by hand.
* lisp/ls-lisp.el (ls-lisp-format): Inode numbers are no longer conses.
* lisp/vc/vc-bzr.el (vc-bzr-state-heuristic):
Use eql, not eq, to compare integers that might be bignums.
* lisp/org/ox-publish.el (org-publish-cache-ctime-of-src):
Prefer float-time to doing time arithmetic by hand.
2018-09-23 18:32:59 -07:00
..
ada-mode.texi Fix use of @key in Texinfo manuals 2018-04-19 12:21:06 +03:00
auth.texi Precise Secret Service API in auth.texi (Bug#29575) 2018-09-11 11:46:32 +02:00
autotype.texi Fix typos in several manuals (Bug#31610) 2018-06-01 16:33:58 +03:00
bovine.texi Fix copyright years by hand 2018-01-01 01:02:09 -08:00
calc.texi Merge from origin/emacs-26 2018-09-10 13:12:38 -07:00
cc-mode.texi ; Spelling fixes 2018-03-04 17:10:34 -08:00
ChangeLog.1 Update copyright year to 2018 2018-01-01 00:57:59 -08:00
cl.texi Audit use of lsh and fix glitches 2018-08-21 13:44:32 -07:00
dbus.texi Further improvements on manuals 2018-03-01 09:25:55 +01:00
dired-x.texi Merge from origin/emacs-26 2018-09-20 07:50:34 -07:00
doclicense.texi Merge from Gnulib 2017-10-01 18:31:10 -07:00
ebrowse.texi * doc/misc/ebrowse.texi: Use @key{} for keys. 2018-02-24 17:56:43 +01:00
ede.texi Merge from origin/emacs-26 2018-02-28 09:40:40 -08:00
ediff.texi Fix use of @key in Texinfo manuals 2018-04-19 12:21:06 +03:00
edt.texi Mark keys consistently in manuals 2018-02-26 13:53:37 +01:00
efaq-w32.texi Fix use of @key in Texinfo manuals 2018-04-19 12:21:06 +03:00
efaq.texi Merge from origin/emacs-26 2018-09-15 09:20:32 -07:00
eieio.texi Fix @cindex entries in manuals 2018-02-24 20:52:21 +01:00
emacs-gnutls.texi Fix copyright years by hand 2018-01-01 01:02:09 -08:00
emacs-mime.texi Fix ambiguity in nil DST flag 2018-09-21 14:25:19 -07:00
epa.texi Fix @kindex entries in manuals 2018-02-25 16:29:39 +01:00
erc.texi Mark keys consistently in manuals 2018-02-26 13:53:37 +01:00
ert.texi Fix some documentation formatting nits 2018-08-03 08:54:08 -07:00
eshell.texi Merge from origin/emacs-26 2018-09-20 07:50:34 -07:00
eudc.texi Fix copyright years by hand 2018-01-01 01:02:09 -08:00
eww.texi shr: Allow skipping tags with aria-hidden (Bug#32348) 2018-08-27 19:16:47 -04:00
flymake.texi Fix @include directive in Flymake doc again 2018-07-28 08:41:10 +01:00
forms.texi Remove @key{} markups from @kindex entries in manuals 2018-02-26 09:24:39 +01:00
gnus-coding.texi Fix copyright years by hand 2018-01-01 01:02:09 -08:00
gnus-faq.texi Use “Cc” for email copies, as per RFC 5322. 2018-05-20 11:02:50 -07:00
gnus-news.el Fix copyright years by hand 2018-01-01 01:02:09 -08:00
gnus-news.texi Mark keys consistently in manuals 2018-02-26 13:53:37 +01:00
gnus-overrides.texi
gnus.texi file-attributes cleanup 2018-09-23 18:32:59 -07:00
gpl.texi Merge from Gnulib 2017-10-01 18:31:10 -07:00
htmlfontify.texi Doc fixes re obsolete items 2018-03-13 14:47:41 -04:00
idlwave.texi Fix use of @key in Texinfo manuals 2018-04-19 12:21:06 +03:00
ido.texi Mark keys consistently in manuals 2018-02-26 13:53:37 +01:00
info.texi Fix use of @key in Texinfo manuals 2018-04-19 12:21:06 +03:00
mairix-el.texi Mark keys consistently in manuals 2018-02-26 13:53:37 +01:00
Makefile.in Update copyright year to 2018 2018-01-01 00:57:59 -08:00
message.texi Revert part of the previous change 2018-05-20 21:27:42 +03:00
mh-e.texi Use “Cc” for email copies, as per RFC 5322. 2018-05-20 11:02:50 -07:00
newsticker.texi Mark keys consistently in manuals 2018-02-26 13:53:37 +01:00
nxml-mode.texi Fix copyright years by hand 2018-01-01 01:02:09 -08:00
octave-mode.texi Fix copyright years by hand 2018-01-01 01:02:09 -08:00
org.texi Merge from origin/emacs-26 2018-06-02 10:29:37 -07:00
pcl-cvs.texi Fix use of @key in Texinfo manuals 2018-04-19 12:21:06 +03:00
pgg.texi Fix copyright years by hand 2018-01-01 01:02:09 -08:00
rcirc.texi rcirc: Document /reconnect as a built-in command (Bug#29656) 2018-08-29 22:53:43 -04:00
reftex.texi Fix use of @key in Texinfo manuals 2018-04-19 12:21:06 +03:00
remember.texi Fix copyright years by hand 2018-01-01 01:02:09 -08:00
sasl.texi Fix copyright years by hand 2018-01-01 01:02:09 -08:00
sc.texi Fix use of @key in Texinfo manuals 2018-04-19 12:21:06 +03:00
sem-user.texi Fix @cindex entries in manuals 2018-02-24 20:52:21 +01:00
semantic.texi Semantic manual fixes 2018-02-21 20:13:01 +01:00
ses.texi Mark keys consistently in manuals 2018-02-26 13:53:37 +01:00
sieve.texi Mark keys consistently in manuals 2018-02-26 13:53:37 +01:00
smtpmail.texi Mark keys consistently in manuals 2018-02-26 13:53:37 +01:00
speedbar.texi Replace some obsolete aliases in documentation 2018-03-07 15:41:29 -05:00
srecode.texi Mark keys consistently in manuals 2018-02-26 13:53:37 +01:00
texinfo.tex Update from Gnulib 2018-06-29 17:32:35 -07:00
todo-mode.texi Update copyright year to 2018 2018-01-01 00:57:59 -08:00
tramp.texi Editorial changes in tramp.texi 2018-08-11 09:51:27 +02:00
trampver.texi Bump Tramp version to 2.4.1-pre 2018-08-27 16:45:50 +02:00
url.texi ; * doc/misc/url.texi (file/ftp): Remove stray '@end defopt'. 2018-04-14 01:58:38 -04:00
vhdl-mode.texi Mark keys consistently in manuals 2018-02-26 13:53:37 +01:00
vip.texi Fix use of @key in Texinfo manuals 2018-04-19 12:21:06 +03:00
viper.texi Fix typos in several manuals (Bug#31610) 2018-06-01 16:33:58 +03:00
widget.texi Fix copyright years by hand 2018-01-01 01:02:09 -08:00
wisent.texi Fix typos in several manuals (Bug#31610) 2018-06-01 16:33:58 +03:00
woman.texi Remove @key{} markups from @kindex entries in manuals 2018-02-26 09:24:39 +01:00