/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

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

  • Committer: Martin Pool
  • Date: 2007-10-03 08:06:44 UTC
  • mto: This revision was merged to the branch mainline in revision 2901.
  • Revision ID: mbp@sourcefrog.net-20071003080644-oivy0gkg98sex0ed
Avoid internal error tracebacks on failure to lock on readonly transport (#129701).

Add new LockFailed, which doesn't imply that we failed to get it because of
contention.  Raise this if we fail to create the pending or lock directories
because of Transport errors.

UnlockableTransport is not an internal error.

ReadOnlyLockError has a message which didn't match its name or usage; it's now
deprecated and callers are updated to use LockFailed which is more appropriate.

Add zero_ninetytwo deprecation symbol.

Unify assertMatchesRe with TestCase.assertContainsRe.

When the constructor is deprecated, just say that the class is deprecated, not
the __init__ method - this works better with applyDeprecated in tests.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/index.txt
 
1
=================
 
2
Bazaar User Guide
 
3
=================
 
4
 
 
5
.. Files are currently links but will become includes once the
 
6
.. content makes more sense as a whole.
 
7
.. Please mark sections in linked/included files as following:
 
8
..   level 1 ========
 
9
..   level 2 --------
 
10
..   level 3 ~~~~~~~~
 
11
..   level 4 ^^^^^^^^ (it is better not to use nesting deeper than 3 levels)
 
12
 
 
13
.. later contents::
 
14
.. later sectnum::
 
15
 
 
16
 
 
17
.. later Introduction
 
18
.. later ############
 
19
 
 
20
.. later include:: introducing_bazaar.txt
 
21
.. later include:: workflows.txt
 
22
 
 
23
 
 
24
Setting Up Bazaar
 
25
#################
 
26
 
 
27
.. later include:: download.txt
 
28
 
 
29
* `Introducing yourself <setting_up_email.html>`_ |--| The various ways that exist
 
30
  to tell Bazaar your email address for commits.
 
31
 
 
32
* `Using configuration files <configuration.html>`_ |--| Information on how to configure
 
33
  Bazaar.
 
34
 
 
35
 
 
36
Basic Topics
 
37
############
 
38
 
 
39
* `Tutorial <tutorial.html>`_ |--| Explains how to use bzr.
 
40
  Loaded with examples.
 
41
 
 
42
* `Specifying revision identifiers <specifying_revisions.html>`_ |--| Description 
 
43
  of the subarguments for ``-r`` as used by commands such as
 
44
  **bzr log** and **bzr merge**.
 
45
 
 
46
* `Running a Bazaar server <server.html>`_ |--| How to run a server 
 
47
  to allow remote access to Bazaar branches.
 
48
 
 
49
 
 
50
Advanced Topics
 
51
###############
 
52
 
 
53
* `Conflict handling <conflicts.html>`_ |--| The various kind of conflicts
 
54
  you may encounter, and how to handle them.
 
55
 
 
56
* `Centralized workflow <centralized_workflow.html>`_ |--| How to use Bazaar in
 
57
  a centralized way like CVS or Subversion.
 
58
 
 
59
.. later include:: using_bound_branches.txt
 
60
.. later include:: shared_repositories.txt
 
61
 
 
62
 
 
63
Best Practices
 
64
##############
 
65
 
 
66
* `Running a Bazaar smart server <http_smart_server.html>`_ |--| How to run 
 
67
  a smart HTTP server to allow remote access to Bazaar branches.
 
68
 
 
69
* `Shared repositories layouts <shared_repository_layouts.html>`_ |--| The
 
70
  pros and cons of various repository layouts.
 
71
 
 
72
.. later include:: tracking_upstream.txt
 
73
.. later include:: useful_tips.txt
 
74
 
 
75
 
 
76
Extending Bazaar
 
77
################
 
78
 
 
79
* `Plugins <plugins.html>`_ |--| Information on how to use plugins in Bazaar.
 
80
 
 
81
* `Hooks <hooks.html>`_ |--| How to set up hooks that are executed on certain
 
82
  Bazaar operations.
 
83
 
 
84
* `Using aliases <using_aliases.html>`_ |--| How to set up 
 
85
  and use command aliases.
 
86
 
 
87
 
 
88
Integrating Bazaar With Other Systems
 
89
#####################################
 
90
 
 
91
* `Bug trackers <bug_trackers.html>`_ |--| Information on how to integrate with bug trackers.
 
92
 
 
93
* `Exporting version information <version_info.html>`_ |--| How to export version numbers to a build system.
 
94
 
 
95
.. |--| unicode:: U+2014