Mercurial > public > mercurial-scm > hg-stable

comparison mercurial/help.py @ 9362:bb7e2cdd4854

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
help: align columns "hg help templates" output
author Martin Geisler <mg@lazybytes.net>
date Tue, 18 Aug 2009 13:59:30 +0200
parents 419aa488432e
children f04d17912441
comparison
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::