Show More
@@ -22,33 +22,45 b' Strings in curly braces are called keywo' | |||
|
22 | 22 | keywords depends on the exact context of the templater. These |
|
23 | 23 | keywords are usually available for templating a log-like command: |
|
24 | 24 | |
|
25 |
:author: |
|
|
26 | :branches: String. The name of the branch on which the changeset | |
|
27 | was committed. Will be empty if the branch name was | |
|
28 | default. | |
|
29 | :date: Date information. The date when the changeset was | |
|
30 | committed. | |
|
31 | :desc: String. The text of the changeset description. | |
|
32 | :diffstat: String. Statistics of changes with the following | |
|
33 | format: "modified files: +added/-removed lines" | |
|
34 | :files: List of strings. All files modified, added, or removed | |
|
35 | by this changeset. | |
|
25 | :author: String. The unmodified author of the changeset. | |
|
26 | ||
|
27 | :branches: String. The name of the branch on which the changeset was | |
|
28 | committed. Will be empty if the branch name was default. | |
|
29 | ||
|
30 | :date: Date information. The date when the changeset was committed. | |
|
31 | ||
|
32 | :desc: String. The text of the changeset description. | |
|
33 | ||
|
34 | :diffstat: String. Statistics of changes with the following format: | |
|
35 | "modified files: +added/-removed lines" | |
|
36 | ||
|
37 | :files: List of strings. All files modified, added, or removed by this | |
|
38 | changeset. | |
|
39 | ||
|
36 | 40 | :file_adds: List of strings. Files added by this changeset. |
|
41 | ||
|
37 | 42 | :file_copies: List of strings. Files copied in this changeset with |
|
38 |
|
|
|
43 | their sources. | |
|
44 | ||
|
39 | 45 | :file_copies_switch: List of strings. Like "file_copies" but displayed |
|
40 |
|
|
|
46 | only if the --copied switch is set. | |
|
47 | ||
|
41 | 48 | :file_mods: List of strings. Files modified by this changeset. |
|
49 | ||
|
42 | 50 | :file_dels: List of strings. Files removed by this changeset. |
|
43 | :node: String. The changeset identification hash, as a | |
|
44 | 40-character hexadecimal string. | |
|
45 | :parents: List of strings. The parents of the changeset. | |
|
46 | :rev: Integer. The repository-local changeset revision | |
|
47 | number. | |
|
48 | :tags: List of strings. Any tags associated with the | |
|
49 | changeset. | |
|
51 | ||
|
52 | :node: String. The changeset identification hash, as a 40-character | |
|
53 | hexadecimal string. | |
|
54 | ||
|
55 | :parents: List of strings. The parents of the changeset. | |
|
56 | ||
|
57 | :rev: Integer. The repository-local changeset revision number. | |
|
58 | ||
|
59 | :tags: List of strings. Any tags associated with the changeset. | |
|
60 | ||
|
50 | 61 | :latesttag: String. Most recent global tag in the ancestors of this |
|
51 |
|
|
|
62 | changeset. | |
|
63 | ||
|
52 | 64 | :latesttagdistance: Integer. Longest path to the latest tag. |
|
53 | 65 | |
|
54 | 66 | The "date" keyword does not produce human-readable output. If you |
@@ -62,56 +74,76 b' output::' | |||
|
62 | 74 | |
|
63 | 75 | List of filters: |
|
64 | 76 | |
|
65 |
:addbreaks: |
|
|
66 |
|
|
|
67 | :age: Date. Returns a human-readable date/time difference | |
|
68 | between the given date/time and the current | |
|
69 | date/time. | |
|
70 | :basename: Any text. Treats the text as a path, and returns the | |
|
71 | last component of the path after splitting by the | |
|
72 | path separator (ignoring trailing separators). For | |
|
73 | example, "foo/bar/baz" becomes "baz" and "foo/bar//" | |
|
74 |
|
|
|
75 | :stripdir: Treat the text as path and strip a directory level, | |
|
76 | if possible. For example, "foo" and "foo/bar" becomes | |
|
77 | "foo". | |
|
78 | :date: Date. Returns a date in a Unix date format, including | |
|
79 | the timezone: "Mon Sep 04 15:13:13 2006 0700". | |
|
80 | :domain: Any text. Finds the first string that looks like an | |
|
81 | email address, and extracts just the domain | |
|
82 | component. Example: ``User <user@example.com>`` becomes | |
|
83 | ``example.com``. | |
|
84 | :email: Any text. Extracts the first string that looks like | |
|
85 | an email address. Example: ``User <user@example.com>`` | |
|
86 | becomes ``user@example.com``. | |
|
87 | :escape: Any text. Replaces the special XML/XHTML characters | |
|
88 | "&", "<" and ">" with XML entities. | |
|
89 | :fill68: Any text. Wraps the text to fit in 68 columns. | |
|
90 | :fill76: Any text. Wraps the text to fit in 76 columns. | |
|
91 | :firstline: Any text. Returns the first line of text. | |
|
92 | :nonempty: Any text. Returns '(none)' if the string is empty. | |
|
93 | :hgdate: Date. Returns the date as a pair of numbers: | |
|
94 | "1157407993 25200" (Unix timestamp, timezone offset). | |
|
95 | :isodate: Date. Returns the date in ISO 8601 format: | |
|
96 | "2009-08-18 13:00 +0200". | |
|
97 | :isodatesec: Date. Returns the date in ISO 8601 format, including | |
|
98 | seconds: "2009-08-18 13:00:13 +0200". See also the | |
|
99 | rfc3339date filter. | |
|
100 | :localdate: Date. Converts a date to local date. | |
|
101 | :obfuscate: Any text. Returns the input text rendered as a | |
|
102 | sequence of XML entities. | |
|
103 | :person: Any text. Returns the text before an email address. | |
|
104 | :rfc822date: Date. Returns a date using the same format used in | |
|
105 | email headers: "Tue, 18 Aug 2009 13:00:13 +0200". | |
|
77 | :addbreaks: Any text. Add an XHTML "<br />" tag before the end of | |
|
78 | every line except the last. | |
|
79 | ||
|
80 | :age: Date. Returns a human-readable date/time difference between the | |
|
81 | given date/time and the current date/time. | |
|
82 | ||
|
83 | :basename: Any text. Treats the text as a path, and returns the last | |
|
84 | component of the path after splitting by the path separator | |
|
85 | (ignoring trailing separators). For example, "foo/bar/baz" becomes | |
|
86 | "baz" and "foo/bar//" becomes "bar". | |
|
87 | ||
|
88 | :stripdir: Treat the text as path and strip a directory level, if | |
|
89 | possible. For example, "foo" and "foo/bar" becomes "foo". | |
|
90 | ||
|
91 | :date: Date. Returns a date in a Unix date format, including the | |
|
92 | timezone: "Mon Sep 04 15:13:13 2006 0700". | |
|
93 | ||
|
94 | :domain: Any text. Finds the first string that looks like an email | |
|
95 | address, and extracts just the domain component. Example: ``User | |
|
96 | <user@example.com>`` becomes ``example.com``. | |
|
97 | ||
|
98 | :email: Any text. Extracts the first string that looks like an email | |
|
99 | address. Example: ``User <user@example.com>`` becomes | |
|
100 | ``user@example.com``. | |
|
101 | ||
|
102 | :escape: Any text. Replaces the special XML/XHTML characters "&", "<" | |
|
103 | and ">" with XML entities. | |
|
104 | ||
|
105 | :fill68: Any text. Wraps the text to fit in 68 columns. | |
|
106 | ||
|
107 | :fill76: Any text. Wraps the text to fit in 76 columns. | |
|
108 | ||
|
109 | :firstline: Any text. Returns the first line of text. | |
|
110 | ||
|
111 | :nonempty: Any text. Returns '(none)' if the string is empty. | |
|
112 | ||
|
113 | :hgdate: Date. Returns the date as a pair of numbers: "1157407993 | |
|
114 | 25200" (Unix timestamp, timezone offset). | |
|
115 | ||
|
116 | :isodate: Date. Returns the date in ISO 8601 format: "2009-08-18 13:00 | |
|
117 | +0200". | |
|
118 | ||
|
119 | :isodatesec: Date. Returns the date in ISO 8601 format, including | |
|
120 | seconds: "2009-08-18 13:00:13 +0200". See also the rfc3339date | |
|
121 | filter. | |
|
122 | ||
|
123 | :localdate: Date. Converts a date to local date. | |
|
124 | ||
|
125 | :obfuscate: Any text. Returns the input text rendered as a sequence of | |
|
126 | XML entities. | |
|
127 | ||
|
128 | :person: Any text. Returns the text before an email address. | |
|
129 | ||
|
130 | :rfc822date: Date. Returns a date using the same format used in email | |
|
131 | headers: "Tue, 18 Aug 2009 13:00:13 +0200". | |
|
132 | ||
|
106 | 133 | :rfc3339date: Date. Returns a date using the Internet date format |
|
107 |
|
|
|
108 | :short: Changeset hash. Returns the short form of a changeset | |
|
109 | hash, i.e. a 12-byte hexadecimal string. | |
|
110 | :shortdate: Date. Returns a date like "2006-09-18". | |
|
111 | :strip: Any text. Strips all leading and trailing whitespace. | |
|
112 | :tabindent: Any text. Returns the text, with every line except | |
|
113 | the first starting with a tab character. | |
|
114 | :urlescape: Any text. Escapes all "special" characters. For | |
|
115 | example, "foo bar" becomes "foo%20bar". | |
|
116 | :user: Any text. Returns the user portion of an email | |
|
117 | address. | |
|
134 | specified in RFC 3339: "2009-08-18T13:00:13+02:00". | |
|
135 | ||
|
136 | :short: Changeset hash. Returns the short form of a changeset hash, | |
|
137 | i.e. a 12-byte hexadecimal string. | |
|
138 | ||
|
139 | :shortdate: Date. Returns a date like "2006-09-18". | |
|
140 | ||
|
141 | :strip: Any text. Strips all leading and trailing whitespace. | |
|
142 | ||
|
143 | :tabindent: Any text. Returns the text, with every line except the | |
|
144 | first starting with a tab character. | |
|
145 | ||
|
146 | :urlescape: Any text. Escapes all "special" characters. For example, | |
|
147 | "foo bar" becomes "foo%20bar". | |
|
148 | ||
|
149 | :user: Any text. Returns the user portion of an email address. |
General Comments 0
You need to be logged in to leave comments.
Login now