aboutsummaryrefslogtreecommitdiff
path: root/doc/put_date.txt
diff options
context:
space:
mode:
authorTom Ryder <tom@sanctum.geek.nz>2020-05-31 01:15:36 +1200
committerTom Ryder <tom@sanctum.geek.nz>2020-05-31 01:20:33 +1200
commit598090797c2cb3a4fe945d2eacd3eca42a0cfe5d (patch)
tree96daceb67ab452bdb98cbc63d78112454c20c370 /doc/put_date.txt
downloadvim-put-date-598090797c2cb3a4fe945d2eacd3eca42a0cfe5d.tar.gz
vim-put-date-598090797c2cb3a4fe945d2eacd3eca42a0cfe5d.zip
First version from tejr dotfiles v9.12.0v0.1.0
Diffstat (limited to 'doc/put_date.txt')
-rw-r--r--doc/put_date.txt44
1 files changed, 44 insertions, 0 deletions
diff --git a/doc/put_date.txt b/doc/put_date.txt
new file mode 100644
index 0000000..9fb7021
--- /dev/null
+++ b/doc/put_date.txt
@@ -0,0 +1,44 @@
+*put_date.txt* For Vim version 7.0 Last change: 2020 May 31
+
+DESCRIPTION *put_date*
+
+This plugin provides a convenience wrapper around `strftime()` to insert the
+current date and time in the buffer, defaulting to RFC2822 format, and
+requiring neither percent signs nor quoting for any specified format.
+>
+ :PutDate
+ Sun, 31 May 2020 01:04:41 +1200
+ :PutDate d/m/Y
+ 31/05/2020
+<
+An attempt to use the UTC time zone rather than the local time zone is made if
+a bang is added:
+>
+ :PutDate!
+ Sat, 30 May 2020 13:04:14 +0000
+ :PutDate!
+ 13
+<
+This time zone switching only works reliably on Unix with Vim v8.2, or Vim 8.1
+with patch 1567:
+
+REQUIREMENTS *put_date-requirements*
+
+This plugin only loads if 'compatible' is not set. Strictly speaking, it also
+depends on the underlying system's implementation of the POSIX `strftime(3)`
+function, just as Vim's own |strftime()| does. It will not behave identically
+between systems.
+
+In particular, the time zone switching only works reliably on Unix, and it's
+broken there between patches 8.1.1313 and 8.1.1567. See |version8.txt| for
+details. At the time of writing, it's still broken on Windows since 8.1.1313.
+
+AUTHOR *put_date-author*
+
+Written and maintained by Tom Ryder <tom@sanctum.geek.nz>.
+
+LICENSE *put_date-license*
+
+Licensed for distribution under the same terms as Vim itself (see |license|).
+
+ vim:tw=78:ts=8:ft=help:norl: