Documentation/rev-list-options: wrap --date=<format> block with "--"
Using "+" to continue multiple list items is more tedious and error-prone than wrapping the entire block with "--" block markers. When using asciidoctor, the list items after the --date=iso list items are incorrectly formatted when using "+" continuation. Use "--" block markers to correctly format the block. When using asciidoc there is no change in how the content is rendered. Signed-off-by: Todd Zullinger <tmz@pobox.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Todd Zullinger committed
Mar 30, 2019 at 14:30 UTC
39a869b2f249a0bf540a20e67951318995c39602
1 file changed
+11
-11
Documentation/rev-list-options.txt
+11
-11
@@ -805,12 +805,13 @@ include::pretty-options.txt[]
805
author's). If `-local` is appended to the format (e.g.,
806
`iso-local`), the user's local time zone is used instead.
807
+
808
+--
809
`--date=relative` shows dates relative to the current time,
810
e.g. ``2 hours ago''. The `-local` option has no effect for
811
`--date=relative`.
811
-+
812
+
813
`--date=local` is an alias for `--date=default-local`.
813
-+
814
+
815
`--date=iso` (or `--date=iso8601`) shows timestamps in a ISO 8601-like format.
816
The differences to the strict ISO 8601 format are:
817
@@ -818,15 +819,14 @@ The differences to the strict ISO 8601 format are:
819
- a space between time and time zone
820
- no colon between hours and minutes of the time zone
821
821
-+
822
`--date=iso-strict` (or `--date=iso8601-strict`) shows timestamps in strict
823
ISO 8601 format.
824
-+
824
+
825
`--date=rfc` (or `--date=rfc2822`) shows timestamps in RFC 2822
826
format, often found in email messages.
827
-+
827
+
828
`--date=short` shows only the date, but not the time, in `YYYY-MM-DD` format.
829
-+
829
+
830
`--date=raw` shows the date as seconds since the epoch (1970-01-01
831
00:00:00 UTC), followed by a space, and then the timezone as an offset
832
from UTC (a `+` or `-` with four digits; the first two are hours, and
@@ -835,28 +835,28 @@ with `strftime("%s %z")`).
835
Note that the `-local` option does not affect the seconds-since-epoch
836
value (which is always measured in UTC), but does switch the accompanying
837
timezone value.
838
-+
838
+
839
`--date=human` shows the timezone if the timezone does not match the
840
current time-zone, and doesn't print the whole date if that matches
841
(ie skip printing year for dates that are "this year", but also skip
842
the whole date itself if it's in the last few days and we can just say
843
what weekday it was). For older dates the hour and minute is also
844
omitted.
845
-+
845
+
846
`--date=unix` shows the date as a Unix epoch timestamp (seconds since
847
1970). As with `--raw`, this is always in UTC and therefore `-local`
848
has no effect.
849
-+
849
+
850
`--date=format:...` feeds the format `...` to your system `strftime`,
851
except for %z and %Z, which are handled internally.
852
Use `--date=format:%c` to show the date in your system locale's
853
preferred format. See the `strftime` manual for a complete list of
854
format placeholders. When using `-local`, the correct syntax is
855
`--date=format-local:...`.
856
-+
856
+
857
`--date=default` is the default format, and is similar to
858
`--date=rfc2822`, with a few exceptions:
859
-
859
+--
860
- there is no comma after the day-of-week
861
862
- the time zone is omitted when the local time zone is used