mercurial/help.py
changeset 9362 bb7e2cdd4854
parent 9361 419aa488432e
child 9536 f04d17912441
equal deleted inserted replaced
9361:419aa488432e 9362:bb7e2cdd4854
   403        $ hg tip --template "{date|isodate}\n"
   403        $ hg tip --template "{date|isodate}\n"
   404        2008-08-21 18:22 +0000
   404        2008-08-21 18:22 +0000
   405 
   405 
   406     List of filters:
   406     List of filters:
   407 
   407 
   408     :addbreaks:  Any text. Add an XHTML "<br />" tag before the end of
   408     :addbreaks:   Any text. Add an XHTML "<br />" tag before the end of
   409                  every line except the last.
   409                   every line except the last.
   410     :age:        Date. Returns a human-readable date/time difference
   410     :age:         Date. Returns a human-readable date/time difference
   411                  between the given date/time and the current
   411                   between the given date/time and the current
   412                  date/time.
   412                   date/time.
   413     :basename:   Any text. Treats the text as a path, and returns the
   413     :basename:    Any text. Treats the text as a path, and returns the
   414                  last component of the path after splitting by the
   414                   last component of the path after splitting by the
   415                  path separator (ignoring trailing separators). For
   415                   path separator (ignoring trailing separators). For
   416                  example, "foo/bar/baz" becomes "baz" and "foo/bar//"
   416                   example, "foo/bar/baz" becomes "baz" and "foo/bar//"
   417                  becomes "bar".
   417                   becomes "bar".
   418     :stripdir:   Treat the text as path and strip a directory level,
   418     :stripdir:    Treat the text as path and strip a directory level,
   419                  if possible. For example, "foo" and "foo/bar" becomes
   419                   if possible. For example, "foo" and "foo/bar" becomes
   420                  "foo".
   420                   "foo".
   421     :date:       Date. Returns a date in a Unix date format, including
   421     :date:        Date. Returns a date in a Unix date format, including
   422                  the timezone: "Mon Sep 04 15:13:13 2006 0700".
   422                   the timezone: "Mon Sep 04 15:13:13 2006 0700".
   423     :domain:     Any text. Finds the first string that looks like an
   423     :domain:      Any text. Finds the first string that looks like an
   424                  email address, and extracts just the domain
   424                   email address, and extracts just the domain
   425                  component. Example: 'User <user@example.com>' becomes
   425                   component. Example: 'User <user@example.com>' becomes
   426                  'example.com'.
   426                   'example.com'.
   427     :email:      Any text. Extracts the first string that looks like
   427     :email:       Any text. Extracts the first string that looks like
   428                  an email address. Example: 'User <user@example.com>'
   428                   an email address. Example: 'User <user@example.com>'
   429                  becomes 'user@example.com'.
   429                   becomes 'user@example.com'.
   430     :escape:     Any text. Replaces the special XML/XHTML characters
   430     :escape:      Any text. Replaces the special XML/XHTML characters
   431                  "&", "<" and ">" with XML entities.
   431                   "&", "<" and ">" with XML entities.
   432     :fill68:     Any text. Wraps the text to fit in 68 columns.
   432     :fill68:      Any text. Wraps the text to fit in 68 columns.
   433     :fill76:     Any text. Wraps the text to fit in 76 columns.
   433     :fill76:      Any text. Wraps the text to fit in 76 columns.
   434     :firstline:  Any text. Returns the first line of text.
   434     :firstline:   Any text. Returns the first line of text.
   435     :nonempty:   Any text. Returns '(none)' if the string is empty.
   435     :nonempty:    Any text. Returns '(none)' if the string is empty.
   436     :hgdate:     Date. Returns the date as a pair of numbers:
   436     :hgdate:      Date. Returns the date as a pair of numbers:
   437                  "1157407993 25200" (Unix timestamp, timezone offset).
   437                   "1157407993 25200" (Unix timestamp, timezone offset).
   438     :isodate:    Date. Returns the date in ISO 8601 format:
   438     :isodate:     Date. Returns the date in ISO 8601 format:
   439                  "2009-08-18 13:00 +0200".
   439                   "2009-08-18 13:00 +0200".
   440     :isodatesec: Date. Returns the date in ISO 8601 format, including
   440     :isodatesec:  Date. Returns the date in ISO 8601 format, including
   441                  seconds: "2009-08-18 13:00:13 +0200". See also the
   441                   seconds: "2009-08-18 13:00:13 +0200". See also the
   442                  rfc3339date filter.
   442                   rfc3339date filter.
   443     :localdate:  Date. Converts a date to local date.
   443     :localdate:   Date. Converts a date to local date.
   444     :obfuscate:  Any text. Returns the input text rendered as a
   444     :obfuscate:   Any text. Returns the input text rendered as a
   445                  sequence of XML entities.
   445                   sequence of XML entities.
   446     :person:     Any text. Returns the text before an email address.
   446     :person:      Any text. Returns the text before an email address.
   447     :rfc822date: Date. Returns a date using the same format used in
   447     :rfc822date:  Date. Returns a date using the same format used in
   448                  email headers: "Tue, 18 Aug 2009 13:00:13 +0200".
   448                   email headers: "Tue, 18 Aug 2009 13:00:13 +0200".
   449     :rfc3339date: Date. Returns a date using the Internet date format
   449     :rfc3339date: Date. Returns a date using the Internet date format
   450                   specified in RFC 3339: "2009-08-18T13:00:13+02:00".
   450                   specified in RFC 3339: "2009-08-18T13:00:13+02:00".
   451     :short:      Changeset hash. Returns the short form of a changeset
   451     :short:       Changeset hash. Returns the short form of a changeset
   452                  hash, i.e. a 12-byte hexadecimal string.
   452                   hash, i.e. a 12-byte hexadecimal string.
   453     :shortdate:  Date. Returns a date like "2006-09-18".
   453     :shortdate:   Date. Returns a date like "2006-09-18".
   454     :strip:      Any text. Strips all leading and trailing whitespace.
   454     :strip:       Any text. Strips all leading and trailing whitespace.
   455     :tabindent:  Any text. Returns the text, with every line except
   455     :tabindent:   Any text. Returns the text, with every line except
   456                  the first starting with a tab character.
   456                   the first starting with a tab character.
   457     :urlescape:  Any text. Escapes all "special" characters. For
   457     :urlescape:   Any text. Escapes all "special" characters. For
   458                  example, "foo bar" becomes "foo%20bar".
   458                   example, "foo bar" becomes "foo%20bar".
   459     :user:       Any text. Returns the user portion of an email
   459     :user:        Any text. Returns the user portion of an email
   460                  address.
   460                   address.
   461     ''')),
   461     ''')),
   462 
   462 
   463     (['urls'], _('URL Paths'),
   463     (['urls'], _('URL Paths'),
   464      _(r'''
   464      _(r'''
   465     Valid URLs are of the form::
   465     Valid URLs are of the form::