comparison mercurial/help.py @ 9362:bb7e2cdd4854

help: align columns "hg help templates" output

9361:419aa488432e

       $ hg tip --template "{date|isodate}\n"
       2008-08-21 18:22 +0000

    List of filters:

    :addbreaks:  Any text. Add an XHTML "<br />" tag before the end of
                 every line except the last.
    :age:        Date. Returns a human-readable date/time difference
                 between the given date/time and the current
                 date/time.
    :basename:   Any text. Treats the text as a path, and returns the
                 last component of the path after splitting by the
                 path separator (ignoring trailing separators). For
                 example, "foo/bar/baz" becomes "baz" and "foo/bar//"
                 becomes "bar".
    :stripdir:   Treat the text as path and strip a directory level,
                 if possible. For example, "foo" and "foo/bar" becomes
                 "foo".
    :date:       Date. Returns a date in a Unix date format, including
                 the timezone: "Mon Sep 04 15:13:13 2006 0700".
    :domain:     Any text. Finds the first string that looks like an
                 email address, and extracts just the domain
                 component. Example: 'User <[e-mail]>' becomes
                 'example.com'.
    :email:      Any text. Extracts the first string that looks like
                 an email address. Example: 'User <[e-mail]>'
                 becomes '[e-mail]'.
    :escape:     Any text. Replaces the special XML/XHTML characters
                 "&", "<" and ">" with XML entities.
    :fill68:     Any text. Wraps the text to fit in 68 columns.
    :fill76:     Any text. Wraps the text to fit in 76 columns.
    :firstline:  Any text. Returns the first line of text.
    :nonempty:   Any text. Returns '(none)' if the string is empty.
    :hgdate:     Date. Returns the date as a pair of numbers:
                 "1157407993 25200" (Unix timestamp, timezone offset).
    :isodate:    Date. Returns the date in ISO 8601 format:
                 "2009-08-18 13:00 +0200".
    :isodatesec: Date. Returns the date in ISO 8601 format, including
                 seconds: "2009-08-18 13:00:13 +0200". See also the
                 rfc3339date filter.
    :localdate:  Date. Converts a date to local date.
    :obfuscate:  Any text. Returns the input text rendered as a
                 sequence of XML entities.
    :person:     Any text. Returns the text before an email address.
    :rfc822date: Date. Returns a date using the same format used in
                 email headers: "Tue, 18 Aug 2009 13:00:13 +0200".
    :rfc3339date: Date. Returns a date using the Internet date format
                  specified in RFC 3339: "2009-08-18T13:00:13+02:00".
    :short:      Changeset hash. Returns the short form of a changeset
                 hash, i.e. a 12-byte hexadecimal string.
    :shortdate:  Date. Returns a date like "2006-09-18".
    :strip:      Any text. Strips all leading and trailing whitespace.
    :tabindent:  Any text. Returns the text, with every line except
                 the first starting with a tab character.
    :urlescape:  Any text. Escapes all "special" characters. For
                 example, "foo bar" becomes "foo%20bar".
    :user:       Any text. Returns the user portion of an email
                 address.
    ''')),

    (['urls'], _('URL Paths'),
     _(r'''
    Valid URLs are of the form::

9362:bb7e2cdd4854

       $ hg tip --template "{date|isodate}\n"
       2008-08-21 18:22 +0000

    List of filters:

    :addbreaks:   Any text. Add an XHTML "<br />" tag before the end of
                  every line except the last.
    :age:         Date. Returns a human-readable date/time difference
                  between the given date/time and the current
                  date/time.
    :basename:    Any text. Treats the text as a path, and returns the
                  last component of the path after splitting by the
                  path separator (ignoring trailing separators). For
                  example, "foo/bar/baz" becomes "baz" and "foo/bar//"
                  becomes "bar".
    :stripdir:    Treat the text as path and strip a directory level,
                  if possible. For example, "foo" and "foo/bar" becomes
                  "foo".
    :date:        Date. Returns a date in a Unix date format, including
                  the timezone: "Mon Sep 04 15:13:13 2006 0700".
    :domain:      Any text. Finds the first string that looks like an
                  email address, and extracts just the domain
                  component. Example: 'User <[e-mail]>' becomes
                  'example.com'.
    :email:       Any text. Extracts the first string that looks like
                  an email address. Example: 'User <[e-mail]>'
                  becomes '[e-mail]'.
    :escape:      Any text. Replaces the special XML/XHTML characters
                  "&", "<" and ">" with XML entities.
    :fill68:      Any text. Wraps the text to fit in 68 columns.
    :fill76:      Any text. Wraps the text to fit in 76 columns.
    :firstline:   Any text. Returns the first line of text.
    :nonempty:    Any text. Returns '(none)' if the string is empty.
    :hgdate:      Date. Returns the date as a pair of numbers:
                  "1157407993 25200" (Unix timestamp, timezone offset).
    :isodate:     Date. Returns the date in ISO 8601 format:
                  "2009-08-18 13:00 +0200".
    :isodatesec:  Date. Returns the date in ISO 8601 format, including
                  seconds: "2009-08-18 13:00:13 +0200". See also the
                  rfc3339date filter.
    :localdate:   Date. Converts a date to local date.
    :obfuscate:   Any text. Returns the input text rendered as a
                  sequence of XML entities.
    :person:      Any text. Returns the text before an email address.
    :rfc822date:  Date. Returns a date using the same format used in
                  email headers: "Tue, 18 Aug 2009 13:00:13 +0200".
    :rfc3339date: Date. Returns a date using the Internet date format
                  specified in RFC 3339: "2009-08-18T13:00:13+02:00".
    :short:       Changeset hash. Returns the short form of a changeset
                  hash, i.e. a 12-byte hexadecimal string.
    :shortdate:   Date. Returns a date like "2006-09-18".
    :strip:       Any text. Strips all leading and trailing whitespace.
    :tabindent:   Any text. Returns the text, with every line except
                  the first starting with a tab character.
    :urlescape:   Any text. Escapes all "special" characters. For
                  example, "foo bar" becomes "foo%20bar".
    :user:        Any text. Returns the user portion of an email
                  address.
    ''')),

    (['urls'], _('URL Paths'),
     _(r'''
    Valid URLs are of the form::