~bzr-pqm/bzr/bzr.dev

4927.2.1 by Ian Clatworthy
conflicts topic renamed to conflict-types and other minor help clean-ups
1
Log Formats
3974.1.4 by Ian Clatworthy
log-formats topic and explained range searching
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.