path: root/doc
diff options
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
First version from tejr dotfiles v9.12.0v0.1.0
Diffstat (limited to 'doc')
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: