mercurial/help.py
changeset 9160 81028d2db635
parent 9158 d6eecafaf12f
child 9277 1f0085918c29
child 9325 74e717a21779
equal deleted inserted replaced
9159:62b3df842de9 9160:81028d2db635
   360     depends on the exact context of the templater. These keywords are usually
   360     depends on the exact context of the templater. These keywords are usually
   361     available for templating a log-like command:
   361     available for templating a log-like command:
   362 
   362 
   363     - author: String. The unmodified author of the changeset.
   363     - author: String. The unmodified author of the changeset.
   364     - branches: String. The name of the branch on which the changeset was
   364     - branches: String. The name of the branch on which the changeset was
   365           committed. Will be empty if the branch name was default.
   365       committed. Will be empty if the branch name was default.
   366     - date: Date information. The date when the changeset was committed.
   366     - date: Date information. The date when the changeset was committed.
   367     - desc: String. The text of the changeset description.
   367     - desc: String. The text of the changeset description.
   368     - diffstat: String. Statistics of changes with the following format:
   368     - diffstat: String. Statistics of changes with the following format:
   369           "modified files: +added/-removed lines"
   369       "modified files: +added/-removed lines"
   370     - files: List of strings. All files modified, added, or removed by this
   370     - files: List of strings. All files modified, added, or removed by this
   371           changeset.
   371       changeset.
   372     - file_adds: List of strings. Files added by this changeset.
   372     - file_adds: List of strings. Files added by this changeset.
   373     - file_mods: List of strings. Files modified by this changeset.
   373     - file_mods: List of strings. Files modified by this changeset.
   374     - file_dels: List of strings. Files removed by this changeset.
   374     - file_dels: List of strings. Files removed by this changeset.
   375     - node: String. The changeset identification hash, as a 40-character
   375     - node: String. The changeset identification hash, as a 40-character
   376           hexadecimal string.
   376       hexadecimal string.
   377     - parents: List of strings. The parents of the changeset.
   377     - parents: List of strings. The parents of the changeset.
   378     - rev: Integer. The repository-local changeset revision number.
   378     - rev: Integer. The repository-local changeset revision number.
   379     - tags: List of strings. Any tags associated with the changeset.
   379     - tags: List of strings. Any tags associated with the changeset.
   380 
   380 
   381     The "date" keyword does not produce human-readable output. If you want to
   381     The "date" keyword does not produce human-readable output. If you want to
   387        2008-08-21 18:22 +0000
   387        2008-08-21 18:22 +0000
   388 
   388 
   389     List of filters:
   389     List of filters:
   390 
   390 
   391     - addbreaks: Any text. Add an XHTML "<br />" tag before the end of every
   391     - addbreaks: Any text. Add an XHTML "<br />" tag before the end of every
   392           line except the last.
   392       line except the last.
   393     - age: Date. Returns a human-readable date/time difference between the
   393     - age: Date. Returns a human-readable date/time difference between the
   394           given date/time and the current date/time.
   394       given date/time and the current date/time.
   395     - basename: Any text. Treats the text as a path, and returns the last
   395     - basename: Any text. Treats the text as a path, and returns the last
   396           component of the path after splitting by the path separator
   396       component of the path after splitting by the path separator (ignoring
   397           (ignoring trailing separators). For example, "foo/bar/baz" becomes
   397       trailing separators). For example, "foo/bar/baz" becomes "baz" and
   398           "baz" and "foo/bar//" becomes "bar".
   398       "foo/bar//" becomes "bar".
   399     - stripdir: Treat the text as path and strip a directory level, if
   399     - stripdir: Treat the text as path and strip a directory level, if
   400           possible. For example, "foo" and "foo/bar" becomes "foo".
   400       possible. For example, "foo" and "foo/bar" becomes "foo".
   401     - date: Date. Returns a date in a Unix date format, including the
   401     - date: Date. Returns a date in a Unix date format, including the
   402           timezone: "Mon Sep 04 15:13:13 2006 0700".
   402       timezone: "Mon Sep 04 15:13:13 2006 0700".
   403     - domain: Any text. Finds the first string that looks like an email
   403     - domain: Any text. Finds the first string that looks like an email
   404           address, and extracts just the domain component. Example: 'User
   404       address, and extracts just the domain component. Example: 'User
   405           <user@example.com>' becomes 'example.com'.
   405       <user@example.com>' becomes 'example.com'.
   406     - email: Any text. Extracts the first string that looks like an email
   406     - email: Any text. Extracts the first string that looks like an email
   407           address. Example: 'User <user@example.com>' becomes
   407       address. Example: 'User <user@example.com>' becomes 'user@example.com'.
   408           'user@example.com'.
       
   409     - escape: Any text. Replaces the special XML/XHTML characters "&", "<" and
   408     - escape: Any text. Replaces the special XML/XHTML characters "&", "<" and
   410           ">" with XML entities.
   409       ">" with XML entities.
   411     - fill68: Any text. Wraps the text to fit in 68 columns.
   410     - fill68: Any text. Wraps the text to fit in 68 columns.
   412     - fill76: Any text. Wraps the text to fit in 76 columns.
   411     - fill76: Any text. Wraps the text to fit in 76 columns.
   413     - firstline: Any text. Returns the first line of text.
   412     - firstline: Any text. Returns the first line of text.
   414     - nonempty: Any text. Returns '(none)' if the string is empty.
   413     - nonempty: Any text. Returns '(none)' if the string is empty.
   415     - hgdate: Date. Returns the date as a pair of numbers: "1157407993 25200"
   414     - hgdate: Date. Returns the date as a pair of numbers: "1157407993 25200"
   416           (Unix timestamp, timezone offset).
   415       (Unix timestamp, timezone offset).
   417     - isodate: Date. Returns the date in ISO 8601 format.
   416     - isodate: Date. Returns the date in ISO 8601 format.
   418     - localdate: Date. Converts a date to local date.
   417     - localdate: Date. Converts a date to local date.
   419     - obfuscate: Any text. Returns the input text rendered as a sequence of
   418     - obfuscate: Any text. Returns the input text rendered as a sequence of
   420           XML entities.
   419       XML entities.
   421     - person: Any text. Returns the text before an email address.
   420     - person: Any text. Returns the text before an email address.
   422     - rfc822date: Date. Returns a date using the same format used in email
   421     - rfc822date: Date. Returns a date using the same format used in email
   423           headers.
   422       headers.
   424     - short: Changeset hash. Returns the short form of a changeset hash, i.e.
   423     - short: Changeset hash. Returns the short form of a changeset hash, i.e.
   425           a 12-byte hexadecimal string.
   424       a 12-byte hexadecimal string.
   426     - shortdate: Date. Returns a date like "2006-09-18".
   425     - shortdate: Date. Returns a date like "2006-09-18".
   427     - strip: Any text. Strips all leading and trailing whitespace.
   426     - strip: Any text. Strips all leading and trailing whitespace.
   428     - tabindent: Any text. Returns the text, with every line except the first
   427     - tabindent: Any text. Returns the text, with every line except the first
   429           starting with a tab character.
   428       starting with a tab character.
   430     - urlescape: Any text. Escapes all "special" characters. For example, "foo
   429     - urlescape: Any text. Escapes all "special" characters. For example, "foo
   431           bar" becomes "foo%20bar".
   430       bar" becomes "foo%20bar".
   432     - user: Any text. Returns the user portion of an email address.
   431     - user: Any text. Returns the user portion of an email address.
   433     ''')),
   432     ''')),
   434 
   433 
   435     (['urls'], _('URL Paths'),
   434     (['urls'], _('URL Paths'),
   436      _(r'''
   435      _(r'''