emacs/lisp/time-stamp.el, branch feature/bug-reference-setup Emacs is the extensible, customizable, self-documenting real-time display editor. ; Clarify what time-stamp-active enables 2020-01-24T17:16:19+00:00 Stephen Gildea 2020-01-24T17:15:44+00:00 fd0919678189dd8a5e4ad13d3982b248d50af525 Fix documentation strings and comments for time-stamp. Most notably: * lisp/time-stamp.el (time-stamp-active): in the doc string, clarify that time-stamp-active does not add time-stamp to any hook. 
Fix documentation strings and comments for time-stamp.  Most notably:
* lisp/time-stamp.el (time-stamp-active): in the doc string, clarify
that time-stamp-active does not add time-stamp to any hook.
Update copyright year to 2020 2020-01-01T00:59:52+00:00 Paul Eggert 2020-01-01T00:19:43+00:00 365e01cc9f64ce6ca947ccfd8612d60763280a37 Run "TZ=UTC0 admin/update-copyright $(git ls-files)". 
Run "TZ=UTC0 admin/update-copyright $(git ls-files)".
time-stamp: update support for time zone numeric offset 2019-11-14T05:11:28+00:00 Stephen Gildea 2019-11-14T04:21:42+00:00 1d189843bb2a4f23dc269314d5e6dfb4f9fe801e * time-stamp.el (time-stamp-string-preprocess): Change new format for numeric time zone from %:z to %5z to match format-time-string better. (time-stamp-format): Document support for numeric time zone. See discussion in bug#32931. * NEWS: Mention time-stamp-format %5z. 
* time-stamp.el (time-stamp-string-preprocess): Change new format for
numeric time zone from %:z to %5z to match format-time-string better.
(time-stamp-format): Document support for numeric time zone.
See discussion in bug#32931.

* NEWS: Mention time-stamp-format %5z.
time-stamp: add support for time zone numeric offset 2019-11-06T16:33:51+00:00 Stephen Gildea 2019-11-06T16:31:48+00:00 9ce67baa9a3733ae93885b6242130497b13c8703 * time-stamp.el: Implement %:z as expanding to the numeric time zone offset, to address the feature request of bug#32931. Do not document it yet, to discourage compatibility problems in mixed Emacs 26 and Emacs 27 environments. Documentation will be added in a subsequent release at least two years later. (We cannot yet use %z for numeric time zone because in Emacs 26 it was documented to do something else.) * time-stamp-tests.el (time-stamp-test-format-time-zone): expand this test and break it into two tests, time-stamp-test-format-time-zone-name and time-stamp-test-format-time-zone-offset. 
* time-stamp.el: Implement %:z as expanding to the numeric time zone
offset, to address the feature request of bug#32931.  Do not document it
yet, to discourage compatibility problems in mixed Emacs 26 and Emacs 27
environments.  Documentation will be added in a subsequent release at
least two years later.  (We cannot yet use %z for numeric time zone
because in Emacs 26 it was documented to do something else.)

