comparison doc/hg.1.txt @ 1907:7718885070b1

let commands that show changesets use templates. mechanism is same as hgweb templates. old show_changeset code is still used for now if no template given, because it is faster than template code when verbose or debug. simple template can be given on command line using -t, --template. example: hg log -t '{author|person}\n' complex template can be put in template map file, given on command line using --map-file. we give two example map files: map-log.compact prints 3 lines of output for every change. map-log.verbose prints exact same output as default "hg log -v". map files are searched where user says, then in template path as backup. example: hg log --map-file map-log.compact defaults can be set in hgrc with ui.logtemplate and ui.logmap.
author Vadim Gelfer <vadim.gelfer@gmail.com>
date Mon, 27 Feb 2006 13:18:57 -0800
parents 47f4fbee32c5
children 74cf2b2f43d4
comparison
equal deleted inserted replaced
1906:9dec2479622d 1907:7718885070b1
292 292
293 Repository "heads" are changesets that don't have children 293 Repository "heads" are changesets that don't have children
294 changesets. They are where development generally takes place and 294 changesets. They are where development generally takes place and
295 are the usual targets for update and merge operations. 295 are the usual targets for update and merge operations.
296 296
297 options:
298 -b, --branches show branches
299 --map-file <file> display using template map file
300 -r, --rev <rev> show only heads which are descendants of rev
301 -t, --template <tpl> display using template
302
297 identify:: 303 identify::
298 Print a short summary of the current state of the repo. 304 Print a short summary of the current state of the repo.
299 305
300 This summary identifies the repository state using one or two parent 306 This summary identifies the repository state using one or two parent
301 hash identifiers, followed by a "+" if there are uncommitted changes 307 hash identifiers, followed by a "+" if there are uncommitted changes
329 was requested. 335 was requested.
330 336
331 Currently only local repositories are supported. 337 Currently only local repositories are supported.
332 338
333 options: 339 options:
340 -M, --no-merges do not show merges
341 --map-file <file> display using template map file
342 -n, --newest-first show newest records first
334 -p, --patch show patch 343 -p, --patch show patch
344 -t, --template <tpl> display using template
335 345
336 aliases: in 346 aliases: in
337 347
338 init [dest]:: 348 init [dest]::
339 Initialize a new repository in the given directory. If the given 349 Initialize a new repository in the given directory. If the given
377 -I, --include <pat> include names matching the given patterns 387 -I, --include <pat> include names matching the given patterns
378 -X, --exclude <pat> exclude names matching the given patterns 388 -X, --exclude <pat> exclude names matching the given patterns
379 -b, --branch show branches 389 -b, --branch show branches
380 -k, --keyword <str> search for keywords 390 -k, --keyword <str> search for keywords
381 -l, --limit <num> print no more than this many changes 391 -l, --limit <num> print no more than this many changes
392 --map-file <file> display using template map file
382 -M, --no-merges do not show merges 393 -M, --no-merges do not show merges
383 -m, --only-merges only show merges 394 -m, --only-merges only show merges
384 -r, --rev <A> show the specified revision or range 395 -r, --rev <A> show the specified revision or range
385 -p, --patch show patch 396 -p, --patch show patch
397 -t, --template <tpl> display using template
386 398
387 aliases: history 399 aliases: history
388 400
389 manifest [revision]:: 401 manifest [revision]::
390 Print a list of version controlled files for the given revision. 402 Print a list of version controlled files for the given revision.
398 if a push was requested. 410 if a push was requested.
399 411
400 See pull for valid source format details. 412 See pull for valid source format details.
401 413
402 options: 414 options:
415 -M, --no-merges do not show merges
416 --map-file <file> display using template map file
403 -p, --patch show patch 417 -p, --patch show patch
418 -n, --newest-first show newest records first
419 -t, --template <tpl> display using template
404 420
405 aliases: out 421 aliases: out
406 422
407 parents:: 423 parents::
408 Print the working directory's parent revisions. 424 Print the working directory's parent revisions.
425
426 options:
427 -b, --branches show branches
428 --map-file <file> display using template map file
429 -t, --template <tpl> display using template
409 430
410 paths [NAME]:: 431 paths [NAME]::
411 Show definition of symbolic path name NAME. If no name is given, show 432 Show definition of symbolic path name NAME. If no name is given, show
412 definition of available names. 433 definition of available names.
413 434
611 632
612 tip [-p]:: 633 tip [-p]::
613 Show the tip revision. 634 Show the tip revision.
614 635
615 options: 636 options:
616 -p, --patch show patch 637 -b, --branches show branches
638 --map-file <file> display using template map file
639 -p, --patch show patch
640 -t, --template <tpl> display using template
617 641
618 unbundle <file>:: 642 unbundle <file>::
619 (EXPERIMENTAL) 643 (EXPERIMENTAL)
620 644
621 Apply a compressed changegroup file generated by the bundle 645 Apply a compressed changegroup file generated by the bundle