← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/en/user-guide/version_info.txt

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2007-12-18 23:41:30 UTC
  • mfrom: (3099.3.7 graph_optimization)
  • Revision ID: pqm@pqm.ubuntu.com-20071218234130-061grgxsaf1g7bao
(jam) Implement ParentProviders.get_parent_map() and deprecate
        get_parents()

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/version_info.txt
15
15
--------------------------------
16
16
 
17
17
The ``version-info`` command can be used to output more information
18
 
about the latest version like this::
 
18
about the lastest version like this::
19
19
 
20
20
  $ bzr version-info
21
21
  revision-id: pqm@pqm.ubuntu.com-20071211175118-s94sizduj201hrs5
25
25
  branch-nick: bzr.dev
26
26
 
27
27
You can easily filter that output using operating system tools or
28
 
scripts. For example::
 
28
scripts. For example (on Linux/Unix)::
29
29
 
30
30
  $ bzr version-info | grep ^date
31
31
  date: 2007-12-11 17:51:18 +0000
67
67
    or ``--include-file-revisions``.
68
68
 
69
69
 
70
 
Getting version info in other formats
71
 
-------------------------------------
72
 
 
73
 
Bazaar supports a template-based method for getting version information in
74
 
arbitrary formats.  The ``--custom`` option to ``version-info`` can be
75
 
used by providing a ``--template`` argument that contains variables that
76
 
will be expanded based on the status of the working tree.  For example, to
77
 
generate a C header file with a formatted string containing the current
78
 
revision number::
79
 
 
80
 
 bzr version-info --custom \
81
 
      --template="#define VERSION_INFO \"Project 1.2.3 (r{revno})\"\n" \
82
 
      > version_info.h
83
 
 
84
 
where the ``{revno}`` will be replaced by the revision number of the
85
 
working tree.  (If the example above doesn't work on your OS, try
86
 
entering the command all on one line.) For more information on the
87
 
variables that can be used in templates, see `Version Info`_ in the
88
 
Bazaar User Reference.
89
 
 
90
 
.. _Version Info: ../user-reference/index.html#version-info
91
 
 
92
 
Predefined formats for dumping version information in specific languages
93
 
are currently in development. Please contact us on the mailing list about
94
 
your requirements in this area.
 
70
Projects in other languages
 
71
---------------------------
 
72
 
 
73
Support for dumping version information in other languages is currently
 
74
in development. Please contact us on the mailing list about your
 
75
requirements in this area. (As of the Bazaar 1.0 release date, some patches
 
76
are available for other languages but are not yet merged into the core product.)
 
77
 
95
78
 
96
79
Check clean
97
80
-----------
104
87
set the ``clean`` flag in ``version_info``, as well as set entries in
105
88
``file_revisions`` as ``modified`` where appropriate.
106
89
 
107
 
..
 
90
.. 
108
91
   vim: tw=74 ft=rst spell spelllang=en_us