← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/help_topics/en/log-formats.txt

merge log help improvements

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/help_topics/en/log-formats.txt
 
1
Log formats
 
2
===========
 
3
 
 
4
A log format controls how information about each revision is displayed.
 
5
The standard log formats are compared below::
 
6
 
 
7
  Feature                 long           short         line
 
8
  ----------------------  -------------  ------------  -------------------
 
9
  design goal             detailed view  concise view  1 revision per line
 
10
  committer               name+email     name only     name only
 
11
  author                  name+email     -             -
 
12
  date-time format        full           date only     date only
 
13
  commit message          full           full          top line
 
14
  tags                    yes            yes           yes
 
15
  merges indicator        -              yes           -
 
16
  status/delta            optional       optional      -
 
17
  diff/patch              optional       optional      -
 
18
  revision-id             optional       optional      -
 
19
  branch nick             yes            -             -
 
20
  foreign vcs properties  yes            yes           -
 
21
  preferred levels        all            1             1
 
22
 
 
23
The default format is ``long``. To change this, define the ``log_format``
 
24
setting in the ``[DEFAULT]`` section of ``bazaar.conf`` like this (say)::
 
25
 
 
26
  [DEFAULT]
 
27
  log_format = short
 
28
 
 
29
Alternatively, to change the log format used for a given query, use the
 
30
--long, --short or --line options.
 
31
 
 
32
If one of the standard log formats does not meet your needs, additional
 
33
formats can be provided by plugins.