* time-stamp-tests.el (time-stamp-test-format-time-zone): expand this
test and break it into two tests, time-stamp-test-format-time-zone-name
and time-stamp-test-format-time-zone-offset.
time-stamp-time-zone: update customization 2019-10-27T15:21:16+00:00 Stephen Gildea 2019-10-27T15:20:13+00:00 113ff954dbcd24325bd674b7294d54a7c8394d42 * time-stamp.el (time-stamp-time-zone): Support customization with an integer offset (a new possible value of the ZONE argument to format-time-string in Emacs 27). Update the safe-local-variable predicate from string-or-null-p (describing time-stamp-time-zone's domain before 2015) to new predicate time-stamp-zone-type-p (describing the current domain). * time-stamp-tests.el (time-stamp-test-helper-zone-type-p): New test. 
* time-stamp.el (time-stamp-time-zone): Support customization with
an integer offset (a new possible value of the ZONE argument to
format-time-string in Emacs 27).
Update the safe-local-variable predicate from string-or-null-p
(describing time-stamp-time-zone's domain before 2015) to new
predicate time-stamp-zone-type-p (describing the current domain).

* time-stamp-tests.el (time-stamp-test-helper-zone-type-p): New test.
Minor tweaks to time-stamp documentation strings 2019-10-13T14:59:59+00:00 Stephen Gildea 2019-10-13T14:58:55+00:00 d9a01dcd9fe2a0e5f84b708cdd34c3e7e8fb9189 * time-stamp.el (time-stamp): Reformat the explanation of the variables that affect time-stamp, for easier reading. In particular, wrap the documentation to 75 characters, so that it displays neatly as a before-save-hook customization option. * time-stamp-tests.el (with-time-stamp-test-env): Use imperative voice, per checkdoc. 
* time-stamp.el (time-stamp): Reformat the explanation of the
variables that affect time-stamp, for easier reading.  In particular,
wrap the documentation to 75 characters, so that it displays neatly as
a before-save-hook customization option.

* time-stamp-tests.el (with-time-stamp-test-env): Use imperative voice,
per checkdoc.
Remove tabs from time-stamp-format documentation 2019-10-10T16:22:52+00:00 Stephen Gildea 2019-10-10T16:21:38+00:00 fc7b20056a99221498cdf3c87beee6f437efba4d * time-stamp.el (time-stamp-format): Untabify the doc string, so the two-column layout displays consistently in several contexts, in particular when displayed by customize-variable. 
* time-stamp.el (time-stamp-format): Untabify the doc string, so
the two-column layout displays consistently in several contexts,
in particular when displayed by customize-variable.
time-stamp: revert recent change to "%04y" 2019-10-09T16:19:10+00:00 Stephen Gildea 2019-10-09T16:19:10+00:00 600bcde608479fc454e4794add84905d6337d3fa * time-stamp.el (time-stamp-string-preprocess): Revert change to "%04y" format made 2 weeks ago by commit 0e56883878 (the previous commit to this file). Although undocumented, "%04y" was discovered to be in use in the wild (2016) and had not issued a warning that it would change. Add a warning that it will change. * time-stamp-tests.el (time-stamp-test-year-2digit): add test of "%04y" 
* time-stamp.el (time-stamp-string-preprocess): Revert change to "%04y"
format made 2 weeks ago by commit 0e56883878 (the previous commit to
this file).  Although undocumented, "%04y" was discovered to be in use
in the wild (2016) and had not issued a warning that it would change.
Add a warning that it will change.

* time-stamp-tests.el (time-stamp-test-year-2digit): add test of "%04y"
Move undocumented time-stamp formats closer to format-time-string 2019-10-01T03:22:51+00:00 Stephen Gildea 2019-10-01T03:22:51+00:00 0e568838781a4a5f2970bff6245c4e41f31612cc * time-stamp.el (time-stamp-string-preprocess): Update some undocumented formatting characters of time-stamp format for closer (still incomplete) alignment with format-time-string. They have displayed a warning since Emacs 20 (released in 1997), so it is unlikely anyone is using them. * time-stamp-tests.el: Update tests to match new expectations. 
* time-stamp.el (time-stamp-string-preprocess): Update some undocumented
formatting characters of time-stamp format for closer (still incomplete)
alignment with format-time-string.  They have displayed a warning since
Emacs 20 (released in 1997), so it is unlikely anyone is using them.

* time-stamp-tests.el: Update tests to match new expectations.
time-stamp doc: recommend formats closer to format-time-string 2019-10-01T03:08:12+00:00 Stephen Gildea 2019-10-01T03:06:16+00:00 8ba1ca54f31b556edcc24d497d132203cc0cb9c0 * time-stamp.el (time-stamp-format, time-stamp-pattern): Update recommended (documented) formats. No code changes, just documentation. All recommended formats are compatible at least as far back as Emacs 22.1 (released in 2007) and are now closer to compatibility with format-time-string. * time-stamp-tests.el: Update test comments to match. 
* time-stamp.el (time-stamp-format, time-stamp-pattern): Update
recommended (documented) formats.  No code changes, just documentation.
All recommended formats are compatible at least as far back as Emacs
22.1 (released in 2007) and are now closer to compatibility with
format-time-string.

* time-stamp-tests.el: Update test comments to match.