5294
5309
#: bzrlib/plugins/launchpad/__init__.py:388
5295
5310
msgid " bzr lp-find-proposal -r annotate:README:1"
5313
#: dummy/help_topics/authentication/summary.txt:1
5314
msgid "Information on configuring authentication"
5317
#: dummy/help_topics/basic/detail.txt:1
5319
"Bazaar 2.5.0dev1 -- a free distributed version-control tool\n"
5320
"http://bazaar.canonical.com/"
5323
#: dummy/help_topics/basic/detail.txt:4
5326
" bzr init makes this directory a versioned branch\n"
5327
" bzr branch make a copy of another branch"
5330
#: dummy/help_topics/basic/detail.txt:8
5332
" bzr add make files or directories versioned\n"
5333
" bzr ignore ignore a file or pattern\n"
5334
" bzr mv move or rename a versioned file"
5337
#: dummy/help_topics/basic/detail.txt:12
5339
" bzr status summarize changes in working copy\n"
5340
" bzr diff show detailed diffs"
5343
#: dummy/help_topics/basic/detail.txt:15
5345
" bzr merge pull in changes from another branch\n"
5346
" bzr commit save some or all changes\n"
5347
" bzr send send changes via email"
5350
#: dummy/help_topics/basic/detail.txt:19
5352
" bzr log show history of changes\n"
5353
" bzr check validate storage"
5356
#: dummy/help_topics/basic/detail.txt:22
5358
" bzr help init more help on e.g. init command\n"
5359
" bzr help commands list all commands\n"
5360
" bzr help topics list all help topics\n"
5363
#: dummy/help_topics/basic/summary.txt:1
5364
msgid "Basic commands"
5367
#: dummy/help_topics/branches/detail.txt:1
5371
#: dummy/help_topics/branches/detail.txt:3
5373
"A branch consists of the state of a project, including all of its\n"
5374
"history. All branches have a repository associated (which is where the\n"
5375
"branch history is stored), but multiple branches may share the same\n"
5376
"repository (a shared repository). Branches can be copied and merged."
5379
#: dummy/help_topics/branches/detail.txt:8
5381
"In addition, one branch may be bound to another one. Binding to another\n"
5382
"branch indicates that commits which happen in this branch must also \n"
5383
"happen in the other branch. Bazaar ensures consistency by not allowing \n"
5384
"commits when the two branches are out of date. In order for a commit \n"
5385
"to succeed, it may be necessary to update the current branch using \n"
5389
#: dummy/help_topics/branches/detail.txt:15
5390
msgid "Related commands::"
5393
#: dummy/help_topics/branches/detail.txt:17
5395
" init Change a directory into a versioned branch.\n"
5396
" branch Create a new branch that is a copy of an existing branch.\n"
5397
" merge Perform a three-way merge.\n"
5398
" bind Bind a branch to another one.\n"
5401
#: dummy/help_topics/branches/summary.txt:1
5402
msgid "Information on what a branch is"
5405
#: dummy/help_topics/bugs/summary.txt:1
5406
msgid "Bug tracker settings"
5409
#: dummy/help_topics/checkouts/detail.txt:1
5413
#: dummy/help_topics/checkouts/detail.txt:3
5415
"Checkouts are source trees that are connected to a branch, so that when\n"
5416
"you commit in the source tree, the commit goes into that branch. They\n"
5417
"allow you to use a simpler, more centralized workflow, ignoring some of\n"
5418
"Bazaar's decentralized features until you want them. Using checkouts\n"
5419
"with shared repositories is very similar to working with SVN or CVS, but\n"
5420
"doesn't have the same restrictions. And using checkouts still allows\n"
5421
"others working on the project to use whatever workflow they like."
5424
#: dummy/help_topics/checkouts/detail.txt:11
5426
"A checkout is created with the bzr checkout command (see \"help checkout"
5428
"You pass it a reference to another branch, and it will create a local copy\n"
5429
"for you that still contains a reference to the branch you created the\n"
5430
"checkout from (the master branch). Then if you make any commits they will "
5432
"made on the other branch first. This creates an instant mirror of your work, "
5434
"facilitates lockstep development, where each developer is working together,\n"
5435
"continuously integrating the changes of others."
5438
#: dummy/help_topics/checkouts/detail.txt:19
5440
"However the checkout is still a first class branch in Bazaar terms, so that\n"
5441
"you have the full history locally. As you have a first class branch you "
5443
"also commit locally if you want, for instance due to the temporary loss af "
5445
"network connection. Use the --local option to commit to do this. All the "
5447
"commits will then be made on the master branch the next time you do a non-"
5452
#: dummy/help_topics/checkouts/detail.txt:26
5454
"If you are using a checkout from a shared branch you will periodically want "
5456
"pull in all the changes made by others. This is done using the \"update\"\n"
5457
"command. The changes need to be applied before any non-local commit, but\n"
5458
"Bazaar will tell you if there are any changes and suggest that you use this\n"
5459
"command when needed."
5462
#: dummy/help_topics/checkouts/detail.txt:32
5464
"It is also possible to create a \"lightweight\" checkout by passing the\n"
5465
"--lightweight flag to checkout. A lightweight checkout is even closer to an\n"
5466
"SVN checkout in that it is not a first class branch, it mainly consists of "
5468
"working tree. This means that any history operations must query the master\n"
5469
"branch, which could be slow if a network connection is involved. Also, as "
5471
"don't have a local branch, then you cannot commit locally."
5474
#: dummy/help_topics/checkouts/detail.txt:39
5476
"Lightweight checkouts work best when you have fast reliable access to the\n"
5477
"master branch. This means that if the master branch is on the same disk or "
5479
"a lightweight checkout will be faster than a heavyweight one for any "
5481
"that modify the revision history (as only one copy of the branch needs to\n"
5482
"be updated). Heavyweight checkouts will generally be faster for any command\n"
5483
"that uses the history but does not change it, but if the master branch is "
5485
"the same disk then there won't be a noticeable difference."
5488
#: dummy/help_topics/checkouts/detail.txt:47
5490
"Another possible use for a checkout is to use it with a treeless repository\n"
5491
"containing your branches, where you maintain only one working tree by\n"
5492
"switching the master branch that the checkout points to when you want to\n"
5493
"work on a different branch."
5496
#: dummy/help_topics/checkouts/detail.txt:52
5498
"Obviously to commit on a checkout you need to be able to write to the "
5500
"branch. This means that the master branch must be accessible over a "
5502
"protocol , such as sftp://, and that you have write permissions at the "
5504
"end. Checkouts also work on the local file system, so that all that matters "
5509
#: dummy/help_topics/checkouts/detail.txt:58
5511
"You can change the master of a checkout by using the \"switch\" command "
5513
"\"help switch\"). This will change the location that the commits are sent "
5515
"The \"bind\" command can also be used to turn a normal branch into a heavy\n"
5516
"checkout. If you would like to convert your heavy checkout into a normal\n"
5517
"branch so that every commit is local, you can use the \"unbind\" command. To "
5519
"whether or not a branch is bound or not you can use the \"info\" command. If "
5521
"branch is bound it will tell you the location of the bound branch."
5524
#: dummy/help_topics/checkouts/detail.txt:68
5526
" checkout Create a checkout. Pass --lightweight to get a lightweight\n"
5528
" update Pull any changes in the master branch in to your checkout\n"
5529
" commit Make a commit that is sent to the master branch. If you have\n"
5530
" a heavy checkout then the --local option will commit to the\n"
5531
" checkout without sending the commit to the master\n"
5532
" switch Change the master branch that the commits in the checkout "
5535
" bind Turn a standalone branch into a heavy checkout so that any\n"
5536
" commits will be sent to the master branch\n"
5537
" unbind Turn a heavy checkout into a standalone branch so that any\n"
5538
" commits are only made locally\n"
5539
" info Displays whether a branch is bound or unbound. If the branch "
5541
" bound, then it will also display the location of the bound "
5545
#: dummy/help_topics/checkouts/summary.txt:1
5546
msgid "Information on what a checkout is"
5549
#: dummy/help_topics/commands/summary.txt:1
5550
msgid "Basic help for all commands"
5553
#: dummy/help_topics/configuration/summary.txt:1
5554
msgid "Details on the configuration settings available"
5557
#: dummy/help_topics/conflict-types/summary.txt:1
5558
msgid "Types of conflicts and what to do about them"
5561
#: dummy/help_topics/content-filters/summary.txt:1
5562
msgid "Conversion of content into/from working trees"
5565
#: dummy/help_topics/criss-cross/detail.txt:1
5569
#: dummy/help_topics/criss-cross/detail.txt:3
5571
"A criss-cross in the branch history can cause the default merge technique\n"
5572
"to emit more conflicts than would normally be expected."
5575
#: dummy/help_topics/criss-cross/detail.txt:6
5577
"In complex merge cases, ``bzr merge --lca`` or ``bzr merge --weave`` may "
5579
"better results. You may wish to ``bzr revert`` the working tree and merge\n"
5580
"again. Alternatively, use ``bzr remerge`` on particular conflicted files."
5583
#: dummy/help_topics/criss-cross/detail.txt:10
5585
"Criss-crosses occur in a branch's history if two branches merge the same "
5587
"and then merge one another, or if two branches merge one another at the "
5589
"time. They can be avoided by having each branch only merge from or into a\n"
5590
"designated central branch (a \"star topology\")."
5593
#: dummy/help_topics/criss-cross/detail.txt:15
5595
"Criss-crosses cause problems because of the way merge works. Bazaar's "
5597
"merge is a three-way merger; in order to merge OTHER into THIS, it must\n"
5598
"find a basis for comparison, BASE. Using BASE, it can determine whether\n"
5599
"differences between THIS and OTHER are due to one side adding lines, or\n"
5600
"from another side removing lines."
5603
#: dummy/help_topics/criss-cross/detail.txt:21
5605
"Criss-crosses mean there is no good choice for a base. Selecting the "
5607
"merge points could cause one side's changes to be silently discarded.\n"
5608
"Selecting older merge points (which Bazaar does) mean that extra conflicts\n"
5612
#: dummy/help_topics/criss-cross/detail.txt:26
5614
"The ``weave`` merge type is not affected by this problem because it uses\n"
5615
"line-origin detection instead of a basis revision to determine the cause of\n"
5619
#: dummy/help_topics/criss-cross/summary.txt:1
5620
msgid "Information on criss-cross merging"
5623
#: dummy/help_topics/current-formats/summary.txt:1
5624
msgid "Current storage formats"
5627
#: dummy/help_topics/debug-flags/summary.txt:1
5628
msgid "Options to show or record debug information"
5631
#: dummy/help_topics/diverged-branches/summary.txt:1
5632
msgid "How to fix diverged branches"
5635
#: dummy/help_topics/env-variables/detail.txt:1
5636
msgid "Environment Variables"
5639
#: dummy/help_topics/env-variables/detail.txt:3
5641
"=================== "
5642
"===========================================================\n"
5643
"BZRPATH Path where bzr is to look for shell plugin external\n"
5645
"BZR_EMAIL E-Mail address of the user. Overrides EMAIL.\n"
5646
"EMAIL E-Mail address of the user.\n"
5647
"BZR_EDITOR Editor for editing commit messages. Overrides EDITOR.\n"
5648
"EDITOR Editor for editing commit messages.\n"
5649
"BZR_PLUGIN_PATH Paths where bzr should look for plugins.\n"
5650
"BZR_DISABLE_PLUGINS Plugins that bzr should not load.\n"
5651
"BZR_PLUGINS_AT Plugins to load from a directory not in "
5652
"BZR_PLUGIN_PATH.\n"
5653
"BZR_HOME Directory holding .bazaar config dir. Overrides HOME.\n"
5654
"BZR_HOME (Win32) Directory holding bazaar config dir. Overrides APPDATA "
5657
"BZR_REMOTE_PATH Full name of remote 'bzr' command (for bzr+ssh:// "
5659
"BZR_SSH Path to SSH client, or one of paramiko, openssh, "
5662
"BZR_LOG Location of .bzr.log (use '/dev/null' to suppress log).\n"
5663
"BZR_LOG (Win32) Location of .bzr.log (use 'NUL' to suppress log).\n"
5664
"BZR_COLUMNS Override implicit terminal width.\n"
5665
"BZR_CONCURRENCY Number of processes that can be run concurrently "
5667
"BZR_PROGRESS_BAR Override the progress display. Values are 'none' or "
5669
"BZR_PDB Control whether to launch a debugger on error.\n"
5670
"BZR_SIGQUIT_PDB Control whether SIGQUIT behaves normally or invokes a\n"
5671
" breakin debugger.\n"
5672
"=================== "
5673
"===========================================================\n"
5676
#: dummy/help_topics/env-variables/summary.txt:1
5677
msgid "Environment variable names and values"
5680
#: dummy/help_topics/eol/summary.txt:1
5681
msgid "Information on end-of-line handling"
5684
#: dummy/help_topics/files/detail.txt:1
5688
#: dummy/help_topics/files/detail.txt:3
5690
":On Unix: ~/.bazaar/bazaar.conf\n"
5691
":On Windows: C:\\\\Documents and Settings\\\\username\\\\Application Data\\"
5692
"\\bazaar\\\\2.0\\\\bazaar.conf"
5695
#: dummy/help_topics/files/detail.txt:6
5697
"Contains the user's default configuration. The section ``[DEFAULT]`` is\n"
5698
"used to define general configuration that will be applied everywhere.\n"
5699
"The section ``[ALIASES]`` can be used to create command aliases for\n"
5700
"commonly used options."
5703
#: dummy/help_topics/files/detail.txt:11
5704
msgid "A typical config file might look something like::"
5707
#: dummy/help_topics/files/detail.txt:13
5710
" email=John Doe <jdoe@isp.com>"
5713
#: dummy/help_topics/files/detail.txt:16
5716
" commit = commit --strict\n"
5717
" log10 = log --short -r -10..-1\n"
5720
#: dummy/help_topics/files/summary.txt:1
5721
msgid "Information on configuration and log files"
5724
#: dummy/help_topics/formats/detail.txt:1
5725
msgid "Storage Formats"
5728
#: dummy/help_topics/formats/detail.txt:3
5730
"To ensure that older clients do not access data incorrectly,\n"
5731
"Bazaar's policy is to introduce a new storage format whenever\n"
5732
"new features requiring new metadata are added. New storage\n"
5733
"formats may also be introduced to improve performance and\n"
5737
#: dummy/help_topics/formats/detail.txt:9
5739
"The newest format, 2a, is highly recommended. If your\n"
5740
"project is not using 2a, then you should suggest to the\n"
5741
"project owner to upgrade."
5744
#: dummy/help_topics/formats/detail.txt:13
5750
#: dummy/help_topics/formats/detail.txt:16
5752
" Some of the older formats have two variants:\n"
5753
" a plain one and a rich-root one. The latter include an additional\n"
5754
" field about the root of the tree. There is no performance cost\n"
5755
" for using a rich-root format but you cannot easily merge changes\n"
5756
" from a rich-root format into a plain format. As a consequence,\n"
5757
" moving a project to a rich-root format takes some co-ordination\n"
5758
" in that all contributors need to upgrade their repositories\n"
5759
" around the same time. 2a and all future formats will be\n"
5760
" implicitly rich-root."
5763
#: dummy/help_topics/formats/detail.txt:26
5765
"See :doc:`current-formats-help` for the complete list of\n"
5766
"currently supported formats. See :doc:`other-formats-help` for\n"
5767
"descriptions of any available experimental and deprecated formats.\n"
5770
#: dummy/help_topics/formats/summary.txt:1
5771
msgid "Information on choosing a storage format"
5774
#: dummy/help_topics/global-options/detail.txt:1
5775
msgid "Global Options"
5778
#: dummy/help_topics/global-options/detail.txt:3
5780
"These options may be used with any command, and may appear in front of any\n"
5781
"command. (e.g. ``bzr --profile help``)."
5784
#: dummy/help_topics/global-options/detail.txt:6
5786
"--version Print the version number. Must be supplied before the "
5788
"--no-aliases Do not process command aliases when running this command.\n"
5789
"--builtin Use the built-in version of a command, not the plugin "
5791
" This does not suppress other plugin effects.\n"
5792
"--no-plugins Do not process any plugins.\n"
5793
"--no-l10n Do not translate messages.\n"
5794
"--concurrency Number of processes that can be run concurrently (selftest)."
5797
#: dummy/help_topics/global-options/detail.txt:14
5799
"--profile Profile execution using the hotshot profiler.\n"
5800
"--lsprof Profile execution using the lsprof profiler.\n"
5801
"--lsprof-file Profile execution using the lsprof profiler, and write the\n"
5802
" results to a specified file. If the filename ends with \".txt"
5804
" text format will be used. If the filename either starts "
5806
" \"callgrind.out\" or end with \".callgrind\", the output will "
5808
" formatted for use with KCacheGrind. Otherwise, the output\n"
5809
" will be a pickle.\n"
5810
"--coverage Generate line coverage report in the specified directory."
5813
#: dummy/help_topics/global-options/detail.txt:24
5815
"See http://doc.bazaar.canonical.com/developers/profiling.html for more\n"
5816
"information on profiling."
5819
#: dummy/help_topics/global-options/detail.txt:27
5821
"A number of debug flags are also available to assist troubleshooting and\n"
5822
"development. See :doc:`debug-flags-help`.\n"
5825
#: dummy/help_topics/global-options/summary.txt:1
5826
msgid "Options that control how Bazaar runs"
5829
#: dummy/help_topics/hidden-commands/summary.txt:1
5830
msgid "All hidden commands"
5833
#: dummy/help_topics/hooks/summary.txt:1
5834
msgid "Points at which custom processing can be added"
5837
#: dummy/help_topics/launchpad/detail.txt:1
5838
msgid "Integration with Launchpad.net"
5841
#: dummy/help_topics/launchpad/detail.txt:3
5843
"Launchpad.net provides free Bazaar branch hosting with integrated bug and\n"
5844
"specification tracking."
5847
#: dummy/help_topics/launchpad/detail.txt:6
5849
"The bzr client (through the plugin called 'launchpad') has special\n"
5850
"features to communicate with Launchpad:"
5853
#: dummy/help_topics/launchpad/detail.txt:9
5855
" * The launchpad-login command tells Bazaar your Launchpad user name. "
5857
" is then used by the 'lp:' transport to download your branches using\n"
5861
#: dummy/help_topics/launchpad/detail.txt:13
5863
" * The 'lp:' transport uses Launchpad as a directory service: for "
5865
" 'lp:bzr' and 'lp:python' refer to the main branches of the relevant\n"
5866
" projects and may be branched, logged, etc. You can also use the 'lp:'\n"
5867
" transport to refer to specific branches, e.g. lp:~bzr/bzr/trunk."
5870
#: dummy/help_topics/launchpad/detail.txt:18
5872
" * The 'lp:' bug tracker alias can expand launchpad bug numbers to their\n"
5873
" URLs for use with 'bzr commit --fixes', e.g. 'bzr commit --fixes "
5875
" will record a revision property that marks that revision as fixing\n"
5876
" Launchpad bug 12345. When you push that branch to Launchpad it will\n"
5877
" automatically be linked to the bug report."
5880
#: dummy/help_topics/launchpad/detail.txt:24
5882
" * The register-branch command tells Launchpad about the url of a\n"
5883
" public branch. Launchpad will then mirror the branch, display\n"
5884
" its contents and allow it to be attached to bugs and other\n"
5888
#: dummy/help_topics/launchpad/detail.txt:29
5889
msgid "For more information see http://help.launchpad.net/\n"
5892
#: dummy/help_topics/launchpad/summary.txt:1
5893
msgid "Using Bazaar with Launchpad.net"
5896
#: dummy/help_topics/location-alias/summary.txt:1
5897
msgid "Aliases for remembered locations"
5900
#: dummy/help_topics/log-formats/summary.txt:1
5901
msgid "Details on the logging formats available"
5904
#: dummy/help_topics/other-formats/summary.txt:1
5905
msgid "Experimental and deprecated storage formats"
5908
#: dummy/help_topics/patterns/summary.txt:1
5909
msgid "Information on the pattern syntax"
5912
#: dummy/help_topics/repositories/detail.txt:1
5913
msgid "Repositories"
5916
#: dummy/help_topics/repositories/detail.txt:3
5918
"Repositories in Bazaar are where committed information is stored. There is\n"
5919
"a repository associated with every branch."
5922
#: dummy/help_topics/repositories/detail.txt:6
5924
"Repositories are a form of database. Bzr will usually maintain this for\n"
5925
"good performance automatically, but in some situations (e.g. when doing\n"
5926
"very many commits in a short time period) you may want to ask bzr to\n"
5927
"optimise the database indices. This can be done by the 'bzr pack' command."
5930
#: dummy/help_topics/repositories/detail.txt:11
5932
"By default just running 'bzr init' will create a repository within the new\n"
5933
"branch but it is possible to create a shared repository which allows "
5935
"branches to share their information in the same location. When a new branch "
5937
"created it will first look to see if there is a containing shared repository "
5942
#: dummy/help_topics/repositories/detail.txt:17
5944
"When two branches of the same project share a repository, there is\n"
5945
"generally a large space saving. For some operations (e.g. branching\n"
5946
"within the repository) this translates in to a large time saving."
5949
#: dummy/help_topics/repositories/detail.txt:21
5951
"To create a shared repository use the init-repository command (or the alias\n"
5952
"init-repo). This command takes the location of the repository to create. "
5954
"means that 'bzr init-repository repo' will create a directory named 'repo',\n"
5955
"which contains a shared repository. Any new branches that are created in "
5957
"directory will then use it for storage."
5960
#: dummy/help_topics/repositories/detail.txt:27
5962
"It is a good idea to create a repository whenever you might create more\n"
5963
"than one branch of a project. This is true for both working areas where you\n"
5964
"are doing the development, and any server areas that you use for hosting\n"
5965
"projects. In the latter case, it is common to want branches without working\n"
5966
"trees. Since the files in the branch will not be edited directly there is "
5968
"need to use up disk space for a working tree. To create a repository in "
5970
"the branches will not have working trees pass the '--no-trees' option to\n"
5971
"'init-repository'."
5974
#: dummy/help_topics/repositories/detail.txt:38
5976
" init-repository Create a shared repository. Use --no-trees to create "
5978
" in which new branches won't get a working tree.\n"
5981
#: dummy/help_topics/repositories/summary.txt:1
5982
msgid "Basic information on shared repositories."
5985
#: dummy/help_topics/revisionspec/summary.txt:1
5986
msgid "Explain how to use --revision"
5989
#: dummy/help_topics/rules/summary.txt:1
5990
msgid "Information on defining rule-based preferences"
5993
#: dummy/help_topics/standalone-trees/detail.txt:1
5994
msgid "Standalone Trees"
5997
#: dummy/help_topics/standalone-trees/detail.txt:3
5999
"A standalone tree is a working tree with an associated repository. It\n"
6000
"is an independently usable branch, with no dependencies on any other.\n"
6001
"Creating a standalone tree (via bzr init) is the quickest way to put\n"
6002
"an existing project under version control."
6005
#: dummy/help_topics/standalone-trees/detail.txt:8
6006
msgid "Related Commands::"
6009
#: dummy/help_topics/standalone-trees/detail.txt:10
6010
msgid " init Make a directory into a versioned branch.\n"
6013
#: dummy/help_topics/standalone-trees/summary.txt:1
6014
msgid "Information on what a standalone tree is"
6017
#: dummy/help_topics/standard-options/detail.txt:1
6018
msgid "Standard Options"
6021
#: dummy/help_topics/standard-options/detail.txt:3
6022
msgid "Standard options are legal for all commands."
6025
#: dummy/help_topics/standard-options/detail.txt:5
6027
"--help, -h Show help message.\n"
6028
"--verbose, -v Display more information.\n"
6029
"--quiet, -q Only display errors and warnings."
6032
#: dummy/help_topics/standard-options/detail.txt:9
6033
msgid "Unlike global options, standard options can be used in aliases.\n"
6036
#: dummy/help_topics/standard-options/summary.txt:1
6037
msgid "Options that can be used with any command"
6040
#: dummy/help_topics/status-flags/detail.txt:1
6041
msgid "Status Flags"
6044
#: dummy/help_topics/status-flags/detail.txt:3
6046
"Status flags are used to summarise changes to the working tree in a concise\n"
6047
"manner. They are in the form::"
6050
#: dummy/help_topics/status-flags/detail.txt:6
6051
msgid " xxx <filename>"
6054
#: dummy/help_topics/status-flags/detail.txt:8
6055
msgid "where the columns' meanings are as follows."
6058
#: dummy/help_topics/status-flags/detail.txt:10
6059
msgid "Column 1 - versioning/renames::"
6062
#: dummy/help_topics/status-flags/detail.txt:12
6064
" + File versioned\n"
6065
" - File unversioned\n"
6068
" X File nonexistent (and unknown to bzr)\n"
6069
" C File has conflicts\n"
6070
" P Entry for a pending merge (not a file)"
6073
#: dummy/help_topics/status-flags/detail.txt:20
6074
msgid "Column 2 - contents::"
6077
#: dummy/help_topics/status-flags/detail.txt:22
6081
" K File kind changed\n"
6085
#: dummy/help_topics/status-flags/detail.txt:27
6086
msgid "Column 3 - execute::"
6089
#: dummy/help_topics/status-flags/detail.txt:29
6090
msgid " * The execute bit was changed\n"
6093
#: dummy/help_topics/status-flags/summary.txt:1
6094
msgid "Help on status flags"
6097
#: dummy/help_topics/sync-for-reconfigure/detail.txt:1
6098
msgid "Branches Out of Sync"
6101
#: dummy/help_topics/sync-for-reconfigure/detail.txt:3
6103
"When reconfiguring a checkout, tree or branch into a lightweight checkout,\n"
6104
"a local branch must be destroyed. (For checkouts, this is the local branch\n"
6105
"that serves primarily as a cache.) If the branch-to-be-destroyed does not\n"
6106
"have the same last revision as the new reference branch for the lightweight\n"
6107
"checkout, data could be lost, so Bazaar refuses."
6110
#: dummy/help_topics/sync-for-reconfigure/detail.txt:9
6111
msgid "How you deal with this depends on *why* the branches are out of sync."
6114
#: dummy/help_topics/sync-for-reconfigure/detail.txt:11
6116
"If you have a checkout and have done local commits, you can get back in "
6118
"by running \"bzr update\" (and possibly \"bzr commit\")."
6121
#: dummy/help_topics/sync-for-reconfigure/detail.txt:14
6123
"If you have a branch and the remote branch is out-of-date, you can push\n"
6124
"the local changes using \"bzr push\". If the local branch is out of date, "
6126
"can do \"bzr pull\". If both branches have had changes, you can merge, "
6128
"and then push your changes. If you decide that some of the changes aren't\n"
6129
"useful, you can \"push --overwrite\" or \"pull --overwrite\" instead.\n"
6132
#: dummy/help_topics/sync-for-reconfigure/summary.txt:1
6133
msgid "Steps to resolve \"out-of-sync\" when reconfiguring"
6136
#: dummy/help_topics/topics/summary.txt:1
6140
#: dummy/help_topics/url-special-chars/summary.txt:1
6141
msgid "Special character handling in URLs"
6144
#: dummy/help_topics/urlspec/summary.txt:1
6145
msgid "Supported transport protocols"
6148
#: dummy/help_topics/working-trees/detail.txt:1
6149
msgid "Working Trees"
6152
#: dummy/help_topics/working-trees/detail.txt:3
6154
"A working tree is the contents of a branch placed on disk so that you can\n"
6155
"see the files and edit them. The working tree is where you make changes to "
6157
"branch, and when you commit the current state of the working tree is the\n"
6158
"snapshot that is recorded in the commit."
6161
#: dummy/help_topics/working-trees/detail.txt:8
6163
"When you push a branch to a remote system, a working tree will not be\n"
6164
"created. If one is already present the files will not be updated. The\n"
6165
"branch information will be updated and the working tree will be marked\n"
6166
"as out-of-date. Updating a working tree remotely is difficult, as there\n"
6167
"may be uncommitted changes or the update may cause content conflicts that "
6169
"difficult to deal with remotely."
6172
#: dummy/help_topics/working-trees/detail.txt:15
6174
"If you have a branch with no working tree you can use the 'checkout' "
6176
"to create a working tree. If you run 'bzr checkout .' from the branch it "
6178
"create the working tree. If the branch is updated remotely, you can update "
6180
"working tree by running 'bzr update' in that directory."
6183
#: dummy/help_topics/working-trees/detail.txt:20
6185
"If you have a branch with a working tree that you do not want the 'remove-"
6187
"command will remove the tree if it is safe. This can be done to avoid the\n"
6188
"warning about the remote working tree not being updated when pushing to the\n"
6189
"branch. It can also be useful when working with a '--no-trees' repository\n"
6190
"(see 'bzr help repositories')."
6193
#: dummy/help_topics/working-trees/detail.txt:26
6195
"If you want to have a working tree on a remote machine that you push to you\n"
6196
"can either run 'bzr update' in the remote branch after each push, or use "
6198
"other method to update the tree during the push. There is an 'rspush' "
6200
"that will update the working tree using rsync as well as doing a push. "
6202
"is also a 'push-and-update' plugin that automates running 'bzr update' via "
6207
#: dummy/help_topics/working-trees/detail.txt:33
6208
msgid "Useful commands::"
6211
#: dummy/help_topics/working-trees/detail.txt:35
6213
" checkout Create a working tree when a branch does not have one.\n"
6214
" remove-tree Removes the working tree from a branch when it is safe to do "
6216
" update When a working tree is out of sync with its associated "
6218
" this will update the tree to match the branch.\n"
6221
#: dummy/help_topics/working-trees/summary.txt:1
6222
msgid "Information on working trees"
6225
#: en/help_topics/authentication.txt:1
6227
"Authentication Settings\n"
6228
"======================="
6231
#: en/help_topics/authentication.txt:4
6238
#: en/help_topics/authentication.txt:8
6240
"Many different authentication policies can be described in the\n"
6241
"``authentication.conf`` file but a particular user should need only a few\n"
6242
"definitions to cover his needs without having to specify a user and a "
6244
"for every branch he uses."
6247
#: en/help_topics/authentication.txt:13
6249
"The definitions found in this file are used to find the credentials to use "
6251
"a given url. The same credentials can generally be used for as many branches "
6253
"possible by grouping their declaration around the remote servers that need\n"
6254
"them. It's even possible to declare credentials that will be used by "
6259
#: en/help_topics/authentication.txt:19
6261
"The intent is to make this file as small as possible to minimize maintenance."
6264
#: en/help_topics/authentication.txt:21
6266
"Once the relevant credentials are declared in this file you may use branch "
6268
"without embedding passwords (security hazard) or even users (enabling "
6270
"of your urls with others)."
6273
#: en/help_topics/authentication.txt:25
6274
msgid "Instead of using::"
6277
#: en/help_topics/authentication.txt:27
6278
msgid " bzr branch ftp://joe:secret@host.com/path/to/my/branch"
6281
#: en/help_topics/authentication.txt:29
6282
msgid "you simply use::"
6285
#: en/help_topics/authentication.txt:31
6286
msgid " bzr branch ftp://host.com/path/to/my/branch"
6289
#: en/help_topics/authentication.txt:33
6290
msgid "provided you have created the following ``authentication.conf`` file::"
6293
#: en/help_topics/authentication.txt:35
6299
" password=secret\n"
6303
#: en/help_topics/authentication.txt:42
6305
"Authentication definitions\n"
6306
"--------------------------"
6309
#: en/help_topics/authentication.txt:45
6311
"There are two kinds of authentication used by the various schemes supported "
6316
#: en/help_topics/authentication.txt:48
6317
msgid "1. user and password"
6320
#: en/help_topics/authentication.txt:50
6322
"``FTP`` needs a (``user``, ``password``) to authenticate against a ``host``\n"
6323
"``SFTP`` can use either a password or a host key to authenticate. However,\n"
6324
"ssh agents are a better, more secure solution. So we have chosen to not "
6326
"our own less secure method."
6329
#: en/help_topics/authentication.txt:55
6330
msgid "2. user, realm and password"
6333
#: en/help_topics/authentication.txt:57
6335
"``HTTP`` and ``HTTPS`` needs a (``user, realm, password``) to authenticate\n"
6336
"against a host. But, by using ``.htaccess`` files, for example, it is "
6338
"to define several (``user, realm, password``) for a given ``host``. So what "
6340
"really needed is (``user``, ``password``, ``host``, ``path``). The ``realm`` "
6342
"not taken into account in the definitions, but will displayed if bzr "
6344
"you for a password."
6347
#: en/help_topics/authentication.txt:64
6349
"``HTTP proxy`` can be handled as ``HTTP`` (or ``HTTPS``) by explicitly\n"
6350
"specifying the appropriate port."
6353
#: en/help_topics/authentication.txt:67
6355
"To take all schemes into account, the password will be deduced from a set "
6357
"authentication definitions (``scheme``, ``host``, ``port``, ``path``, "
6362
#: en/help_topics/authentication.txt:71
6364
" * ``scheme``: can be empty (meaning the rest of the definition can be "
6366
" for any scheme), ``SFTP`` and ``bzr+ssh`` should not be used here, "
6368
" should be used instead since this is the real scheme regarding\n"
6372
#: en/help_topics/authentication.txt:76
6373
msgid " * ``host``: can be empty (to act as a default for any host),"
6376
#: en/help_topics/authentication.txt:78
6378
" * ``port`` can be empty (useful when an host provides several servers for "
6380
" same scheme), only numerical values are allowed, this should be used "
6382
" when the server uses a port different than the scheme standard port,"
6385
#: en/help_topics/authentication.txt:82
6386
msgid " * ``path``: can be empty (FTP or SFTP will never user it),"
6389
#: en/help_topics/authentication.txt:84
6391
" * ``user``: can be empty (``bzr`` will defaults to python's\n"
6392
" ``getpass.get_user()``),"
6395
#: en/help_topics/authentication.txt:87
6397
" * ``password``: can be empty if you prefer to always be prompted for your\n"
6401
#: en/help_topics/authentication.txt:90
6403
"Multiple definitions can be provided and, for a given URL, bzr will select "
6405
"(``user`` [, ``password``]) based on the following rules :"
6408
#: en/help_topics/authentication.txt:93
6409
msgid " 1. the first match wins,"
6412
#: en/help_topics/authentication.txt:95
6413
msgid " 2. empty fields match everything,"
6416
#: en/help_topics/authentication.txt:97
6418
" 3. ``scheme`` matches even if decorators are used in the requested URL,"
6421
#: en/help_topics/authentication.txt:99
6423
" 4. ``host`` matches exactly or act as a domain if it starts with '.'\n"
6424
" (``project.bzr.sf.net`` will match ``.bzr.sf.net`` but ``projectbzr.sf."
6426
" will not match ``bzr.sf.net``)."
6429
#: en/help_topics/authentication.txt:103
6431
" 5. ``port`` matches if included in the requested URL (exact matches only)"
6434
#: en/help_topics/authentication.txt:105
6436
" 6. ``path`` matches if included in the requested URL (and by rule #2 "
6438
" empty paths will match any provided path)."
6441
#: en/help_topics/authentication.txt:110
6447
#: en/help_topics/authentication.txt:113
6449
"The general rules for :doc:`configuration files <configuration-help>`\n"
6450
"apply except for the variable policies."
6453
#: en/help_topics/authentication.txt:116
6454
msgid "Each section describes an authentication definition."
6457
#: en/help_topics/authentication.txt:118
6459
"The section name is an arbitrary string, only the ``DEFAULT`` value is "
6461
"and should appear as the *last* section."
6464
#: en/help_topics/authentication.txt:121
6465
msgid "Each section should define:"
6468
#: en/help_topics/authentication.txt:123
6469
msgid "* ``user``: the login to be used,"
6472
#: en/help_topics/authentication.txt:125
6473
msgid "Each section could define:"
6476
#: en/help_topics/authentication.txt:127
6477
msgid "* ``host``: the remote server,"
6480
#: en/help_topics/authentication.txt:129
6481
msgid "* ``port``: the port the server is listening,"
6484
#: en/help_topics/authentication.txt:131
6485
msgid "* ``path``: the branch location,"
6488
#: en/help_topics/authentication.txt:133
6489
msgid "* ``password``: the password."
6492
#: en/help_topics/authentication.txt:135
6499
#: en/help_topics/authentication.txt:139
6502
"Personal projects hosted outside\n"
6503
"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"
6506
#: en/help_topics/authentication.txt:143
6508
"All connections are done with the same ``user`` (the remote one for which "
6510
"default bzr one is not appropriate) and the password is always prompted "
6515
#: en/help_topics/authentication.txt:147
6517
" # Pet projects on hobby.net\n"
6519
" host=r.hobby.net\n"
6521
" password=obvious1234\n"
6528
" password=1essobV10us\n"
6531
" # Our local user is barbaz, on all remote sites we're known as "
6536
#: en/help_topics/authentication.txt:164
6539
"Source hosting provider\n"
6540
"~~~~~~~~~~~~~~~~~~~~~~~"
6543
#: en/help_topics/authentication.txt:168
6544
msgid "In the shp.net (fictitious) domain, each project has its own site::"
6547
#: en/help_topics/authentication.txt:170
6549
" [shpnet domain]\n"
6550
" # we use sftp, but ssh is the scheme used for authentication\n"
6552
" # The leading '.' ensures that 'shp.net' alone doesn't match\n"
6555
" # bzr don't support supplying a password for sftp,\n"
6556
" # consider using an ssh agent if you don't want to supply\n"
6557
" # a password interactively. (pageant, ssh-agent, etc)"
6560
#: en/help_topics/authentication.txt:180
6562
"HTTPS, SFTP servers and their proxy\n"
6563
"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"
6566
#: en/help_topics/authentication.txt:183
6568
"At company.com, the server hosting release and integration branches is "
6570
"proxy, and the two branches use different authentication policies::"
6573
#: en/help_topics/authentication.txt:186
6575
" [reference code]\n"
6577
" host=dev.company.com\n"
6583
#: en/help_topics/authentication.txt:193
6585
" # development branches on dev server\n"
6587
" scheme=ssh # bzr+ssh and sftp are available here\n"
6588
" host=dev.company.com\n"
6589
" path=/dev/integration\n"
6595
" host=proxy.company.com\n"
6597
" user=proxyuser1\n"
6598
" password=proxypass1"
6601
#: en/help_topics/authentication.txt:208
6604
"Planned enhancements\n"
6605
"--------------------"
6608
#: en/help_topics/authentication.txt:212
6610
"The following are not yet implemented but planned as parts of a work in\n"
6614
#: en/help_topics/authentication.txt:215
6615
msgid "* add a ``password_encoding`` field allowing:"
6618
#: en/help_topics/authentication.txt:217
6620
" - storing the passwords in various obfuscating encodings (base64 for one),"
6623
#: en/help_topics/authentication.txt:219
6624
msgid " - delegate password storage to plugins (.netrc for example)."
6627
#: en/help_topics/authentication.txt:221
6629
"* update the credentials when the user is prompted for user or password,"
6632
#: en/help_topics/authentication.txt:223
6633
msgid "* add a ``verify_certificates`` field for ``HTTPS``."
6636
#: en/help_topics/authentication.txt:225
6638
"The ``password_encoding`` and ``verify_certificates`` fields are recognized "
6640
"ignored in the actual implementation.\n"
6643
#: en/help_topics/bugs.txt:1
6644
msgid "Bug Tracker Settings"
6647
#: en/help_topics/bugs.txt:3
6649
"When making a commit, metadata about bugs fixed by that change can be\n"
6650
"recorded by using the ``--fixes`` option. For each bug marked as fixed, an\n"
6651
"entry is included in the 'bugs' revision property stating '<url> <status>'.\n"
6652
"(The only ``status`` value currently supported is ``fixed.``)"
6655
#: en/help_topics/bugs.txt:8
6657
"The ``--fixes`` option allows you to specify a bug tracker and a bug "
6659
"rather than a full URL. This looks like::"
6662
#: en/help_topics/bugs.txt:11
6663
msgid " bzr commit --fixes <tracker>:<id>"
6666
#: en/help_topics/bugs.txt:13
6670
#: en/help_topics/bugs.txt:15
6671
msgid " bzr commit --fixes <id>"
6674
#: en/help_topics/bugs.txt:17
6676
"where \"<tracker>\" is an identifier for the bug tracker, and \"<id>\" is "
6678
"identifier for that bug within the bugtracker, usually the bug number.\n"
6679
"If \"<tracker>\" is not specified the ``bugtracker`` set in the branch\n"
6680
"or global configuration is used."
6683
#: en/help_topics/bugs.txt:22
6685
"Bazaar knows about a few bug trackers that have many users. If\n"
6686
"you use one of these bug trackers then there is no setup required to\n"
6687
"use this feature, you just need to know the tracker identifier to use.\n"
6688
"These are the bugtrackers that are built in:"
6691
#: en/help_topics/bugs.txt:27
6693
" ============================ ============ ============\n"
6694
" URL Abbreviation Example\n"
6695
" ============================ ============ ============\n"
6696
" https://bugs.launchpad.net/ lp lp:12345\n"
6697
" http://bugs.debian.org/ deb deb:12345\n"
6698
" http://bugzilla.gnome.org/ gnome gnome:12345\n"
6699
" ============================ ============ ============"
6702
#: en/help_topics/bugs.txt:35
6704
"For the bug trackers not listed above configuration is required.\n"
6705
"Support for generating the URLs for any project using Bugzilla or Trac\n"
6706
"is built in, along with a template mechanism for other bugtrackers with\n"
6707
"simple URL schemes. If your bug tracker can't be described by one\n"
6708
"of the schemes described below then you can write a plugin to support\n"
6712
#: en/help_topics/bugs.txt:42
6714
"If you use Bugzilla or Trac, then you only need to set a configuration\n"
6715
"variable which contains the base URL of the bug tracker. These options\n"
6716
"can go into ``bazaar.conf``, ``branch.conf`` or into a branch-specific\n"
6717
"configuration section in ``locations.conf``. You can set up these values\n"
6718
"for each of the projects you work on."
6721
#: en/help_topics/bugs.txt:48
6723
"Note: As you provide a short name for each tracker, you can specify one or\n"
6724
"more bugs in one or more trackers at commit time if you wish."
6727
#: en/help_topics/bugs.txt:51
6733
#: en/help_topics/bugs.txt:54
6734
msgid "Use ``bzr commit --fixes lp:2`` to record that this commit fixes bug 2."
6737
#: en/help_topics/bugs.txt:56
6739
"bugzilla_<tracker>_url\n"
6740
"----------------------"
6743
#: en/help_topics/bugs.txt:59
6745
"If present, the location of the Bugzilla bug tracker referred to by\n"
6746
"<tracker>. This option can then be used together with ``bzr commit\n"
6747
"--fixes`` to mark bugs in that tracker as being fixed by that commit. For\n"
6751
#: en/help_topics/bugs.txt:64
6752
msgid " bugzilla_squid_url = http://bugs.squid-cache.org"
6755
#: en/help_topics/bugs.txt:66
6757
"would allow ``bzr commit --fixes squid:1234`` to mark Squid's bug 1234 as\n"
6761
#: en/help_topics/bugs.txt:69
6763
"trac_<tracker>_url\n"
6764
"------------------"
6767
#: en/help_topics/bugs.txt:72
6769
"If present, the location of the Trac instance referred to by\n"
6770
"<tracker>. This option can then be used together with ``bzr commit\n"
6771
"--fixes`` to mark bugs in that tracker as being fixed by that commit. For\n"
6775
#: en/help_topics/bugs.txt:77
6776
msgid " trac_twisted_url = http://www.twistedmatrix.com/trac"
6779
#: en/help_topics/bugs.txt:79
6781
"would allow ``bzr commit --fixes twisted:1234`` to mark Twisted's bug 1234 "
6786
#: en/help_topics/bugs.txt:82
6788
"bugtracker_<tracker>_url\n"
6789
"------------------------"
6792
#: en/help_topics/bugs.txt:85
6794
"If present, the location of a generic bug tracker instance referred to by\n"
6795
"<tracker>. The location must contain an ``{id}`` placeholder,\n"
6796
"which will be replaced by a specific bug ID. This option can then be used\n"
6797
"together with ``bzr commit --fixes`` to mark bugs in that tracker as being\n"
6798
"fixed by that commit. For example::"
6801
#: en/help_topics/bugs.txt:91
6802
msgid " bugtracker_python_url = http://bugs.python.org/issue{id}"
6805
#: en/help_topics/bugs.txt:93
6807
"would allow ``bzr commit --fixes python:1234`` to mark bug 1234 in Python's\n"
6808
"Roundup bug tracker as fixed, or::"
6811
#: en/help_topics/bugs.txt:96
6813
" bugtracker_cpan_url = http://rt.cpan.org/Public/Bug/Display.html?id={id}"
6816
#: en/help_topics/bugs.txt:98
6818
"would allow ``bzr commit --fixes cpan:1234`` to mark bug 1234 in CPAN's\n"
6819
"RT bug tracker as fixed, or::"
6822
#: en/help_topics/bugs.txt:101
6823
msgid " bugtracker_hudson_url = http://issues.hudson-ci.org/browse/{id}"
6826
#: en/help_topics/bugs.txt:103
6828
"would allow ``bzr commit --fixes hudson:HUDSON-1234`` to mark bug "
6830
"in Hudson's JIRA bug tracker as fixed.\n"
6833
#: en/help_topics/commands.txt:1
6835
"add Add specified files or directories.\n"
6836
"alias Set/unset and display aliases.\n"
6837
"annotate Show the origin of each line in a file.\n"
6838
"bash-completion Generate a shell function for bash command line "
6840
" [bash_completion]\n"
6841
"bd-do Run a command in an exported package, copying the result\n"
6842
" back. [builddeb]\n"
6843
"bind Convert the current branch into a checkout of the "
6846
"branch Create a new branch that is a copy of an existing "
6848
"branch-history Display the development history of a branch. [bzrtools]\n"
6849
"branches Scan a location for branches [bzrtools]\n"
6850
"break-lock Break a dead lock.\n"
6851
"bug-url Print full URL to a specific bug, or open it in your\n"
6852
" browser. [qbzr]\n"
6853
"builddeb Builds a Debian package from a branch. [builddeb]\n"
6854
"cat Write the contents of a file as of a given revision to\n"
6855
" standard output.\n"
6856
"cbranch Create a new checkout, associated with a new repository\n"
6857
" branch. [bzrtools]\n"
6858
"cdiff A color version of bzr's diff [bzrtools]\n"
6859
"check Validate working tree structure, branch consistency and\n"
6860
" repository history.\n"
6861
"checkout Create a new checkout of an existing branch.\n"
6862
"clean-tree Remove unwanted files from working tree.\n"
6863
"commit Commit changes into a new revision.\n"
6864
"config Display, set or remove a configuration option.\n"
6865
"conflict-diff Compare a conflicted file against BASE. [bzrtools]\n"
6866
"conflicts List files with conflicts.\n"
6867
"create-mirror Create a mirror of another branch. [bzrtools]\n"
6868
"deleted List files deleted in the working tree.\n"
6869
"dep3-patch Format the changes in a branch as a DEP-3 patch. "
6871
"dh-make Helps you create a new package. [builddeb]\n"
6872
"diff Show differences in the working tree, between revisions "
6875
"explorer Desktop application for Bazaar. [explorer]\n"
6876
"export Export current or past revision to a destination "
6879
"fetch-ghosts Attempt to retrieve ghosts from another branch. "
6881
"graph-ancestry Produce ancestry graphs using dot. [bzrtools]\n"
6882
"grep Print lines matching PATTERN for specified files and\n"
6883
" revisions. [grep]\n"
6884
"heads Show all revisions in a repository not having "
6887
"help Show help on a command or other topic.\n"
6888
"ignore Ignore specified files or patterns.\n"
6889
"ignored List ignored files and the patterns that matched them.\n"
6890
"import Import sources from a directory, tarball or zip file\n"
6892
"import-dsc Import a series of source packages. [builddeb]\n"
6893
"import-upstream Imports an upstream tarball. [builddeb]\n"
6894
"info Show information about a working tree, branch or "
6896
"init Make a directory into a versioned branch.\n"
6897
"init-repository Create a shared repository for branches to share storage\n"
6899
"init-workspace Start a new workspace. [explorer]\n"
6900
"join Combine a tree into its containing tree.\n"
6901
"launchpad-login Show or set the Launchpad user ID. [launchpad]\n"
6902
"launchpad-mirror Ask Launchpad to mirror a branch now. [launchpad]\n"
6903
"launchpad-open Open a Launchpad branch page in your web browser.\n"
6905
"link-tree Hardlink matching files to another tree. [bzrtools]\n"
6906
"log Show historical log for a branch or subset of a branch.\n"
6907
"lp-find-proposal Find the proposal to merge this revision. [launchpad]\n"
6908
"lp-propose-merge Propose merging a branch on Launchpad. [launchpad]\n"
6909
"ls List files in a tree.\n"
6910
"mark-uploaded Mark that this branch has been uploaded, prior to "
6913
"merge Perform a three-way merge.\n"
6914
"merge-package Merges source packaging branch into target packaging "
6917
"merge-upstream Merges a new upstream version into the current branch.\n"
6919
"missing Show unmerged/unpulled revisions between two branches.\n"
6920
"mkdir Create a new versioned directory.\n"
6921
"multi-pull Pull all the branches under a location, e.g. a "
6924
"mv Move or rename a file.\n"
6925
"nick Print or set the branch nickname.\n"
6926
"pack Compress the data within a repository.\n"
6927
"patch Apply a named patch to the current tree. [bzrtools]\n"
6928
"plugins List the installed plugins.\n"
6929
"pull Turn this branch into a mirror of another branch.\n"
6930
"push Update a mirror of this branch.\n"
6931
"qadd GUI for adding files or directories. [qbzr]\n"
6932
"qannotate Show the origin of each line in a file. [qbzr]\n"
6933
"qbind Convert the current branch into a checkout of the "
6936
"qbranch Create a new copy of a branch. [qbzr]\n"
6937
"qbrowse Show inventory or working tree. [qbzr]\n"
6938
"qcat View the contents of a file as of a given revision. "
6940
"qcommit GUI for committing revisions. [qbzr]\n"
6941
"qconfig Configure Bazaar and QBzr. [qbzr]\n"
6942
"qconflicts Show conflicts. [qbzr]\n"
6943
"qdiff Show differences in working tree in a GUI window. [qbzr]\n"
6944
"qexport Export current or past revision to a destination "
6946
" or archive. [qbzr]\n"
6947
"qgetnew Creates a new working tree (either a checkout or full\n"
6948
" branch). [qbzr]\n"
6949
"qgetupdates Fetches external changes into the working tree. [qbzr]\n"
6950
"qinfo Shows information about the current location. [qbzr]\n"
6951
"qinit Initializes a new branch or shared repository. [qbzr]\n"
6952
"qinit-workspace Start a new workspace using a GUI. [explorer]\n"
6953
"qlog Show log of a repository, branch, file, or directory in a "
6956
"qmerge Perform a three-way merge. [qbzr]\n"
6957
"qplugins Show information about installed plugins. [qbzr]\n"
6958
"qpull Turn this branch into a mirror of another branch. [qbzr]\n"
6959
"qpush Update a mirror of this branch. [qbzr]\n"
6960
"qrevert Revert changes files. [qbzr]\n"
6961
"qrun Run arbitrary bzr command. [qbzr]\n"
6962
"qsend Mail or create a merge-directive for submitting changes.\n"
6964
"qshelve Shelve selected changes away. [qbzr]\n"
6965
"qswitch Set the branch of a checkout and update. [qbzr]\n"
6966
"qtag Edit tags. [qbzr]\n"
6967
"qunbind Convert the current checkout into a regular branch. "
6969
"quncommit Move the tip of a branch to an earlier revision. [qbzr]\n"
6970
"qunshelve Restore shalved changes. [qbzr]\n"
6971
"qupdate Update working tree with latest changes in the branch.\n"
6973
"qverify-signatures Shows digital signature statuses for branch commits "
6975
"qversion Show version/system information. [qbzr]\n"
6976
"qviewer Simple file viewer. [qbzr]\n"
6977
"reconcile Reconcile bzr metadata in a branch.\n"
6978
"reconfigure Reconfigure the type of a bzr directory.\n"
6979
"register-branch Register a branch with launchpad.net. [launchpad]\n"
6980
"remerge Redo a merge.\n"
6981
"remove Remove files or directories.\n"
6982
"remove-branch Remove a branch.\n"
6983
"remove-tree Remove the working tree from a given branch/checkout.\n"
6984
"renames Show list of renamed files.\n"
6985
"resolve Mark a conflict as resolved.\n"
6986
"revert Revert files to a previous revision.\n"
6987
"revno Show current revision number.\n"
6988
"root Show the tree root directory.\n"
6989
"rspush Upload this branch to another location using rsync.\n"
6991
"send Mail or create a merge-directive for submitting changes.\n"
6992
"serve Run the bzr server.\n"
6993
"shelf1 Perform various operations on your shelved patches. See "
6995
" shelve1. [bzrtools]\n"
6996
"shell Begin an interactive shell tailored for bzr. [bzrtools]\n"
6997
"shelve Temporarily set aside some changes from the current "
6999
"shelve1 Temporarily set aside some changes from the current "
7002
"sign-my-commits Sign all commits by a given committer.\n"
7003
"split Split a subdirectory of a tree into a separate tree.\n"
7004
"status Display status summary.\n"
7005
"switch Set the branch of a checkout and update.\n"
7006
"tag Create, remove or modify a tag naming a revision.\n"
7008
"testament Show testament (signing-form) of a revision.\n"
7009
"trees Scan a location for trees [bzrtools]\n"
7010
"unbind Convert the current checkout into a regular branch.\n"
7011
"uncommit Remove the last committed revision.\n"
7012
"unshelve Restore shelved changes.\n"
7013
"unshelve1 Restore shelved changes. [bzrtools]\n"
7014
"update Update a tree to have the latest code committed to its\n"
7016
"upgrade Upgrade a repository, branch or working tree to a newer\n"
7018
"verify-signatures Verify all commit signatures.\n"
7019
"version Show version of bzr.\n"
7020
"version-info Show version information about this tree.\n"
7021
"view Manage filtered views.\n"
7022
"whoami Show or set bzr user id.\n"
7023
"zap Remove a lightweight checkout, if it can be done safely.\n"
7027
#: en/help_topics/configuration.txt:1
7029
"Configuration Settings\n"
7030
"======================="
7033
#: en/help_topics/configuration.txt:4
7035
"Environment settings\n"
7036
"---------------------"
7039
#: en/help_topics/configuration.txt:7
7041
"While most configuration is handled by configuration files, some options\n"
7042
"which may be semi-permanent can also be controlled through the environment."
7045
#: en/help_topics/configuration.txt:10
7051
#: en/help_topics/configuration.txt:13
7052
msgid "Override the email id used by Bazaar. Typical format::"
7055
#: en/help_topics/configuration.txt:15
7056
msgid " \"John Doe <jdoe@example.com>\""
7059
#: en/help_topics/configuration.txt:17
7060
msgid "See also the ``email`` configuration option."
7063
#: en/help_topics/configuration.txt:19
7065
"BZR_PROGRESS_BAR\n"
7069
#: en/help_topics/configuration.txt:22
7071
"Override the progress display. Possible values are \"none\" or \"text\". "
7073
"the value is \"none\" then no progress bar is displayed. The value \"text\" "
7075
"the ordinary command line progress bar."
7078
#: en/help_topics/configuration.txt:26
7084
#: en/help_topics/configuration.txt:29
7085
msgid "Control whether SIGQUIT behaves normally or invokes a breakin debugger."
7088
#: en/help_topics/configuration.txt:31
7090
"* 0 = Standard SIGQUIT behavior (normally, exit with a core dump)\n"
7091
"* 1 = Invoke breakin debugger (default)"
7094
#: en/help_topics/configuration.txt:34
7100
#: en/help_topics/configuration.txt:37
7101
msgid "Override the home directory used by Bazaar."
7104
#: en/help_topics/configuration.txt:39
7110
#: en/help_topics/configuration.txt:42
7111
msgid "Select a different SSH implementation."
7114
#: en/help_topics/configuration.txt:44
7120
#: en/help_topics/configuration.txt:47
7121
msgid "Control whether to launch a debugger on error."
7124
#: en/help_topics/configuration.txt:49
7126
"* 0 = Standard behavior\n"
7127
"* 1 = Launch debugger"
7130
#: en/help_topics/configuration.txt:52
7136
#: en/help_topics/configuration.txt:55
7137
msgid "Path to the Bazaar executable to use when using the bzr+ssh protocol."
7140
#: en/help_topics/configuration.txt:57
7141
msgid "See also the ``bzr_remote_path`` configuration option."
7144
#: en/help_topics/configuration.txt:59
7150
#: en/help_topics/configuration.txt:62
7151
msgid "Path to the editor Bazaar should use for commit messages, etc."
7154
#: en/help_topics/configuration.txt:64
7160
#: en/help_topics/configuration.txt:67
7162
"Location of the Bazaar log file. You can check the current location by\n"
7163
"running ``bzr version``."
7166
#: en/help_topics/configuration.txt:70
7168
"The log file contains debug information that is useful for diagnosing or\n"
7169
"reporting problems with Bazaar."
7172
#: en/help_topics/configuration.txt:73
7174
"Setting this to ``NUL`` on Windows or ``/dev/null`` on other platforms\n"
7175
"will disable logging."
7178
#: en/help_topics/configuration.txt:76
7185
#: en/help_topics/configuration.txt:80
7187
"The path to the plugins directory that Bazaar should use.\n"
7188
"If not set, Bazaar will search for plugins in:"
7191
#: en/help_topics/configuration.txt:83
7192
msgid "* the user specific plugin directory (containing the ``user`` plugins),"
7195
#: en/help_topics/configuration.txt:85
7196
msgid "* the bzrlib directory (containing the ``core`` plugins),"
7199
#: en/help_topics/configuration.txt:87
7201
"* the site specific plugin directory if applicable (containing\n"
7202
" the ``site`` plugins)."
7205
#: en/help_topics/configuration.txt:90
7207
"If ``BZR_PLUGIN_PATH`` is set in any fashion, it will change the\n"
7208
"the way the plugin are searched. "
7211
#: en/help_topics/configuration.txt:93
7213
"As for the ``PATH`` variables, if multiple directories are\n"
7214
"specified in ``BZR_PLUGIN_PATH`` they should be separated by the\n"
7215
"platform specific appropriate character (':' on Unix,\n"
7219
#: en/help_topics/configuration.txt:98
7221
"By default if ``BZR_PLUGIN_PATH`` is set, it replaces searching\n"
7222
"in ``user``. However it will continue to search in ``core`` and\n"
7223
"``site`` unless they are explicitly removed."
7226
#: en/help_topics/configuration.txt:102
7228
"If you need to change the order or remove one of these\n"
7229
"directories, you should use special values:"
7232
#: en/help_topics/configuration.txt:105
7234
"* ``-user``, ``-core``, ``-site`` will remove the corresponding\n"
7235
" path from the default values,"
7238
#: en/help_topics/configuration.txt:108
7240
"* ``+user``, ``+core``, ``+site`` will add the corresponding path\n"
7241
" before the remaining default values (and also remove it from\n"
7242
" the default values)."
7245
#: en/help_topics/configuration.txt:112
7247
"Note that the special values 'user', 'core' and 'site' should be\n"
7248
"used literally, they will be substituted by the corresponding,\n"
7249
"platform specific, values."
7252
#: en/help_topics/configuration.txt:116
7254
"The examples below use ':' as the separator, windows users\n"
7258
#: en/help_topics/configuration.txt:119
7259
msgid "Overriding the default user plugin directory::"
7262
#: en/help_topics/configuration.txt:121
7263
msgid " BZR_PLUGIN_PATH='/path/to/my/other/plugins'"
7266
#: en/help_topics/configuration.txt:123
7267
msgid "Disabling the site directory while retaining the user directory::"
7270
#: en/help_topics/configuration.txt:125
7271
msgid " BZR_PLUGIN_PATH='-site:+user'"
7274
#: en/help_topics/configuration.txt:127
7275
msgid "Disabling all plugins (better achieved with --no-plugins)::"
7278
#: en/help_topics/configuration.txt:129
7279
msgid " BZR_PLUGIN_PATH='-user:-core:-site'"
7282
#: en/help_topics/configuration.txt:131
7283
msgid "Overriding the default site plugin directory::"
7286
#: en/help_topics/configuration.txt:133
7287
msgid " BZR_PLUGIN_PATH='/path/to/my/site/plugins:-site':+user"
7290
#: en/help_topics/configuration.txt:135
7292
"BZR_DISABLE_PLUGINS\n"
7293
"~~~~~~~~~~~~~~~~~~~"
7296
#: en/help_topics/configuration.txt:138
7298
"Under special circumstances (mostly when trying to diagnose a\n"
7299
"bug), it's better to disable a plugin (or several) rather than\n"
7300
"uninstalling them completely. Such plugins can be specified in\n"
7301
"the ``BZR_DISABLE_PLUGINS`` environment variable."
7304
#: en/help_topics/configuration.txt:143
7306
"In that case, ``bzr`` will stop loading the specified plugins and\n"
7307
"will raise an import error if they are explicitly imported (by\n"
7308
"another plugin that depends on them for example)."
7311
#: en/help_topics/configuration.txt:147
7312
msgid "Disabling ``myplugin`` and ``yourplugin`` is achieved by::"
7315
#: en/help_topics/configuration.txt:149
7316
msgid " BZR_DISABLE_PLUGINS='myplugin:yourplugin'"
7319
#: en/help_topics/configuration.txt:151
7325
#: en/help_topics/configuration.txt:154
7327
"When adding a new feature or working on a bug in a plugin,\n"
7328
"developers often need to use a specific version of a given\n"
7329
"plugin. Since python requires that the directory containing the\n"
7330
"code is named like the plugin itself this make it impossible to\n"
7331
"use arbitrary directory names (using a two-level directory scheme\n"
7332
"is inconvenient). ``BZR_PLUGINS_AT`` allows such directories even\n"
7333
"if they don't appear in ``BZR_PLUGIN_PATH`` ."
7336
#: en/help_topics/configuration.txt:162
7338
"Plugins specified in this environment variable takes precedence\n"
7339
"over the ones in ``BZR_PLUGIN_PATH``."
7342
#: en/help_topics/configuration.txt:165
7344
"The variable specified a list of ``plugin_name@plugin path``,\n"
7345
"``plugin_name`` being the name of the plugin as it appears in\n"
7346
"python module paths, ``plugin_path`` being the path to the\n"
7347
"directory containing the plugin code itself\n"
7348
"(i.e. ``plugins/myplugin`` not ``plugins``). Use ':' as the list\n"
7349
"separator, use ';' on windows."
7352
#: en/help_topics/configuration.txt:172
7358
#: en/help_topics/configuration.txt:175
7360
"Using a specific version of ``myplugin``:\n"
7361
"``BZR_PLUGINS_AT='myplugin@/home/me/bugfixes/123456-myplugin``"
7364
#: en/help_topics/configuration.txt:178
7370
#: en/help_topics/configuration.txt:181
7371
msgid "The path where Bazaar should look for shell plugin external commands."
7374
#: en/help_topics/configuration.txt:183
7377
"http_proxy, https_proxy\n"
7378
"~~~~~~~~~~~~~~~~~~~~~~~"
7381
#: en/help_topics/configuration.txt:187
7382
msgid "Specifies the network proxy for outgoing connections, for example::"
7385
#: en/help_topics/configuration.txt:189
7387
" http_proxy=http://proxy.example.com:3128/ \n"
7388
" https_proxy=http://proxy.example.com:3128/"
7391
#: en/help_topics/configuration.txt:192
7394
"Configuration files\n"
7395
"-------------------"
7398
#: en/help_topics/configuration.txt:196
7404
#: en/help_topics/configuration.txt:199
7406
"Configuration files are located in ``$HOME/.bazaar`` on Unix and\n"
7407
"``C:\\Documents and Settings\\<username>\\Application Data\\Bazaar\\2.0`` "
7409
"Windows. (You can check the location for your system by using\n"
7413
#: en/help_topics/configuration.txt:204
7414
msgid "There are three primary configuration files in this location:"
7417
#: en/help_topics/configuration.txt:206
7418
msgid "* ``bazaar.conf`` describes default configuration options,"
7421
#: en/help_topics/configuration.txt:208
7423
"* ``locations.conf`` describes configuration information for\n"
7424
" specific branch locations,"
7427
#: en/help_topics/configuration.txt:211
7429
"* ``authentication.conf`` describes credential information for\n"
7433
#: en/help_topics/configuration.txt:214
7435
"Each branch can also contain a configuration file that sets values specific\n"
7436
"to that branch. This file is found at ``.bzr/branch/branch.conf`` within "
7438
"branch. This file is visible to all users of a branch, if you wish to "
7440
"one of the values for a branch with a setting that is specific to you then "
7442
"can do so in ``locations.conf``."
7445
#: en/help_topics/configuration.txt:220
7451
#: en/help_topics/configuration.txt:223
7453
"An ini file has three types of contructs: section headers, section\n"
7454
"variables and comments."
7457
#: en/help_topics/configuration.txt:226
7463
#: en/help_topics/configuration.txt:229
7465
"A comment is any line that starts with a \"#\" (sometimes called a \"hash\n"
7466
"mark\", \"pound sign\" or \"number sign\"). Comment lines are ignored by\n"
7467
"Bazaar when parsing ini files."
7470
#: en/help_topics/configuration.txt:233
7476
#: en/help_topics/configuration.txt:236
7478
"A section header is a word enclosed in brackets that starts at the begining\n"
7479
"of a line. A typical section header looks like this::"
7482
#: en/help_topics/configuration.txt:239
7486
#: en/help_topics/configuration.txt:241
7488
"The only valid section headers for bazaar.conf currently are [DEFAULT] and\n"
7489
"[ALIASES]. Section headers are case sensitive. The default section provides "
7491
"setting variables which can be overridden with the branch config file."
7494
#: en/help_topics/configuration.txt:245
7496
"For ``locations.conf``, the variables from the section with the\n"
7497
"longest matching section header are used to the exclusion of other\n"
7498
"potentially valid section headers. A section header uses the path for\n"
7499
"the branch as the section header. Some examples include::"
7502
#: en/help_topics/configuration.txt:250
7504
" [http://mybranches.isp.com/~jdoe/branchdir]\n"
7505
" [/home/jdoe/branches/]"
7508
#: en/help_topics/configuration.txt:253
7511
"Section variables\n"
7515
#: en/help_topics/configuration.txt:257
7517
"A section variable resides within a section. A section variable contains a\n"
7518
"variable name, an equals sign and a value. For example::"
7521
#: en/help_topics/configuration.txt:260
7523
" email = John Doe <jdoe@isp.com>\n"
7524
" gpg_signing_key = Amy Pond <amy@example.com>"
7527
#: en/help_topics/configuration.txt:263
7529
"A variable can reference other variables **in the same configuration file** "
7531
"enclosing them in curly brackets::"
7534
#: en/help_topics/configuration.txt:266
7536
" my_branch_name = feature_x\n"
7537
" my_server = bzr+ssh://example.com\n"
7538
" push_location = {my_server}/project/{my_branch_name}"
7541
#: en/help_topics/configuration.txt:270
7544
"Variable policies\n"
7548
#: en/help_topics/configuration.txt:274
7550
"Variables defined in a section affect the named directory or URL plus\n"
7551
"any locations they contain. Policies can be used to change how a\n"
7552
"variable value is interpreted for contained locations. Currently\n"
7553
"there are three policies available:"
7556
#: en/help_topics/configuration.txt:279
7559
" the value is interpreted the same for contained locations. This is\n"
7560
" the default behaviour.\n"
7562
" the value is only used for the exact location specified by the\n"
7565
" for contained locations, any additional path components are\n"
7566
" appended to the value."
7569
#: en/help_topics/configuration.txt:289
7571
"Policies are specified by keys with names of the form \"$var:policy\".\n"
7572
"For example, to define the push location for a tree of branches, the\n"
7573
"following could be used::"
7576
#: en/help_topics/configuration.txt:293
7578
" [/top/location]\n"
7579
" push_location = sftp://example.com/location\n"
7580
" push_location:policy = appendpath"
7583
#: en/help_topics/configuration.txt:297
7585
"With this configuration, the push location for ``/top/location/branch1``\n"
7586
"would be ``sftp://example.com/location/branch1``."
7589
#: en/help_topics/configuration.txt:300
7592
"The main configuration file, bazaar.conf\n"
7593
"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"
7596
#: en/help_topics/configuration.txt:304
7598
"``bazaar.conf`` allows two sections: ``[DEFAULT]`` and ``[ALIASES]``.\n"
7599
"The default section contains the default\n"
7600
"configuration options for all branches. The default section can be\n"
7601
"overriden by providing a branch-specific section in ``locations.conf``."
7604
#: en/help_topics/configuration.txt:309
7605
msgid "A typical ``bazaar.conf`` section often looks like the following::"
7608
#: en/help_topics/configuration.txt:311
7611
" email = John Doe <jdoe@isp.com>\n"
7612
" editor = /usr/bin/vim\n"
7613
" create_signatures = when-required"
7616
#: en/help_topics/configuration.txt:316
7619
"The branch location configuration file, locations.conf\n"
7620
"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"
7623
#: en/help_topics/configuration.txt:320
7625
"``locations.conf`` allows one to specify overriding settings for\n"
7626
"a specific branch. The format is almost identical to the default section in\n"
7627
"bazaar.conf with one significant change: The section header, instead of "
7629
"default, will be the path to a branch that you wish to override a value\n"
7630
"for. The '?' and '*' wildcards are supported::"
7633
#: en/help_topics/configuration.txt:326
7635
" [/home/jdoe/branches/nethack]\n"
7636
" email = Nethack Admin <nethack@nethack.com>"
7639
#: en/help_topics/configuration.txt:329
7641
" [http://hypothetical.site.com/branches/devel-branch]\n"
7642
" create_signatures = always"
7645
#: en/help_topics/configuration.txt:332
7647
"The authentication configuration file, authentication.conf\n"
7648
"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"
7651
#: en/help_topics/configuration.txt:335
7653
"``authentication.conf`` allows one to specify credentials for\n"
7654
"remote servers. This can be used for all the supported transports and any "
7656
"of bzr that requires authentication (smtp for example)."
7659
#: en/help_topics/configuration.txt:339
7661
"The syntax of the file obeys the same rules as the others except for the\n"
7662
"variable policies which don't apply."
7665
#: en/help_topics/configuration.txt:342
7667
"For more information on the possible uses of the authentication "
7669
"file see :doc:`authentication-help`."
7672
#: en/help_topics/configuration.txt:345
7675
"Common variable options\n"
7676
"-----------------------"
7679
#: en/help_topics/configuration.txt:349
7685
#: en/help_topics/configuration.txt:352
7687
"A comma-separated list of debugging options to turn on. The same values\n"
7688
"can be used as with the -D command-line option (see `help global-options`).\n"
7692
#: en/help_topics/configuration.txt:356
7693
msgid " debug_flags = hpss"
7696
#: en/help_topics/configuration.txt:360
7697
msgid " debug_flags = hpss,evil"
7700
#: en/help_topics/configuration.txt:362
7706
#: en/help_topics/configuration.txt:365
7708
"The email address to use when committing a branch. Typically takes the form\n"
7712
#: en/help_topics/configuration.txt:368
7713
msgid " email = Full Name <account@hostname.tld>"
7716
#: en/help_topics/configuration.txt:370
7722
#: en/help_topics/configuration.txt:373
7724
"The path of the editor that you wish to use if *bzr commit* is run without\n"
7725
"a commit message. This setting is trumped by the environment variable\n"
7726
"``BZR_EDITOR``, and overrides the ``VISUAL`` and ``EDITOR`` environment\n"
7730
#: en/help_topics/configuration.txt:378
7736
#: en/help_topics/configuration.txt:381
7738
"The default log format to use. Standard log formats are ``long``, ``short``\n"
7739
"and ``line``. Additional formats may be provided by plugins. The default\n"
7740
"value is ``long``."
7743
#: en/help_topics/configuration.txt:385
7745
"check_signatures\n"
7749
#: en/help_topics/configuration.txt:388
7751
"Reserved for future use. These options will allow a policy for branches to\n"
7752
"require signatures."
7755
#: en/help_topics/configuration.txt:391
7758
" The gnupg signature for revisions must be present and must be valid."
7761
#: en/help_topics/configuration.txt:394
7764
" Do not check gnupg signatures of revisions."
7767
#: en/help_topics/configuration.txt:397
7770
" (default) If gnupg signatures for revisions are present, check them.\n"
7771
" Bazaar will fail if it finds a bad signature, but will not fail if\n"
7772
" no signature is present."
7775
#: en/help_topics/configuration.txt:402
7777
"create_signatures\n"
7781
#: en/help_topics/configuration.txt:405
7783
"Defines the behaviour of signing revisions on commits. By default bzr will "
7788
#: en/help_topics/configuration.txt:408
7791
" Sign every new revision that is committed. If the signing fails then "
7793
" commit will not be made."
7796
#: en/help_topics/configuration.txt:412
7799
" Reserved for future use."
7802
#: en/help_topics/configuration.txt:415
7805
" Reserved for future use."
7808
#: en/help_topics/configuration.txt:418
7810
"In future it is planned that ``when-required`` will sign newly\n"
7811
"committed revisions only when the branch requires them. ``never`` will "
7813
"to sign newly committed revisions, even if the branch requires signatures."
7816
#: en/help_topics/configuration.txt:422
7818
"dirstate.fdatasync\n"
7819
"~~~~~~~~~~~~~~~~~~"
7822
#: en/help_topics/configuration.txt:425
7824
"If true (default), working tree metadata changes are flushed through the\n"
7825
"OS buffers to physical disk. This is somewhat slower, but means data\n"
7826
"should not be lost if the machine crashes. See also repository.fdatasync."
7829
#: en/help_topics/configuration.txt:429
7835
#: en/help_topics/configuration.txt:432
7837
"The GnuPG user identity to use when signing commits. Can be an e-mail\n"
7838
"address, key fingerprint or full key ID. When unset or when set to\n"
7839
"\"default\" Bazaar will use the user e-mail set with ``whoami``."
7842
#: en/help_topics/configuration.txt:436
7848
#: en/help_topics/configuration.txt:439
7850
"Only useful in ``locations.conf``. Defines whether or not the\n"
7851
"configuration for this section applies to subdirectories:"
7854
#: en/help_topics/configuration.txt:442
7857
" (default) This section applies to subdirectories as well."
7860
#: en/help_topics/configuration.txt:445
7863
" This section only applies to the branch at this directory and not\n"
7864
" branches below it."
7867
#: en/help_topics/configuration.txt:449
7869
"gpg_signing_command\n"
7870
"~~~~~~~~~~~~~~~~~~~"
7873
#: en/help_topics/configuration.txt:452
7875
"(Default: \"gpg\"). Which program should be used to sign and check "
7880
#: en/help_topics/configuration.txt:455
7881
msgid " gpg_signing_command = /usr/bin/gnpg"
7884
#: en/help_topics/configuration.txt:457
7886
"The specified command must accept the options \"--clearsign\" and \"-u "
7890
#: en/help_topics/configuration.txt:459
7896
#: en/help_topics/configuration.txt:462
7898
"(Default: \"bzr\"). The path to the command that should be used to run the "
7900
"server for bzr. This value may only be specified in locations.conf, because:"
7903
#: en/help_topics/configuration.txt:465
7905
"- it's needed before branch.conf is accessible\n"
7906
"- allowing remote branch.conf files to specify commands would be a security\n"
7910
#: en/help_topics/configuration.txt:469
7911
msgid "It is overridden by the BZR_REMOTE_PATH environment variable."
7914
#: en/help_topics/configuration.txt:471
7920
#: en/help_topics/configuration.txt:474
7922
"(Default: \"localhost\"). SMTP server to use when Bazaar needs to send\n"
7923
"email, eg. with ``merge-directive --mail-to``, or the bzr-email plugin."
7926
#: en/help_topics/configuration.txt:477
7928
"smtp_username, smtp_password\n"
7929
"~~~~~~~~~~~~~~~~~~~~~~~~~~~~"
7932
#: en/help_topics/configuration.txt:480
7934
"User and password to authenticate to the SMTP server. If smtp_username\n"
7935
"is set, and smtp_password is not, Bazaar will prompt for a password.\n"
7936
"These settings are only needed if the SMTP server requires authentication\n"
7940
#: en/help_topics/configuration.txt:485
7942
"locks.steal_dead\n"
7946
#: en/help_topics/configuration.txt:488
7948
"If set to true, bzr will automatically break locks held by processes from\n"
7949
"the same machine and user that are no longer alive. Otherwise, it will\n"
7950
"print a message and you can break the lock manually, if you are satisfied\n"
7951
"the object is no longer in use."
7954
#: en/help_topics/configuration.txt:493
7960
#: en/help_topics/configuration.txt:496
7962
"A mail client to use for sending merge requests.\n"
7963
"By default, bzr will try to use ``mapi`` on Windows. On other platforms, "
7965
"will try ``xdg-email``. If either of these fails, it will fall back to\n"
7969
#: en/help_topics/configuration.txt:501
7970
msgid "Supported values for specific clients:"
7973
#: en/help_topics/configuration.txt:503
7975
":claws: Use Claws. This skips a dialog for attaching files.\n"
7976
":evolution: Use Evolution.\n"
7977
":kmail: Use KMail.\n"
7978
":mutt: Use Mutt.\n"
7979
":thunderbird: Use Mozilla Thunderbird or Icedove. For Thunderbird/Icedove "
7981
" this works around some bugs that xdg-email doesn't handle."
7984
#: en/help_topics/configuration.txt:510
7985
msgid "Supported generic values are:"
7988
#: en/help_topics/configuration.txt:512
7990
":default: See above.\n"
7991
":editor: Use your editor to compose the merge request. This also uses\n"
7992
" your commit id, (see ``bzr whoami``), smtp_server and (optionally)\n"
7993
" smtp_username and smtp_password.\n"
7994
":mapi: Use your preferred e-mail client on Windows.\n"
7995
":xdg-email: Use xdg-email to run your preferred mail program"
7998
#: en/help_topics/configuration.txt:519
8000
"repository.fdatasync\n"
8001
"~~~~~~~~~~~~~~~~~~~~"
8004
#: en/help_topics/configuration.txt:522
8006
"If true (default), repository changes are flushed through the OS buffers\n"
8007
"to physical disk. This is somewhat slower, but means data should not be\n"
8008
"lost if the machine crashes. See also dirstate.fdatasync."
8011
#: en/help_topics/configuration.txt:526
8017
#: en/help_topics/configuration.txt:529
8019
"The branch you intend to submit your current work to. This is "
8021
"set by ``bzr send``, and is also used by the ``submit:`` revision spec. "
8023
"should usually be set on a per-branch or per-location basis."
8026
#: en/help_topics/configuration.txt:533
8032
#: en/help_topics/configuration.txt:536
8034
"A publically-accessible version of this branch (implying that this version "
8036
"not publically-accessible). Used (and set) by ``bzr send``."
8039
#: en/help_topics/configuration.txt:539
8041
"suppress_warnings\n"
8045
#: en/help_topics/configuration.txt:542
8047
"A list of strings, each string represent a warning that can be emitted by\n"
8048
"bzr. Mentioning a warning in this list tells bzr to not emit it."
8051
#: en/help_topics/configuration.txt:545
8052
msgid "Valid values:"
8055
#: en/help_topics/configuration.txt:547
8057
"* ``format_deprecation``:\n"
8058
" whether the format deprecation warning is shown on repositories that "
8060
" using deprecated formats."
8063
#: en/help_topics/configuration.txt:551
8069
#: en/help_topics/configuration.txt:554
8071
"A format name for the default format used when creating branches. See "
8073
"help formats`` for possible values."
8076
#: en/help_topics/configuration.txt:557
8083
#: en/help_topics/configuration.txt:561
8089
#: en/help_topics/configuration.txt:564
8091
"A Python unicode encoding name for text output from bzr, such as log\n"
8092
"information. Values include: utf8, cp850, ascii, iso-8859-1. The default\n"
8093
"is the terminal encoding prefered by the operating system."
8096
#: en/help_topics/configuration.txt:568
8099
"Branch type specific options\n"
8100
"----------------------------"
8103
#: en/help_topics/configuration.txt:572
8105
"These options apply only to branches that use the ``dirstate-tags`` or\n"
8106
"later format. They\n"
8107
"are usually set in ``.bzr/branch/branch.conf`` automatically, but may be\n"
8108
"manually set in ``locations.conf`` or ``bazaar.conf``."
8111
#: en/help_topics/configuration.txt:577
8113
"append_revisions_only\n"
8114
"~~~~~~~~~~~~~~~~~~~~~"
8117
#: en/help_topics/configuration.txt:580
8119
"If set to \"True\" then revisions can only be appended to the log, not\n"
8120
"removed. A branch with this setting enabled can only pull from another\n"
8121
"branch if the other branch's log is a longer version of its own. This is\n"
8122
"normally set by ``bzr init --append-revisions-only``. If you set it\n"
8123
"manually, use either 'True' or 'False' (case-sensitive) to maintain\n"
8124
"compatibility with previous bzr versions (older than 2.2)."
8127
#: en/help_topics/configuration.txt:587
8133
#: en/help_topics/configuration.txt:590
8135
"If present, the location of the default branch for pull or merge. This "
8137
"is normally set when creating a branch, the first ``pull`` or by ``pull\n"
8141
#: en/help_topics/configuration.txt:594
8147
#: en/help_topics/configuration.txt:597
8149
"If present, the location of the default branch for push. This option\n"
8150
"is normally set by the first ``push`` or ``push --remember``."
8153
#: en/help_topics/configuration.txt:600
8159
#: en/help_topics/configuration.txt:603
8161
"If present, defines the ``--strict`` option default value for checking\n"
8162
"uncommitted changes before pushing."
8165
#: en/help_topics/configuration.txt:606
8171
#: en/help_topics/configuration.txt:609
8173
"If present, defines the ``--strict`` option default value for checking\n"
8174
"uncommitted changes before pushing into a different VCS without any\n"
8175
"custom bzr metadata."
8178
#: en/help_topics/configuration.txt:613
8184
#: en/help_topics/configuration.txt:616
8186
"The location that commits should go to when acting as a checkout.\n"
8187
"This option is normally set by ``bind``."
8190
#: en/help_topics/configuration.txt:619
8196
#: en/help_topics/configuration.txt:622
8198
"If set to \"True\", the branch should act as a checkout, and push each "
8200
"the bound_location. This option is normally set by ``bind``/``unbind``."
8203
#: en/help_topics/configuration.txt:625
8209
#: en/help_topics/configuration.txt:628
8211
"If present, defines the ``--strict`` option default value for checking\n"
8212
"uncommitted changes before sending a merge directive."
8215
#: en/help_topics/configuration.txt:631
8217
"add.maximum_file_size\n"
8218
"~~~~~~~~~~~~~~~~~~~~~"
8221
#: en/help_topics/configuration.txt:634
8223
"Defines the maximum file size the command line \"add\" operation will allow\n"
8224
"in recursive mode, with files larger than this value being skipped. You "
8226
"specify this value as an integer (in which case it is interpreted as "
8228
"or you may specify the value using SI units, i.e. 10KB, 20MB, 1G. A value of "
8230
"will disable skipping."
8233
#: en/help_topics/configuration.txt:640
8235
"External Merge Tools\n"
8236
"--------------------"
8239
#: en/help_topics/configuration.txt:643
8241
"bzr.mergetool.<name>\n"
8242
"~~~~~~~~~~~~~~~~~~~~"
8245
#: en/help_topics/configuration.txt:646
8247
"Defines an external merge tool called <name> with the given command-line.\n"
8248
"Arguments containing spaces should be quoted using single or double quotes. "
8250
"executable may omit its path if it can be found on the PATH."
8253
#: en/help_topics/configuration.txt:650
8255
"The following markers can be used in the command-line to substitute "
8257
"involved in the merge conflict::"
8260
#: en/help_topics/configuration.txt:653
8262
" {base} file.BASE\n"
8263
" {this} file.THIS\n"
8264
" {other} file.OTHER\n"
8265
" {result} output file\n"
8266
" {this_temp} temp copy of file.THIS, used to overwrite output file if "
8271
#: en/help_topics/configuration.txt:662
8272
msgid " bzr.mergetool.kdiff3 = kdiff3 {base} {this} {other} -o {result}"
8275
#: en/help_topics/configuration.txt:664
8277
"bzr.default_mergetool\n"
8278
"~~~~~~~~~~~~~~~~~~~~~"
8281
#: en/help_topics/configuration.txt:667
8283
"Specifies which external merge tool (as defined above) should be selected "
8285
"default in tools such as ``bzr qconflicts``."
8288
#: en/help_topics/configuration.txt:672
8289
msgid " bzr.default_mergetool = kdiff3\n"
8292
#: en/help_topics/conflict-types.txt:1
8298
#: en/help_topics/conflict-types.txt:4
8300
"Some operations, like merge, revert and pull, modify the contents of your\n"
8301
"working tree. These modifications are programmatically generated, and so "
8303
"may conflict with the current state of your working tree. "
8306
#: en/help_topics/conflict-types.txt:8
8308
"When conflicts are present in your working tree (as shown by ``bzr\n"
8309
"conflicts``), you should resolve them and then inform bzr that the "
8311
"have been resolved."
8314
#: en/help_topics/conflict-types.txt:12
8316
"Resolving conflicts is sometimes not obvious. Either because the user that\n"
8317
"should resolve them is not the one responsible for their occurrence, as is "
8319
"case when merging other people's work or because some conflicts are "
8321
"in a way that is not easy to understand."
8324
#: en/help_topics/conflict-types.txt:17
8326
"Bazaar tries to avoid conflicts ; its aim is to ask you to resolve the\n"
8327
"conflict if and only if there's an actual conceptual conflict in the source\n"
8328
"tree. Because Bazaar doesn't understand the real meaning of the files "
8330
"versioned, it can, when faced with ambiguities, fall short in either "
8332
"trying to resolve the conflict itself. Many kinds of changes can be "
8334
"programmatically, but sometimes only a human can determine the right thing "
8339
#: en/help_topics/conflict-types.txt:25
8341
"When Bazaar generates a conflict, it adds information into the working tree "
8343
"present the conflicting versions, and it's up to you to find the correct\n"
8347
#: en/help_topics/conflict-types.txt:29
8348
msgid "Whatever the conflict is, resolving it is roughly done in two steps:"
8351
#: en/help_topics/conflict-types.txt:31
8353
"1. Modify the working tree content so that the conflicted item is now in "
8355
" state you want to keep, then"
8358
#: en/help_topics/conflict-types.txt:34
8360
"2. Inform Bazaar that the conflict is now solved and ask to cleanup any\n"
8361
" remaining generated information (``bzr resolve <item>``)."
8364
#: en/help_topics/conflict-types.txt:37
8366
"For most conflict types, there are some obvious ways to modify the working\n"
8367
"tree and put it into the desired state. For some types of conflicts, Bazaar\n"
8368
"itself already made a choice, when possible."
8371
#: en/help_topics/conflict-types.txt:41
8373
"Yet, whether Bazaar makes a choice or not, there are some other simple but\n"
8374
"different ways to resolve the conflict."
8377
#: en/help_topics/conflict-types.txt:44
8379
"Each type of conflict is explained below, and the action which must be done "
8381
"resolve the conflict is outlined."
8384
#: en/help_topics/conflict-types.txt:47
8386
"Various actions are available depending on the kind of conflict, for some "
8388
"these actions, Bazaar can provide some help. In the end you should at least\n"
8389
"inform Bazaar that you're done with the conflict with::"
8392
#: en/help_topics/conflict-types.txt:51
8393
msgid " ``bzr resolve FILE --action=done'"
8396
#: en/help_topics/conflict-types.txt:53
8398
"Note that this is the default action when a single file is involved so you "
8403
#: en/help_topics/conflict-types.txt:56
8404
msgid " ``bzr resolve FILE``"
8407
#: en/help_topics/conflict-types.txt:58
8408
msgid "See ``bzr help resolve`` for more details."
8411
#: en/help_topics/conflict-types.txt:60
8417
#: en/help_topics/conflict-types.txt:63
8418
msgid "Typical message::"
8421
#: en/help_topics/conflict-types.txt:65
8422
msgid " Text conflict in FILE"
8425
#: en/help_topics/conflict-types.txt:67
8427
"These are produced when a text merge cannot completely reconcile two sets "
8429
"text changes. Bazaar will emit files for each version with the extensions\n"
8430
"THIS, OTHER, and BASE. THIS is the version of the file from the target "
8432
"i.e. the tree that you are merging changes into. OTHER is the version that "
8434
"are merging into the target. BASE is an older version that is used as a "
8439
#: en/help_topics/conflict-types.txt:74
8441
"In the main copy of the file, Bazaar will include all the changes that it\n"
8442
"could reconcile, and any un-reconciled conflicts are surrounded by\n"
8443
"\"herringbone\" markers like ``<<<<<<<``."
8446
#: en/help_topics/conflict-types.txt:78
8448
"Say the initial text is \"The project leader released it.\", and THIS "
8450
"to \"Martin Pool released it.\", while OTHER modifies it to \"The project "
8452
"released Bazaar.\" A conflict would look like this::"
8455
#: en/help_topics/conflict-types.txt:82
8458
" Martin Pool released it.\n"
8460
" The project leader released Bazaar.\n"
8461
" >>>>>>> MERGE-SOURCE"
8464
#: en/help_topics/conflict-types.txt:88
8465
msgid "The correct resolution would be \"Martin Pool released Bazaar.\""
8468
#: en/help_topics/conflict-types.txt:90
8470
"You can handle text conflicts either by editing the main copy of the file,\n"
8471
"or by invoking external tools on the THIS, OTHER and BASE versions. It's\n"
8472
"worth mentioning that resolving text conflicts rarely involves picking one\n"
8473
"set of changes over the other (but see below when you encounter these\n"
8474
"cases). More often, the two sets of changes must be intelligently combined."
8477
#: en/help_topics/conflict-types.txt:96
8479
"If you edit the main copy, be sure to remove the herringbone markers. When\n"
8480
"you are done editing, the file should look like it never had a conflict, and "
8485
#: en/help_topics/conflict-types.txt:100
8487
"When you have resolved text conflicts, just run ``bzr resolve --auto``, and\n"
8488
"Bazaar will auto-detect which conflicts you have resolved."
8491
#: en/help_topics/conflict-types.txt:103
8493
"When the conflict is resolved, Bazaar deletes the previously generated\n"
8494
"``.BASE``, ``.THIS`` and ``.OTHER`` files if they are still present in the\n"
8498
#: en/help_topics/conflict-types.txt:107
8501
"When you want to pick one set of changes over the other, you can use ``bzr\n"
8502
"resolve`` with one of the following actions:"
8505
#: en/help_topics/conflict-types.txt:111
8507
"* ``--action=take-this`` will issue ``mv FILE.THIS FILE``,\n"
8508
"* ``--action=take-other`` will issue ``mv FILE.OTHER FILE``."
8511
#: en/help_topics/conflict-types.txt:114
8513
"Note that if you have modified ``FILE.THIS`` or ``FILE.OTHER``, these\n"
8514
"modifications will be taken into account."
8517
#: en/help_topics/conflict-types.txt:117
8519
"Content conflicts\n"
8523
#: en/help_topics/conflict-types.txt:122
8524
msgid " Contents conflict in FILE"
8527
#: en/help_topics/conflict-types.txt:124
8529
"This conflict happens when there are conflicting changes in the working "
8531
"and the merge source, but the conflicted items are not text files. They "
8533
"be binary files, or symlinks, or directories. It can even happen with "
8535
"that are deleted on one side, and modified on the other."
8538
#: en/help_topics/conflict-types.txt:129
8540
"Like text conflicts, Bazaar will emit THIS, OTHER and BASE files. (They may "
8542
"regular files, symlinks or directories). But it will not include a \"main "
8544
"of the file with herringbone conflict markers. It will appear that the "
8546
"copy\" has been renamed to THIS or OTHER."
8549
#: en/help_topics/conflict-types.txt:134
8551
"To resolve that kind of conflict, you should rebuild FILE from either "
8553
"or a combination of both."
8556
#: en/help_topics/conflict-types.txt:137
8557
msgid "``bzr resolve`` recognizes the following actions:"
8560
#: en/help_topics/conflict-types.txt:139
8562
"* ``--action=take-this`` will issue ``bzr mv FILE.THIS FILE``,\n"
8563
"* ``--action=take-other`` will issue ``bzr mv FILE.OTHER FILE``,\n"
8564
"* ``--action=done`` will just mark the conflict as resolved."
8567
#: en/help_topics/conflict-types.txt:143
8569
"Any action will also delete the previously generated ``.BASE``, ``.THIS`` "
8571
"``.OTHER`` files if they are still present in the working tree."
8574
#: en/help_topics/conflict-types.txt:146
8576
"Bazaar cannot auto-detect when conflicts of this kind have been resolved."
8579
#: en/help_topics/conflict-types.txt:148
8585
#: en/help_topics/conflict-types.txt:153
8587
" Conflicting tags:\n"
8591
#: en/help_topics/conflict-types.txt:156
8593
"When pulling from or pushing to another branch, Bazaar informs you about "
8595
"that conflict between the two branches; that is the same tag points to two\n"
8596
"different revisions. You need not resolve these conflicts, but subsequent\n"
8597
"uses of pull or push will result in the same message."
8600
#: en/help_topics/conflict-types.txt:161
8602
"To resolve the conflict, you must apply the correct tags to either the "
8604
"branch or the source branch as appropriate. Use \"bzr tags --show-ids -d\n"
8605
"SOURCE_URL\" to see the tags in the source branch. If you want to make the\n"
8606
"target branch's tags match the source branch, then in the target branch do\n"
8607
"``bzr tag --force -r revid:REVISION_ID CONFLICTING_TAG`` for each of the\n"
8608
"CONFLICTING_TAGs, where REVISION_ID comes from the list of tags in the "
8610
"branch. You need not call \"bzr resolve\" after doing this. To resolve in\n"
8611
"favor of the target branch, you need to similarly use ``tag --force`` in "
8613
"source branch. (Note that pulling or pushing using --overwrite will "
8615
"all tags as well.)"
8618
#: en/help_topics/conflict-types.txt:172
8624
#: en/help_topics/conflict-types.txt:177
8625
msgid " Conflict adding file FILE. Moved existing file to FILE.moved."
8628
#: en/help_topics/conflict-types.txt:179
8630
"Sometimes Bazaar will attempt to create a file using a pathname that has\n"
8631
"already been used. The existing file will be renamed to \"FILE.moved\". "
8634
#: en/help_topics/conflict-types.txt:187
8636
"* ``--action=take-this`` will issue ``bzr rm FILE ; bzr mv FILE.moved "
8638
"* ``--action=take-other`` will issue ``bzr rm FILE.moved``,\n"
8639
"* ``--action=done`` will just mark the conflict as resolved."
8642
#: en/help_topics/conflict-types.txt:191
8644
"Note that you must get rid of FILE.moved before using ``--action=done``."
8647
#: en/help_topics/conflict-types.txt:195
8649
"Unversioned parent\n"
8650
"------------------"
8653
#: en/help_topics/conflict-types.txt:200
8654
msgid " Conflict because FILE is not versioned, but has versioned children."
8657
#: en/help_topics/conflict-types.txt:202
8659
"Sometimes Bazaar will attempt to create a file whose parent directory is "
8661
"versioned. This happens when the directory has been deleted in the target,\n"
8662
"but has a new child in the source, or vice versa. In this situation, "
8664
"will version the parent directory as well. Resolving this issue depends\n"
8665
"very much on the particular scenario. You may wish to rename or delete "
8667
"the file or the directory. When you are satisfied, you can run \"bzr "
8669
"FILE\" to mark the conflict as resolved."
8672
#: en/help_topics/conflict-types.txt:210
8678
#: en/help_topics/conflict-types.txt:215
8679
msgid " Conflict adding files to FILE. Created directory."
8682
#: en/help_topics/conflict-types.txt:217
8684
"This happens when a directory has been deleted in the target, but has new\n"
8685
"children in the source. This is similar to the \"unversioned parent\" "
8687
"except that the parent directory does not *exist*, instead of just being\n"
8688
"unversioned. In this situation, Bazaar will create the missing parent.\n"
8689
"Resolving this issue depends very much on the particular scenario."
8692
#: en/help_topics/conflict-types.txt:223
8694
"To resolve that kind of conflict, you should either remove or rename the\n"
8695
"children or the directory or a combination of both."
8698
#: en/help_topics/conflict-types.txt:228
8700
"* ``--action=take-this`` will issue ``bzr rm directory`` including the\n"
8702
"* ``--action=take-other`` will acknowledge Bazaar choice to keep the "
8704
" and restoring the directory,\n"
8705
"* ``--action=done`` will just mark the conflict as resolved."
8708
#: en/help_topics/conflict-types.txt:236
8714
#: en/help_topics/conflict-types.txt:241
8715
msgid " Conflict: can't delete DIR because it is not empty. Not deleting."
8718
#: en/help_topics/conflict-types.txt:243
8720
"This is the opposite of \"missing parent\". A directory is deleted in the\n"
8721
"source, but has new children in the target (either because a directory\n"
8722
"deletion is merged or because the merge introduce new children). Bazaar\n"
8723
"will retain the directory. Resolving this issue depends very much on the\n"
8724
"particular scenario."
8727
#: en/help_topics/conflict-types.txt:254
8729
"* ``--action=take-this`` will acknowledge Bazaar choice to keep the "
8733
#: en/help_topics/conflict-types.txt:256
8735
"* ``--action=take-other`` will issue ``bzr rm directory`` including the \n"
8739
#: en/help_topics/conflict-types.txt:259
8740
msgid "* ``--action=done`` will just mark the conflict as resolved."
8743
#: en/help_topics/conflict-types.txt:261
8745
"Note that when merging a directory deletion, if unversioned files are\n"
8746
"present, they become potential orphans has they don't have a directory\n"
8750
#: en/help_topics/conflict-types.txt:265
8752
"Handling such orphans, *before* the conflict is created, is controlled by\n"
8753
"setting the ``bzr.transform.orphan_policy`` configuration option."
8756
#: en/help_topics/conflict-types.txt:268
8757
msgid "There are two possible values for this option:"
8760
#: en/help_topics/conflict-types.txt:270
8762
"* ``conflict`` (the default): will leave the orphans in place and\n"
8763
" generate a conflicts,"
8766
#: en/help_topics/conflict-types.txt:273
8768
"* ``move``: will move the orphans to a ``bzr-orphans`` directory at the "
8770
" of the working tree with names like ``<file>.~#~``."
8773
#: en/help_topics/conflict-types.txt:278
8779
#: en/help_topics/conflict-types.txt:283
8780
msgid " Path conflict: PATH1 / PATH2"
8783
#: en/help_topics/conflict-types.txt:285
8785
"This happens when the source and target have each modified the name or "
8787
"directory of a file. Bazaar will use the path elements from the source."
8790
#: en/help_topics/conflict-types.txt:288
8792
"To resolve that kind of conflict, you just have to decide what name should "
8794
"retained for the file involved."
8797
#: en/help_topics/conflict-types.txt:293
8799
"* ``--action=take-this`` will revert Bazaar choice and keep ``PATH1`` by\n"
8800
" issuing ``bzr mv PATH2 PATH1``,\n"
8801
"* ``--action=take-other`` will acknowledge Bazaar choice of keeping "
8803
"* ``--action=done`` will just mark the conflict as resolved."
8806
#: en/help_topics/conflict-types.txt:300
8812
#: en/help_topics/conflict-types.txt:305
8813
msgid " Conflict moving FILE into DIRECTORY. Cancelled move."
8816
#: en/help_topics/conflict-types.txt:307
8818
"This happens when the source and the target have each moved directories, so\n"
8819
"that, if the change could be applied, a directory would be contained by "
8824
#: en/help_topics/conflict-types.txt:311
8827
" $ bzr mkdir white\n"
8828
" $ bzr mkdir black\n"
8829
" $ bzr commit -m \"BASE\"\n"
8830
" $ bzr branch . ../other\n"
8831
" $ bzr mv white black\n"
8832
" $ bzr commit -m \"THIS\"\n"
8833
" $ bzr mv ../other/black ../other/white\n"
8834
" $ bzr commit ../other -m \"OTHER\"\n"
8835
" $ bzr merge ../other"
8838
#: en/help_topics/conflict-types.txt:322
8840
"In this situation, Bazaar will cancel the move, and leave ``white`` in\n"
8841
"``black``. To resolve that kind of conflict, you just have to decide what\n"
8842
"name should be retained for the directories involved."
8845
#: en/help_topics/conflict-types.txt:328
8847
"* ``--action=take-this`` will acknowledge Bazaar choice of leaving "
8850
"* ``--action=take-other`` will revert Bazaar choice and move ``black`` in\n"
8851
" ``white`` by issuing ``bzr mv black/white white ; bzr mv black white``,\n"
8852
"* ``--action=done`` will just mark the conflict as resolved."
8855
#: en/help_topics/conflict-types.txt:336
8857
"Non-directory parent\n"
8858
"--------------------"
8861
#: en/help_topics/conflict-types.txt:341
8863
" Conflict: foo.new is not a directory, but has files in it.\n"
8864
" Created directory."
8867
#: en/help_topics/conflict-types.txt:344
8869
"This happens when one side has added files to a directory, and the other "
8871
"has changed the directory into a file or symlink. For example::"
8874
#: en/help_topics/conflict-types.txt:347
8877
" $ bzr mkdir foo\n"
8878
" $ bzr commit -m \"BASE\"\n"
8879
" $ bzr branch . ../other\n"
8882
" $ bzr commit -m \"THIS\"\n"
8883
" $ bzr mkdir ../other/foo/bar\n"
8884
" $ bzr commit ../other -m \"OTHER\"\n"
8885
" $ bzr merge ../other"
8888
#: en/help_topics/conflict-types.txt:358
8890
"To resolve that kind of conflict, you have to decide what name should be\n"
8891
"retained for the file, directory or symlink involved."
8894
#: en/help_topics/conflict-types.txt:363
8896
"* ``--action=take-this`` will issue ``bzr rm --force foo.new`` and \n"
8897
" ``bzr add foo``,\n"
8898
"* ``--action=take-other`` will issue ``bzr rm --force foo`` and \n"
8899
" ``bzr mv foo.new foo``,\n"
8900
"* ``--action=done`` will just mark the conflict as resolved."
8903
#: en/help_topics/conflict-types.txt:371
8905
"MalformedTransform\n"
8906
"------------------"
8909
#: en/help_topics/conflict-types.txt:374
8911
"It is possible (though very rare) for Bazaar to raise a MalformedTransform\n"
8912
"exception. This means that Bazaar encountered a filesystem conflict that it "
8914
"unable to resolve. This usually indicates a bug. Please let us know if "
8916
"encounter this. Our bug tracker is at https://launchpad.net/bzr/+bugs\n"
8919
#: en/help_topics/content-filters.txt:1
8925
#: en/help_topics/content-filters.txt:4
8931
#: en/help_topics/content-filters.txt:7
8933
"Bazaar's content filtering allows you to store files in a different\n"
8934
"format from the copy in your working tree. This lets you, or your\n"
8935
"co-developers, use Windows development tools that expect CRLF files\n"
8936
"on projects that use other line-ending conventions. Among other things,\n"
8937
"content filters also let Unix developers more easily work on projects\n"
8938
"using Windows line-ending conventions, keyword expansion/compression,\n"
8939
"and trailing spaces on lines in text files to be implicitly stripped\n"
8943
#: en/help_topics/content-filters.txt:16
8944
msgid "To generalize, there are two content formats supported by Bazaar:"
8947
#: en/help_topics/content-filters.txt:18
8949
"* a canonical format - how files are stored internally\n"
8950
"* a convenience format - how files are created in a working tree."
8953
#: en/help_topics/content-filters.txt:21
8956
"Format conversion\n"
8960
#: en/help_topics/content-filters.txt:25
8962
"The conversion between these formats is done by content filters.\n"
8963
"A content filter has two parts:"
8966
#: en/help_topics/content-filters.txt:28
8968
"* a read converter - converts from convenience to canonical format\n"
8969
"* a write converter - converts from canonical to convenience format."
8972
#: en/help_topics/content-filters.txt:31
8974
"Many of these converters will provide *round-trip* conversion,\n"
8975
"i.e. applying the read converter followed by the write converter\n"
8976
"gives back the original content. However, others may provide an\n"
8977
"asymmetric conversion. For example, a read converter might strip\n"
8978
"trailing whitespace off lines in source code while the matching\n"
8979
"write converter might pass content through unchanged."
8982
#: en/help_topics/content-filters.txt:38
8985
"Enabling content filters\n"
8986
"------------------------"
8989
#: en/help_topics/content-filters.txt:42
8991
"Content filters are typically provided by plugins, so the first step\n"
8992
"in using them is to install the relevant plugins and read their\n"
8993
"documentation. Some plugins may be very specific about which files\n"
8994
"they filter, e.g. only files ending in ``.java`` or ``.php``.\n"
8995
"In other cases, the plugin may leave it in the user's hands to\n"
8996
"define which files are to be filtered. This is typically done\n"
8997
"using rule-based preferences. See ``bzr help rules`` for general\n"
8998
"information about defining these."
9001
#: en/help_topics/content-filters.txt:51
9004
"Impact on commands\n"
9005
"------------------"
9008
#: en/help_topics/content-filters.txt:55
9010
"Read converters are only applied to commands that read content from\n"
9011
"a working tree, e.g. status, diff and commit. For example, ``bzr diff``\n"
9012
"will apply read converters to files in the working tree, then compare\n"
9013
"the results to the content last committed."
9016
#: en/help_topics/content-filters.txt:60
9018
"Write converters are only applied by commands that **create files in a\n"
9019
"working tree**, e.g. branch, checkout, update. If you wish to see the\n"
9020
"canonical format of a file or tree, use ``bzr cat`` or ``bzr export``\n"
9024
#: en/help_topics/content-filters.txt:65
9026
"Note: ``bzr commit`` does not implicitly apply write converters after\n"
9027
"comitting files. If this makes sense for a given plugin providing\n"
9028
"a content filter, the plugin can usually achieve this effect by using a\n"
9029
"``start_commit`` or ``post_commit`` hook say. See :doc:`hooks-help`\n"
9030
"for more information on hooks."
9033
#: en/help_topics/content-filters.txt:71
9036
"Refreshing your working tree\n"
9037
"----------------------------"
9040
#: en/help_topics/content-filters.txt:75
9042
"For performance reasons, Bazaar caches the timestamps of files in\n"
9043
"a working tree, and assumes files are unchanged if their timestamps\n"
9044
"match the cached values. As a consequence, there are times when\n"
9045
"you may need to explicitly ask for content filtering to be reapplied\n"
9046
"in one or both directions, e.g. after installing or reconfiguring\n"
9047
"plugins providing it."
9050
#: en/help_topics/content-filters.txt:82
9051
msgid "Here are some general guidelines for doing this:"
9054
#: en/help_topics/content-filters.txt:84
9056
" * To reapply read converters, ``touch`` files, i.e. update their\n"
9057
" timestamp. Operations like ``bzr status`` should then reapply the\n"
9058
" relevant read converters and compare the end result with the\n"
9059
" canonical format."
9062
#: en/help_topics/content-filters.txt:89
9064
" * To reapply write converters, ensure there are no local changes,\n"
9065
" delete the relevant files and run ``bzr revert`` on those files."
9068
#: en/help_topics/content-filters.txt:92
9070
"Note: In the future, it is likely that additional options will be added\n"
9071
"to commands to make this refreshing process faster and safer.\n"
9074
#: en/help_topics/current-formats.txt:1
9075
msgid "Current Storage Formats"
9078
#: en/help_topics/current-formats.txt:3
9081
" (native) (default) First format for bzr 2.0 series. Uses group-\n"
9082
" compress storage. Provides rich roots which are a one-way\n"
9086
#: en/help_topics/current-formats.txt:8
9089
" (native) New in 0.92: Pack-based format with data compatible with\n"
9090
" dirstate-tags format repositories. Interoperates with bzr\n"
9091
" repositories before 0.92 but cannot be read by bzr < 0.92."
9094
#: en/help_topics/current-formats.txt:13
9097
" (native) A working-tree format that supports content filtering."
9100
#: en/help_topics/current-formats.txt:16
9102
":1.14-rich-root:\n"
9103
" (native) A variant of 1.14 that supports rich-root data (needed\n"
9104
" for bzr-svn and bzr-git)."
9107
#: en/help_topics/current-formats.txt:20
9110
"See :doc:`formats-help` for more about storage formats."
9113
#: en/help_topics/debug-flags.txt:1
9119
#: en/help_topics/debug-flags.txt:4
9121
"These flags can be passed on the bzr command line or (without the ``-D``\n"
9122
"prefix) put in the ``debug_flags`` variable in ``bazaar.conf``."
9125
#: en/help_topics/debug-flags.txt:7
9127
"-Dauth Trace authentication sections used.\n"
9128
"-Dbytes Print out how many bytes were transferred\n"
9129
"-Ddirstate Trace dirstate activity (verbose!)\n"
9130
"-Derror Instead of normal error handling, always print a "
9133
"-Devil Capture call sites that do expensive or badly-scaling\n"
9135
"-Dfetch Trace history copying between repositories.\n"
9136
"-Dfilters Emit information for debugging content filtering.\n"
9137
"-Dforceinvdeltas Force use of inventory deltas during generic streaming "
9139
"-Dgraph Trace graph traversal.\n"
9140
"-Dhashcache Log every time a working file is read to determine its "
9142
"-Dhooks Trace hook execution.\n"
9143
"-Dhpss Trace smart protocol requests and responses.\n"
9144
"-Dhpssdetail More hpss details.\n"
9145
"-Dhpssvfs Traceback on vfs access to Remote objects.\n"
9146
"-Dhttp Trace http connections, requests and responses.\n"
9147
"-Dindex Trace major index operations.\n"
9148
"-Dknit Trace knit operations.\n"
9149
"-Dlock Trace when lockdir locks are taken or released.\n"
9150
"-Dprogress Trace progress bar operations.\n"
9151
"-Dmem_dump Dump memory to a file upon an out of memory error.\n"
9152
"-Dmerge Emit information for debugging merges.\n"
9153
"-Dno_apport Don't use apport to report crashes.\n"
9154
"-Dno_activity \t Don't show transport activity indicator in progress bar.\n"
9155
"-Dpack Emit information about pack operations.\n"
9156
"-Drelock Emit a message every time a branch or repository object "
9158
" unlocked then relocked the same way.\n"
9159
"-Dsftp Trace SFTP internals.\n"
9160
"-Dstatic_tuple Error when a tuple is used where a StaticTuple is "
9162
"-Dstream Trace fetch streams.\n"
9163
"-Dstrict_locks Trace when OS locks are potentially used in a non-"
9166
"-Dunlock Some errors during unlock are treated as warnings.\n"
9167
"-DIDS_never Never use InterDifferingSerializer when fetching.\n"
9168
"-DIDS_always Always use InterDifferingSerializer to fetch if "
9170
" for the format, even for non-local fetches.\n"
9173
#: en/help_topics/diverged-branches.txt:1
9175
"Diverged Branches\n"
9179
#: en/help_topics/diverged-branches.txt:4
9181
"When Bazaar tries to push one branch onto another, it requires that the\n"
9182
"destination branch must be ready to receive the source branch. If this "
9184
"the case, then we say that the branches have ``diverged``. Branches are\n"
9185
"considered diverged if the destination branch's most recent commit is one "
9187
"has not been merged (directly or indirectly) by the source branch. To "
9189
"from diverged branches, one must merge the missing revisions into the "
9194
#: en/help_topics/diverged-branches.txt:12
9196
"This situation commonly arises when using a centralized workflow with local\n"
9197
"commits. If someone else has committed new work to the mainline since your\n"
9198
"last pull and you have local commits that have not yet been pushed to the\n"
9199
"mainline, then your local branch and the mainline have diverged."
9202
#: en/help_topics/diverged-branches.txt:17
9204
"Discovering What Has Diverged\n"
9205
"-----------------------------"
9208
#: en/help_topics/diverged-branches.txt:20
9210
"The ``bzr missing`` command is used to find out what revisions are in "
9212
"branch that are not present in the current branch, and vice-versa. It shows "
9214
"summary of which extra revisions exist in each branch. If you want to see "
9216
"precise effects of those revisions, you can use ``bzr diff --"
9217
"old=other_branch``\n"
9218
"to show the differences between other_branch and your current branch."
9221
#: en/help_topics/diverged-branches.txt:26
9227
#: en/help_topics/diverged-branches.txt:29
9229
"The solution is to merge the revisions from the mainline into your local\n"
9230
"branch. To do so, use ``bzr merge`` to get the new revisions from the\n"
9231
"mainline. This merge may result in conflicts if the other developer's "
9233
"overlap with your changes. These conflicts should be resolved before\n"
9234
"continuing. After any conflicts have been resolved, or even if there were "
9236
"conflicts, Bazaar requires that you explicitly commit these new revisions\n"
9237
"to your local branch. This requirement gives you an opportunity to test "
9239
"resulting working tree for correctness, since the merged revisions could "
9241
"made arbitrary changes. After testing, you should commit the merge using\n"
9242
"``bzr commit``. This clears up the diverged branches situation. Your "
9244
"branch can now be pushed to the mainline.\n"
9247
#: en/help_topics/eol.txt:1
9249
"End of Line Conversion\n"
9250
"======================"
9253
#: en/help_topics/eol.txt:4
9255
"EOL conversion is provided as a content filter where Bazaar internally\n"
9256
"stores a canonical format but outputs a convenience format. See\n"
9257
"``bzr help content-filters`` for general information about using these."
9260
#: en/help_topics/eol.txt:8
9262
"Note: Content filtering is only supported in recently added formats,\n"
9263
"e.g. 1.14. Be sure that both the repository *and* the branch are\n"
9264
"in a recent format. (Just setting the format on the repository\n"
9265
"is not enough.) If content filtering does not appear to be working, use\n"
9266
"'bzr info -v' to confirm that the branch is using \"Working tree format 5\"\n"
9270
#: en/help_topics/eol.txt:15
9272
"EOL conversion needs to be enabled for selected file patterns using\n"
9273
"rules. See ``bzr help rules`` for general information on defining rules.\n"
9274
"Currently, rules are only supported in $BZR_HOME/.bazaar/rules (or\n"
9275
"%BZR_HOME%/bazaar/2.0/rules on Windows). Branch specific rules will be\n"
9276
"supported in a future verison of Bazaar."
9279
#: en/help_topics/eol.txt:21
9281
"To configure which files to filter, set ``eol`` to one of the values below.\n"
9282
"(If a value is not set, ``exact`` is the default.)"
9285
#: en/help_topics/eol.txt:24
9287
" ========== ===================================== ======================\n"
9288
" Value Checkout end-of-lines as Commit end-of-lines as\n"
9289
" ========== ===================================== ======================\n"
9290
" ``native`` ``crlf`` on Windows, ``lf`` otherwise ``lf``\n"
9291
" ---------- ------------------------------------- ----------------------\n"
9292
" ``lf`` ``lf`` ``lf``\n"
9293
" ---------- ------------------------------------- ----------------------\n"
9294
" ``crlf`` ``crlf`` ``lf``\n"
9295
" ---------- ------------------------------------- ----------------------\n"
9296
" ``exact`` No conversion Exactly as in file\n"
9297
" ========== ===================================== ======================"
9300
#: en/help_topics/eol.txt:36
9302
"Note: For safety reasons, no conversion is applied to any file where a null\n"
9303
"byte is detected in the file."
9306
#: en/help_topics/eol.txt:39
9308
"For users working on a cross-platform project, here is a suggested rule\n"
9309
"to use as a starting point::"
9312
#: en/help_topics/eol.txt:42
9318
#: en/help_topics/eol.txt:45
9320
"If you have binary files that do not contain a null byte though, be\n"
9321
"sure to add ``eol = exact`` rules for those as well. You can do this\n"
9322
"by giving more explicit patterns earlier in the rules file. For example::"
9325
#: en/help_topics/eol.txt:49
9331
#: en/help_topics/eol.txt:55
9333
"If your working tree is on a network drive shared by users on different\n"
9334
"operating systems, you typically want to force certain conventions for\n"
9335
"certain files. In that way, if a file is created with the wrong line\n"
9336
"endings or line endings get mixed during editing, it gets committed\n"
9337
"correctly and gets checked out correctly. For example::"
9340
#: en/help_topics/eol.txt:61
9346
#: en/help_topics/eol.txt:64
9352
#: en/help_topics/eol.txt:70
9354
"If you take the care to create files with their required endings, you can\n"
9355
"achieve *almost* the same thing by using ``eol = exact``. It is slightly\n"
9356
"safer to use ``lf`` and ``crlf`` though because edits accidentally\n"
9357
"introducing mixed line endings will be corrected during commit for files\n"
9358
"with those settings."
9361
#: en/help_topics/eol.txt:76
9363
"If you have sample test data that deliberately has text files with mixed\n"
9364
"newline conventions, you can ask for those to be left alone like this::"
9367
#: en/help_topics/eol.txt:79
9369
" [name test_data/]\n"
9373
#: en/help_topics/eol.txt:85
9375
"Note that ``exact`` does not imply the file is binary but it does mean\n"
9376
"that no conversion of end-of-lines will be done. (Bazaar currently relies\n"
9377
"of content analysis to detect binary files for commands like ``diff``.\n"
9378
"In the future, a ``binary = true`` rule may be added but it is not\n"
9382
#: en/help_topics/eol.txt:91
9384
"If you have an existing repository with text files already stored using\n"
9385
"Windows newline conventions (``crlf``), then you may want to keep using "
9387
"convention in the repository. Forcing certain files to this convention\n"
9388
"may also help users who do not have rules configured. To do this, set\n"
9389
"``eol`` to one of the values below."
9392
#: en/help_topics/eol.txt:97
9394
" ============================ ======================== "
9395
"======================\n"
9396
" Value Checkout end-of-lines as Commit end-of-lines "
9398
" ============================ ======================== "
9399
"======================\n"
9400
" ``native-with-crlf-in-repo`` ``crlf`` on Windows, ``crlf``\n"
9401
" ``lf`` otherwise\n"
9402
" ---------------------------- ------------------------ "
9403
"----------------------\n"
9404
" ``lf-with-crlf-in-repo`` ``lf`` ``crlf``\n"
9405
" ---------------------------- ------------------------ "
9406
"----------------------\n"
9407
" ``crlf-with-crlf-in-repo`` ``crlf`` ``crlf``\n"
9408
" ============================ ======================== ======================"
9411
#: en/help_topics/eol.txt:108
9413
"For users working on an existing project that uses Windows newline\n"
9414
"conventions in their Bazaar repository, this rule is suggested as a\n"
9418
#: en/help_topics/eol.txt:112
9421
" eol = native-with-crlf-in-repo"
9424
#: en/help_topics/eol.txt:115
9426
"For new projects, it is recommended that end-of-lines be stored as ``lf``\n"
9427
"and that users stick to the basic settings, i.e. ``native``, ``lf``,\n"
9428
"``crlf`` and ``exact``."
9431
#: en/help_topics/eol.txt:119
9433
"Note: Bazaar's EOL conversion will convert the content of files but\n"
9434
"never reject files because a given line ending or mixed line endings\n"
9435
"are found. A precommit hook should be used if you wish to validate\n"
9436
"(and not just convert) content before committing.\n"
9439
#: en/help_topics/hidden-commands.txt:1
9441
"added List files added in working tree.\n"
9442
"ancestry List all revisions merged into this branch.\n"
9443
"assert-fail Test reporting of assertion failures\n"
9444
"bundle-info Output interesting stats about a bundle\n"
9445
"bundle-revisions Create a merge-directive for submitting changes.\n"
9446
"cat-revision Write out metadata for a revision.\n"
9447
"dpush Push into a different VCS without any custom bzr\n"
9449
"dump-btree Dump the contents of a btree index file to stdout.\n"
9450
"export-pot Export command helps and error messages in po "
9452
"file-id Print file_id of a particular file or directory.\n"
9453
"file-path Print path of file_ids to a file or directory.\n"
9454
"find-merge-base Find and print a base revision for merging two "
9456
"hooks Show hooks.\n"
9457
"inventory Show inventory of the current working copy or a\n"
9459
"is-ignored Check if a path is ignored. [qbzr]\n"
9460
"is-versioned Check if a path is versioned. [qbzr]\n"
9461
"local-time-offset Show the offset in seconds from GMT to local time.\n"
9462
"lookup-revision Lookup the revision-id from a revision-number\n"
9463
"merge-directive Generate a merge directive for auto-merge tools.\n"
9464
"modified List files modified in working tree.\n"
9465
"qcheckout-ala-explorer Checkout a branch. The checkout is always "
9468
"qhelp Shows a help window [qbzr]\n"
9469
"qmain The QBzr main application. [qbzr]\n"
9470
"qsubprocess Run some bzr command as subprocess. [qbzr]\n"
9471
"re-sign Create a digital signature for an existing revision.\n"
9472
"reference list, view and set branch locations for nested "
9474
"relpath Show path of a file relative to root\n"
9475
"repair-workingtree Reset the working tree state file.\n"
9476
"revision-history Display the list of revision ids on a branch.\n"
9477
"revision-info Show revision number and revision id for a given\n"
9478
" revision identifier.\n"
9479
"rocks Statement of optimism.\n"
9480
"selftest Run internal test suite.\n"
9481
"shell-complete Show appropriate completions for context.\n"
9482
"test-script Run a shell-like test from a file.\n"
9483
"touching-revisions Return revision-ids which affected a particular "
9485
"unknowns List unknown files.\n"
9486
"wait-until-signalled Test helper for\n"
9487
" test_start_and_stop_bzr_subprocess_send_signal.\n"
9490
#: en/help_topics/hooks.txt:1
9497
#: en/help_topics/hooks.txt:5
9503
#: en/help_topics/hooks.txt:8
9504
msgid "A hook of type *xxx* of class *yyy* needs to be registered using::"
9507
#: en/help_topics/hooks.txt:10
9508
msgid " yyy.hooks.install_named_hook(\"xxx\", ...)"
9511
#: en/help_topics/hooks.txt:12
9513
"See :doc:`Using hooks<../user-guide/hooks>` in the User Guide for examples."
9516
#: en/help_topics/hooks.txt:14
9518
"The class that contains each hook is given before the hooks it supplies. "
9520
"instance, BranchHooks as the class is the hooks class for\n"
9521
"`bzrlib.branch.Branch.hooks`."
9524
#: en/help_topics/hooks.txt:18
9526
"Each description also indicates whether the hook runs on the client (the\n"
9527
"machine where bzr was invoked) or the server (the machine addressed by\n"
9528
"the branch URL). These may be, but are not necessarily, the same machine."
9531
#: en/help_topics/hooks.txt:22
9533
"Plugins (including hooks) are run on the server if all of these is true:"
9536
#: en/help_topics/hooks.txt:24
9538
" * The connection is via a smart server (accessed with a URL starting with\n"
9539
" \"bzr://\", \"bzr+ssh://\" or \"bzr+http://\", or accessed via a "
9541
" URL when a smart server is available via HTTP)."
9544
#: en/help_topics/hooks.txt:28
9546
" * The hook is either server specific or part of general infrastructure "
9548
" than client specific code (such as commit)."
9551
#: en/help_topics/hooks.txt:31
9558
#: en/help_topics/hooks.txt:35
9560
"automatic_tag_name\n"
9561
"~~~~~~~~~~~~~~~~~~"
9564
#: en/help_topics/hooks.txt:38
9565
msgid "Introduced in: 2.2"
9568
#: en/help_topics/hooks.txt:40
9570
"Called to determine an automatic tag name for a revision.\n"
9571
"automatic_tag_name is called with (branch, revision_id) and should\n"
9572
"return a tag name or None if no tag name could be determined. The\n"
9573
"first non-None tag name returned will be used."
9576
#: en/help_topics/hooks.txt:45
9582
#: en/help_topics/hooks.txt:48
9583
msgid "Introduced in: 1.8"
9586
#: en/help_topics/hooks.txt:50
9588
"Called with the Branch object that has been opened after a branch is\n"
9592
#: en/help_topics/hooks.txt:53
9594
"post_branch_init\n"
9598
#: en/help_topics/hooks.txt:58
9600
"Called after new branch initialization completes. post_branch_init is\n"
9601
"called with a bzrlib.branch.BranchInitHookParams. Note that init,\n"
9602
"branch and checkout (both heavyweight and lightweight) will all\n"
9603
"trigger this hook."
9606
#: en/help_topics/hooks.txt:63
9608
"post_change_branch_tip\n"
9609
"~~~~~~~~~~~~~~~~~~~~~~"
9612
#: en/help_topics/hooks.txt:66
9613
msgid "Introduced in: 1.4"
9616
#: en/help_topics/hooks.txt:68
9618
"Called in bzr client and server after a change to the tip of a branch\n"
9619
"is made. post_change_branch_tip is called with a\n"
9620
"bzrlib.branch.ChangeBranchTipParams. Note that push, pull, commit,\n"
9621
"uncommit will all trigger this hook."
9624
#: en/help_topics/hooks.txt:73
9630
#: en/help_topics/hooks.txt:76
9631
msgid "Introduced in: 0.15"
9634
#: en/help_topics/hooks.txt:78
9636
"Called in the bzr client after a commit has completed. post_commit is\n"
9637
"called with (local, master, old_revno, old_revid, new_revno,\n"
9638
"new_revid). old_revid is NULL_REVISION for the first commit to a\n"
9642
#: en/help_topics/hooks.txt:83
9648
#: en/help_topics/hooks.txt:88
9650
"Called after a pull operation completes. post_pull is called with a\n"
9651
"bzrlib.branch.PullResult object and only runs in the bzr client."
9654
#: en/help_topics/hooks.txt:91
9660
#: en/help_topics/hooks.txt:96
9662
"Called after a push operation completes. post_push is called with a\n"
9663
"bzrlib.branch.BranchPushResult object and only runs in the bzr client."
9666
#: en/help_topics/hooks.txt:99
9672
#: en/help_topics/hooks.txt:104
9674
"Called after a checkout switches branch. post_switch is called with a\n"
9675
"bzrlib.branch.SwitchHookParams."
9678
#: en/help_topics/hooks.txt:107
9684
#: en/help_topics/hooks.txt:112
9686
"Called in the bzr client after an uncommit completes. post_uncommit is\n"
9687
"called with (local, master, old_revno, old_revid, new_revno,\n"
9688
"new_revid) where local is the local branch or None, master is the\n"
9689
"target branch, and an empty branch receives new_revno of 0, new_revid\n"
9693
#: en/help_topics/hooks.txt:118
9695
"pre_change_branch_tip\n"
9696
"~~~~~~~~~~~~~~~~~~~~~"
9699
#: en/help_topics/hooks.txt:121
9700
msgid "Introduced in: 1.6"
9703
#: en/help_topics/hooks.txt:123
9705
"Called in bzr client and server before a change to the tip of a branch\n"
9706
"is made. pre_change_branch_tip is called with a\n"
9707
"bzrlib.branch.ChangeBranchTipParams. Note that push, pull, commit,\n"
9708
"uncommit will all trigger this hook."
9711
#: en/help_topics/hooks.txt:128
9717
#: en/help_topics/hooks.txt:131
9718
msgid "Introduced in: 0.91"
9721
#: en/help_topics/hooks.txt:133
9723
"Called after a commit is calculated but before it is completed.\n"
9724
"pre_commit is called with (local, master, old_revno, old_revid,\n"
9725
"future_revno, future_revid, tree_delta, future_tree). old_revid is\n"
9726
"NULL_REVISION for the first commit to a branch, tree_delta is a\n"
9727
"TreeDelta object describing changes from the basis revision. hooks\n"
9728
"MUST NOT modify this delta. future_tree is an in-memory tree obtained\n"
9729
"from CommitBuilder.revision_tree() and hooks MUST NOT modify this\n"
9733
#: en/help_topics/hooks.txt:142
9739
#: en/help_topics/hooks.txt:147
9741
"Invoked whenever the revision history has been set via\n"
9742
"set_revision_history. The api signature is (branch, revision_history),\n"
9743
"and the branch will be write-locked. The set_rh hook can be expensive\n"
9744
"for bzr to trigger, a better hook to use is\n"
9745
"Branch.post_change_branch_tip."
9748
#: en/help_topics/hooks.txt:153
9750
"transform_fallback_location\n"
9751
"~~~~~~~~~~~~~~~~~~~~~~~~~~~"
9754
#: en/help_topics/hooks.txt:156
9755
msgid "Introduced in: 1.9"
9758
#: en/help_topics/hooks.txt:158
9760
"Called when a stacked branch is activating its fallback locations.\n"
9761
"transform_fallback_location is called with (branch, url), and should\n"
9762
"return a new url. Returning the same url allows it to be used as-is,\n"
9763
"returning a different one can be used to cause the branch to stack on\n"
9764
"a closer copy of that fallback_location. Note that the branch cannot\n"
9765
"have history accessing methods called on it during this hook because\n"
9766
"the fallback locations have not been activated. When there are\n"
9767
"multiple hooks installed for transform_fallback_location, all are\n"
9768
"called with the url returned from the previous hook.The order is\n"
9769
"however undefined."
9772
#: en/help_topics/hooks.txt:169
9778
#: en/help_topics/hooks.txt:172
9784
#: en/help_topics/hooks.txt:177
9786
"Invoked after a repository has been initialized. post_repo_init is\n"
9787
"called with a bzrlib.bzrdir.RepoInitHookParams."
9790
#: en/help_topics/hooks.txt:180
9796
#: en/help_topics/hooks.txt:183
9797
msgid "Introduced in: 1.14"
9800
#: en/help_topics/hooks.txt:185
9802
"Invoked before attempting to open a BzrDir with the transport that the\n"
9806
#: en/help_topics/hooks.txt:188
9812
#: en/help_topics/hooks.txt:191
9818
#: en/help_topics/hooks.txt:194
9819
msgid "Introduced in: 1.13"
9822
#: en/help_topics/hooks.txt:196
9824
"Called after creating a command object to allow modifications such as\n"
9825
"adding or removing options, docs etc. Called with the new\n"
9826
"bzrlib.commands.Command object."
9829
#: en/help_topics/hooks.txt:200
9835
#: en/help_topics/hooks.txt:203
9836
msgid "Introduced in: 1.17"
9839
#: en/help_topics/hooks.txt:205
9841
"Called when creating a single command. Called with (cmd_or_None,\n"
9842
"command_name). get_command should either return the cmd_or_None\n"
9843
"parameter, or a replacement Command object that should be used for the\n"
9844
"command. Note that the Command.hooks hooks are core infrastructure.\n"
9845
"Many users will prefer to use bzrlib.commands.register_command or\n"
9846
"plugin_cmds.register_lazy."
9849
#: en/help_topics/hooks.txt:212
9851
"get_missing_command\n"
9852
"~~~~~~~~~~~~~~~~~~~"
9855
#: en/help_topics/hooks.txt:217
9857
"Called when creating a single command if no command could be found.\n"
9858
"Called with (command_name). get_missing_command should either return\n"
9859
"None, or a Command object to be used for the command."
9862
#: en/help_topics/hooks.txt:221
9868
#: en/help_topics/hooks.txt:226
9870
"Called when enumerating commands. Called with a set of cmd_name\n"
9871
"strings for all the commands found so far. This set is safe to mutate\n"
9872
"- e.g. to remove a command. list_commands should return the updated\n"
9873
"set of command names."
9876
#: en/help_topics/hooks.txt:231
9882
#: en/help_topics/hooks.txt:234
9888
#: en/help_topics/hooks.txt:237
9889
msgid "Introduced in: 2.4"
9892
#: en/help_topics/hooks.txt:239
9894
"Invoked when a config option is read. The signature is (stack, name,\n"
9898
#: en/help_topics/hooks.txt:242
9904
#: en/help_topics/hooks.txt:247
9905
msgid "Invoked when a config store is loaded. The signature is (store)."
9908
#: en/help_topics/hooks.txt:249
9914
#: en/help_topics/hooks.txt:254
9916
"Invoked when a config option is removed. The signature is (stack,\n"
9920
#: en/help_topics/hooks.txt:257
9926
#: en/help_topics/hooks.txt:262
9927
msgid "Invoked when a config store is saved. The signature is (store)."
9930
#: en/help_topics/hooks.txt:264
9936
#: en/help_topics/hooks.txt:269
9938
"Invoked when a config option is set. The signature is (stack, name,\n"
9942
#: en/help_topics/hooks.txt:272
9948
#: en/help_topics/hooks.txt:275
9954
#: en/help_topics/hooks.txt:278
9955
msgid "Introduced in: 1.15"
9958
#: en/help_topics/hooks.txt:280
9960
"Invoked when displaying the statistics for a repository. repository is\n"
9961
"called with a statistics dictionary as returned by the repository and\n"
9962
"a file-like object to write to."
9965
#: en/help_topics/hooks.txt:284
9971
#: en/help_topics/hooks.txt:287
9977
#: en/help_topics/hooks.txt:292
9978
msgid "Called with a bzrlib.lock.LockResult when a physical lock is acquired."
9981
#: en/help_topics/hooks.txt:294
9987
#: en/help_topics/hooks.txt:299
9988
msgid "Called with a bzrlib.lock.LockResult when a physical lock is broken."
9991
#: en/help_topics/hooks.txt:301
9997
#: en/help_topics/hooks.txt:306
9998
msgid "Called with a bzrlib.lock.LockResult when a physical lock is released."
10001
#: en/help_topics/hooks.txt:308
10007
#: en/help_topics/hooks.txt:311
10009
"merge_file_content\n"
10010
"~~~~~~~~~~~~~~~~~~"
10013
#: en/help_topics/hooks.txt:314
10014
msgid "Introduced in: 2.1"
10017
#: en/help_topics/hooks.txt:316
10019
"Called with a bzrlib.merge.Merger object to create a per file merge\n"
10020
"object when starting a merge. Should return either None or a subclass\n"
10021
"of ``bzrlib.merge.AbstractPerFileMerger``. Such objects will then be\n"
10022
"called per file that needs to be merged (including when one side has\n"
10023
"deleted the file and the other has changed it). See the\n"
10024
"AbstractPerFileMerger API docs for details on how it is used by merge."
10027
#: en/help_topics/hooks.txt:323
10029
"MergeDirectiveHooks\n"
10030
"-------------------"
10033
#: en/help_topics/hooks.txt:326
10035
"merge_request_body\n"
10036
"~~~~~~~~~~~~~~~~~~"
10039
#: en/help_topics/hooks.txt:329
10040
msgid "Introduced in: 1.15.0"
10043
#: en/help_topics/hooks.txt:331
10045
"Called with a MergeRequestBodyParams when a body is needed for a merge\n"
10046
"request. Callbacks must return a body. If more than one callback is\n"
10047
"registered, the output of one callback is provided to the next."
10050
#: en/help_topics/hooks.txt:335
10052
"MessageEditorHooks\n"
10053
"------------------"
10056
#: en/help_topics/hooks.txt:338
10058
"commit_message_template\n"
10059
"~~~~~~~~~~~~~~~~~~~~~~~"
10062
#: en/help_topics/hooks.txt:341
10063
msgid "Introduced in: 1.10"
10066
#: en/help_topics/hooks.txt:343
10068
"Called when a commit message is being generated.\n"
10069
"commit_message_template is called with the bzrlib.commit.Commit object\n"
10070
"and the message that is known so far. commit_message_template must\n"
10071
"return a new message to use (which could be the same as it was given).\n"
10072
"When there are multiple hooks registered for commit_message_template,\n"
10073
"they are chained with the result from the first passed into the\n"
10074
"second, and so on."
10077
#: en/help_topics/hooks.txt:351
10079
"set_commit_message\n"
10080
"~~~~~~~~~~~~~~~~~~"
10083
#: en/help_topics/hooks.txt:356
10085
"Set a fixed commit message. set_commit_message is called with the\n"
10086
"bzrlib.commit.Commit object (so you can also change e.g. revision\n"
10087
"properties by editing commit.builder._revprops) and the message so\n"
10088
"far. set_commit_message must return the message to use or None if it\n"
10089
"should use the message editor as normal."
10092
#: en/help_topics/hooks.txt:362
10094
"MutableTreeHooks\n"
10098
#: en/help_topics/hooks.txt:368
10099
msgid "Introduced in: 2.0"
10102
#: en/help_topics/hooks.txt:370
10104
"Called after a commit is performed on a tree. The hook is called with\n"
10105
"a bzrlib.mutabletree.PostCommitHookParams object. The mutable tree the\n"
10106
"commit was performed on is available via the mutable_tree attribute of\n"
10110
#: en/help_topics/hooks.txt:375
10116
#: en/help_topics/hooks.txt:380
10118
"Called before a commit is performed on a tree. The start commit hook\n"
10119
"is able to change the tree before the commit takes place. start_commit\n"
10120
"is called with the bzrlib.mutabletree.MutableTree that the commit is\n"
10121
"being performed on."
10124
#: en/help_topics/hooks.txt:385
10126
"SmartClientHooks\n"
10130
#: en/help_topics/hooks.txt:388
10136
#: en/help_topics/hooks.txt:391
10137
msgid "Introduced in: unknown"
10140
#: en/help_topics/hooks.txt:393
10142
"Called when the smart client is submitting a request to the smart\n"
10143
"server. Called with a bzrlib.smart.client.CallHookParams object.\n"
10144
"Streaming request bodies, and responses, are not accessible."
10147
#: en/help_topics/hooks.txt:397
10149
"SmartServerHooks\n"
10153
#: en/help_topics/hooks.txt:400
10155
"server_exception\n"
10159
#: en/help_topics/hooks.txt:405
10161
"Called by the bzr server when an exception occurs. server_exception is\n"
10162
"called with the sys.exc_info() tuple return true for the hook if the\n"
10163
"exception has been handled, in which case the server will exit\n"
10167
#: en/help_topics/hooks.txt:410
10173
#: en/help_topics/hooks.txt:413
10174
msgid "Introduced in: 0.16"
10177
#: en/help_topics/hooks.txt:415
10179
"Called by the bzr server when it starts serving a directory.\n"
10180
"server_started is called with (backing urls, public url), where\n"
10181
"backing_url is a list of URLs giving the server-specific directory\n"
10182
"locations, and public_url is the public URL for the directory being\n"
10186
#: en/help_topics/hooks.txt:421
10188
"server_started_ex\n"
10189
"~~~~~~~~~~~~~~~~~"
10192
#: en/help_topics/hooks.txt:426
10194
"Called by the bzr server when it starts serving a directory.\n"
10195
"server_started is called with (backing_urls, server_obj)."
10198
#: en/help_topics/hooks.txt:429
10204
#: en/help_topics/hooks.txt:434
10206
"Called by the bzr server when it stops serving a directory.\n"
10207
"server_stopped is called with the same parameters as the\n"
10208
"server_started hook: (backing_urls, public_url)."
10211
#: en/help_topics/hooks.txt:438
10217
#: en/help_topics/hooks.txt:441
10223
#: en/help_topics/hooks.txt:444
10224
msgid "Introduced in: 2.3"
10227
#: en/help_topics/hooks.txt:446
10229
"Called with argument StatusHookParams after Bazaar has displayed the\n"
10230
"status. StatusHookParams has the attributes (old_tree, new_tree,\n"
10231
"to_file, versioned, show_ids, short, verbose). The last four arguments\n"
10232
"correspond to the command line options specified by the user for the\n"
10233
"status command. to_file is the output stream for writing."
10236
#: en/help_topics/hooks.txt:452
10242
#: en/help_topics/hooks.txt:457
10244
"Called with argument StatusHookParams before Bazaar displays the\n"
10245
"status. StatusHookParams has the attributes (old_tree, new_tree,\n"
10246
"to_file, versioned, show_ids, short, verbose). The last four arguments\n"
10247
"correspond to the command line options specified by the user for the\n"
10248
"status command. to_file is the output stream for writing."
10251
#: en/help_topics/hooks.txt:463
10253
"RioVersionInfoBuilderHooks\n"
10254
"--------------------------"
10257
#: en/help_topics/hooks.txt:466
10263
#: en/help_topics/hooks.txt:471
10265
"Invoked when adding information about a revision to the RIO stanza\n"
10266
"that is printed. revision is called with a revision object and a RIO\n"
10270
#: en/help_topics/location-alias.txt:1
10272
"Location aliases\n"
10276
#: en/help_topics/location-alias.txt:4
10278
"Bazaar defines several aliases for locations associated with a branch. "
10280
"can be used with most commands that expect a location, such as `bzr push`."
10283
#: en/help_topics/location-alias.txt:7
10284
msgid "The aliases are::"
10287
#: en/help_topics/location-alias.txt:9
10289
" :parent the parent of this branch\n"
10290
" :submit the submit branch for this branch\n"
10291
" :public the public location of this branch\n"
10292
" :bound the branch this branch is bound to, for bound branches\n"
10293
" :push the saved location used for `bzr push` with no arguments\n"
10294
" :this this branch"
10297
#: en/help_topics/location-alias.txt:16
10298
msgid "For example, to push to the parent location::"
10301
#: en/help_topics/location-alias.txt:18
10302
msgid " bzr push :parent"
10305
#: en/help_topics/log-formats.txt:1
10311
#: en/help_topics/log-formats.txt:4
10313
"A log format controls how information about each revision is displayed.\n"
10314
"The standard log formats are compared below::"
10317
#: en/help_topics/log-formats.txt:7
10319
" Feature long short line\n"
10320
" ---------------------- ------------- ------------ -------------------\n"
10321
" design goal detailed view concise view 1 revision per line\n"
10322
" committer name+email name only name only\n"
10323
" author name+email - -\n"
10324
" date-time format full date only date only\n"
10325
" commit message full full top line\n"
10326
" tags yes yes yes\n"
10327
" merges indicator - yes -\n"
10328
" status/delta optional optional -\n"
10329
" diff/patch optional optional -\n"
10330
" revision-id optional optional -\n"
10331
" branch nick yes - -\n"
10332
" foreign vcs properties yes yes -\n"
10333
" preferred levels all 1 1\n"
10334
" digital signature optional - -"
10337
#: en/help_topics/log-formats.txt:24
10339
"The default format is ``long``. To change this, define the ``log_format``\n"
10340
"setting in the ``[DEFAULT]`` section of ``bazaar.conf`` like this (say)::"
10343
#: en/help_topics/log-formats.txt:27
10346
" log_format = short"
10349
#: en/help_topics/log-formats.txt:30
10351
"Alternatively, to change the log format used for a given query, use the\n"
10352
"--long, --short or --line options."
10355
#: en/help_topics/log-formats.txt:33
10357
"If one of the standard log formats does not meet your needs, additional\n"
10358
"formats can be provided by plugins.\n"
10361
#: en/help_topics/other-formats.txt:1
10362
msgid "Other Storage Formats"
10365
#: en/help_topics/other-formats.txt:3
10366
msgid "No experimental formats are available."
10369
#: en/help_topics/other-formats.txt:5
10372
"No deprecated formats are available."
10375
#: en/help_topics/patterns.txt:1
10381
#: en/help_topics/patterns.txt:4
10383
"Bazaar uses patterns to match files at various times. For example,\n"
10384
"the ``add`` command skips over files that match ignore patterns\n"
10385
"and preferences can be associated with files using rule patterns.\n"
10386
"The pattern syntax is described below."
10389
#: en/help_topics/patterns.txt:9
10391
"Trailing slashes on patterns are ignored. If the pattern contains a\n"
10392
"slash or is a regular expression, it is compared to the whole path\n"
10393
"from the branch root. Otherwise, it is compared to only the last\n"
10394
"component of the path. To match a file only in the root directory,\n"
10395
"prepend ``./``. Patterns specifying absolute paths are not allowed."
10398
#: en/help_topics/patterns.txt:15
10399
msgid "Patterns may include globbing wildcards such as::"
10402
#: en/help_topics/patterns.txt:17
10404
" ? - Matches any single character except '/'\n"
10405
" * - Matches 0 or more characters except '/'\n"
10406
" /**/ - Matches 0 or more directories in a path\n"
10407
" [a-z] - Matches a single character from within a group of characters"
10410
#: en/help_topics/patterns.txt:22
10412
"Patterns may also be `Python regular expressions`_. Regular expression\n"
10413
"patterns are identified by a ``RE:`` prefix followed by the regular\n"
10414
"expression. Regular expression patterns may not include named or\n"
10418
#: en/help_topics/patterns.txt:27
10420
"Case insensitive ignore patterns can be specified with regular expressions\n"
10421
"by using the ``i`` (for ignore case) flag in the pattern."
10424
#: en/help_topics/patterns.txt:30
10425
msgid "For example, a case insensitive match for ``foo`` may be specified as::"
10428
#: en/help_topics/patterns.txt:32
10429
msgid " RE:(?i)foo"
10432
#: en/help_topics/patterns.txt:34
10434
"Ignore patterns may be prefixed with ``!``, which means that a filename\n"
10435
"matched by that pattern will not be ignored."
10438
#: en/help_topics/patterns.txt:37
10439
msgid ".. _Python regular expressions: http://docs.python.org/library/re.html"
10442
#: en/help_topics/revisionspec.txt:1
10443
msgid "Revision Identifiers"
10446
#: en/help_topics/revisionspec.txt:3
10448
"A revision identifier refers to a specific state of a branch's history. It\n"
10449
"can be expressed in several ways. It can begin with a keyword to\n"
10450
"unambiguously specify a given lookup type; some examples are 'last:1',\n"
10451
"'before:yesterday' and 'submit:'."
10454
#: en/help_topics/revisionspec.txt:8
10456
"Alternately, it can be given without a keyword, in which case it will be\n"
10457
"checked as a revision number, a tag, a revision id, a date specification, or "
10459
"branch specification, in that order. For example, 'date:today' could be\n"
10460
"written as simply 'today', though if you have a tag called 'today' that "
10465
#: en/help_topics/revisionspec.txt:14
10467
"If 'REV1' and 'REV2' are revision identifiers, then 'REV1..REV2' denotes a\n"
10468
"revision range. Examples: '3647..3649', 'date:yesterday..-1' and\n"
10469
"'branch:/path/to/branch1/..branch:/branch2' (note that there are no quotes "
10471
"spaces around the '..')."
10474
#: en/help_topics/revisionspec.txt:19
10476
"Ranges are interpreted differently by different commands. To the \"log\" "
10478
"a range is a sequence of log messages, but to the \"diff\" command, the "
10480
"denotes a change between revisions (and not a sequence of changes). In\n"
10481
"addition, \"log\" considers a closed range whereas \"diff\" and \"merge\" "
10483
"to be open-ended, that is, they include one end but not the other. For "
10485
"\"bzr log -r 3647..3649\" shows the messages of revisions 3647, 3648 and "
10487
"while \"bzr diff -r 3647..3649\" includes the changes done in revisions 3648 "
10489
"3649, but not 3647."
10492
#: en/help_topics/revisionspec.txt:28
10493
msgid "The keywords used as revision selection methods are the following:"
10496
#: en/help_topics/revisionspec.txt:30
10499
"\tSelects a revision using the revision id.\n"
10501
"\tSelects a common ancestor with the submit branch.\n"
10503
"\tSelects a common ancestor with a second branch.\n"
10505
"\tSelects a revision on the basis of a datestamp.\n"
10507
"\tSelects the last revision of a specified branch.\n"
10509
"\tSelects a revision identified by a tag name.\n"
10511
"\tSelects the revision corresponding to a version of a package.\n"
10513
"\tSelects a revision using a number.\n"
10515
"\tSelects the parent of the revision specified.\n"
10517
"\tSelect the revision that last modified the specified line.\n"
10519
"\tSelect mainline revision that merged the specified revision.\n"
10521
"\tSelects the nth revision from the end."
10524
#: en/help_topics/revisionspec.txt:55
10525
msgid "In addition, plugins can provide other keywords."
10528
#: en/help_topics/revisionspec.txt:57
10529
msgid "A detailed description of each keyword is given below."
10532
#: en/help_topics/revisionspec.txt:59
10536
#: en/help_topics/revisionspec.txt:61
10538
" Supply a specific revision id, that can be used to specify any\n"
10539
" revision id in the ancestry of the branch.\n"
10540
" Including merges, and pending merges.\n"
10544
#: en/help_topics/revisionspec.txt:66
10546
" revid:aaaa@bbbb-123456789 -> Select revision 'aaaa@bbbb-123456789'"
10549
#: en/help_topics/revisionspec.txt:68
10553
#: en/help_topics/revisionspec.txt:70
10555
" Diffing against this shows all the changes that were made in this "
10557
" and is a good predictor of what merge will do. The submit branch is\n"
10558
" used by the bundle and merge directive commands. If no submit branch\n"
10559
" is specified, the parent branch is used instead."
10562
#: en/help_topics/revisionspec.txt:75
10564
" The common ancestor is the last revision that existed in both\n"
10565
" branches. Usually this is the branch point, but it could also be\n"
10566
" a revision that was merged."
10569
#: en/help_topics/revisionspec.txt:79
10570
msgid " Examples::"
10573
#: en/help_topics/revisionspec.txt:81
10574
msgid " $ bzr diff -r submit:"
10577
#: en/help_topics/revisionspec.txt:83
10581
#: en/help_topics/revisionspec.txt:85
10582
msgid " Supply the path to a branch to select the common ancestor."
10585
#: en/help_topics/revisionspec.txt:91
10587
" This is frequently used with 'diff' to return all of the changes\n"
10588
" that your branch introduces, while excluding the changes that you\n"
10589
" have not merged from the remote branch."
10592
#: en/help_topics/revisionspec.txt:97
10594
" ancestor:/path/to/branch\n"
10595
" $ bzr diff -r ancestor:../../mainline/branch"
10598
#: en/help_topics/revisionspec.txt:100
10602
#: en/help_topics/revisionspec.txt:102
10604
" Supply a datestamp to select the first revision that matches the date.\n"
10605
" Date can be 'yesterday', 'today', 'tomorrow' or a YYYY-MM-DD string.\n"
10606
" Matches the first entry after a given date (either at midnight or\n"
10607
" at a specified time)."
10610
#: en/help_topics/revisionspec.txt:107
10611
msgid " One way to display all the changes since yesterday would be::"
10614
#: en/help_topics/revisionspec.txt:109
10615
msgid " bzr log -r date:yesterday.."
10618
#: en/help_topics/revisionspec.txt:113
10620
" date:yesterday -> select the first revision since "
10622
" date:2006-08-14,17:10:14 -> select the first revision after\n"
10623
" August 14th, 2006 at 5:10pm."
10626
#: en/help_topics/revisionspec.txt:117
10630
#: en/help_topics/revisionspec.txt:119
10631
msgid " Supply the path to a branch to select its last revision."
10634
#: en/help_topics/revisionspec.txt:123
10635
msgid " branch:/path/to/branch"
10638
#: en/help_topics/revisionspec.txt:125
10642
#: en/help_topics/revisionspec.txt:127
10643
msgid " Tags are stored in the branch and created by the 'tag' command."
10646
#: en/help_topics/revisionspec.txt:129
10650
#: en/help_topics/revisionspec.txt:131
10652
" Given a package version number this revision specifier will allow you\n"
10653
" specify the revision corresponding to the upload of that version of\n"
10657
#: en/help_topics/revisionspec.txt:135
10661
#: en/help_topics/revisionspec.txt:137
10663
" Use an integer to specify a revision in the history of the branch.\n"
10664
" Optionally a branch can be specified. A negative number will count\n"
10665
" from the end of the branch (-1 is the last revision, -2 the previous\n"
10666
" one). If the negative number is larger than the branch's history, the\n"
10667
" first revision is returned.\n"
10671
#: en/help_topics/revisionspec.txt:144
10673
" revno:1 -> return the first revision of this branch\n"
10674
" revno:3:/path/to/branch -> return the 3rd revision of\n"
10675
" the branch '/path/to/branch'\n"
10676
" revno:-1 -> The last revision in a branch.\n"
10677
" -2:http://other/branch -> The second to last revision in the\n"
10678
" remote branch.\n"
10679
" -1000000 -> Most likely the first revision, unless\n"
10680
" your history is very long."
10683
#: en/help_topics/revisionspec.txt:153
10687
#: en/help_topics/revisionspec.txt:155
10689
" Supply any revision spec to return the parent of that revision. This "
10691
" mostly useful when inspecting revisions that are not in the revision "
10696
#: en/help_topics/revisionspec.txt:159
10698
" It is an error to request the parent of the null revision (before:0)."
10701
#: en/help_topics/revisionspec.txt:163
10703
" before:1913 -> Return the parent of revno 1913 (revno 1912)\n"
10704
" before:revid:aaaa@bbbb-1234567890 -> return the parent of revision\n"
10705
" aaaa@bbbb-1234567890\n"
10706
" bzr diff -r before:1913..1913\n"
10707
" -> Find the changes between revision 1913 and its parent "
10709
" (What changes did revision 1913 introduce).\n"
10710
" This is equivalent to: bzr diff -c 1913"
10713
#: en/help_topics/revisionspec.txt:171
10717
#: en/help_topics/revisionspec.txt:173
10719
" Select the revision that last modified the specified line. Line is\n"
10720
" specified as path:number. Path is a relative path to the file. "
10722
" start at 1, and are relative to the current version, not the last-\n"
10723
" committed version of the file."
10726
#: en/help_topics/revisionspec.txt:178
10730
#: en/help_topics/revisionspec.txt:180
10732
" Select the revision that merged the specified revision into mainline."
10735
#: en/help_topics/revisionspec.txt:182
10739
#: en/help_topics/revisionspec.txt:184
10741
" Supply a positive number to get the nth revision from the end.\n"
10742
" This is the same as supplying negative numbers to the 'revno:' spec.\n"
10746
#: en/help_topics/revisionspec.txt:188
10748
" last:1 -> return the last revision\n"
10749
" last:3 -> return the revision 2 before the end.\n"
10752
#: en/help_topics/rules.txt:1
10758
#: en/help_topics/rules.txt:7
10760
"Rules are defined in ini file format where the sections are file glob\n"
10761
"patterns and the contents of each section are the preferences for files\n"
10762
"matching that pattern(s). For example::"
10765
#: en/help_topics/rules.txt:11
10771
#: en/help_topics/rules.txt:14
10773
" [name *.html *.xml]\n"
10774
" keywords = xml_escape"
10777
#: en/help_topics/rules.txt:17
10779
"Preferences like these are useful for commands and plugins wishing to\n"
10780
"provide custom behaviour for selected files. For more information on \n"
10781
"end of line conversion see :doc:`eol-help`.\n"
10782
"Keyword support is provided by the `keywords plugin\n"
10783
"<http://doc.bazaar.canonical.com/plugins/en/keywords-plugin.html>`_."
10786
#: en/help_topics/rules.txt:23
10792
#: en/help_topics/rules.txt:26
10794
"Default rules for all branches are defined in the optional file\n"
10795
"``BZR_HOME/rules``. "
10798
#: en/help_topics/rules.txt:29
10804
#: en/help_topics/rules.txt:32
10806
"Patterns are ordered and searching stops as soon as one matches.\n"
10807
"As a consequence, more explicit patterns should be placed towards\n"
10808
"the top of the file. Rule patterns use exactly the same conventions\n"
10809
"as ignore patterns. See :doc:`patterns-help` for details."
10812
#: en/help_topics/rules.txt:37
10816
#: en/help_topics/rules.txt:39
10818
" Patterns containing square brackets or spaces should be\n"
10819
" surrounded in quotes to ensure they are correctly parsed.\n"
10822
#: en/help_topics/topics.txt:1
10824
"authentication Information on configuring authentication\n"
10825
"basic Basic commands\n"
10826
"branches Information on what a branch is\n"
10827
"bugs Bug tracker settings\n"
10828
"checkouts Information on what a checkout is\n"
10829
"commands Basic help for all commands\n"
10830
"configuration Details on the configuration settings available\n"
10831
"conflict-types Types of conflicts and what to do about them\n"
10832
"content-filters Conversion of content into/from working trees\n"
10833
"criss-cross Information on criss-cross merging\n"
10834
"current-formats Current storage formats\n"
10835
"debug-flags Options to show or record debug information\n"
10836
"diverged-branches How to fix diverged branches\n"
10837
"env-variables Environment variable names and values\n"
10838
"eol Information on end-of-line handling\n"
10839
"files Information on configuration and log files\n"
10840
"formats Information on choosing a storage format\n"
10841
"global-options Options that control how Bazaar runs\n"
10842
"hidden-commands All hidden commands\n"
10843
"hooks Points at which custom processing can be added\n"
10844
"launchpad Using Bazaar with Launchpad.net\n"
10845
"location-alias Aliases for remembered locations\n"
10846
"log-formats Details on the logging formats available\n"
10847
"other-formats Experimental and deprecated storage formats\n"
10848
"patterns Information on the pattern syntax\n"
10849
"repositories Basic information on shared repositories.\n"
10850
"revisionspec Explain how to use --revision\n"
10851
"rules Information on defining rule-based preferences\n"
10852
"standalone-trees Information on what a standalone tree is\n"
10853
"standard-options Options that can be used with any command\n"
10854
"status-flags Help on status flags\n"
10855
"sync-for-reconfigure Steps to resolve \"out-of-sync\" when reconfiguring\n"
10856
"topics Topics list\n"
10857
"url-special-chars Special character handling in URLs\n"
10858
"urlspec Supported transport protocols\n"
10859
"working-trees Information on working trees\n"
10862
#: en/help_topics/url-special-chars.txt:1
10864
"Special character handling in URLs\n"
10865
"=================================="
10868
#: en/help_topics/url-special-chars.txt:4
10869
msgid "Bazaar allows locations to be specified in multiple ways, either:"
10872
#: en/help_topics/url-special-chars.txt:6
10873
msgid " * Fully qualified URLs"
10876
#: en/help_topics/url-special-chars.txt:8
10877
msgid " * File system paths, relative or absolute"
10880
#: en/help_topics/url-special-chars.txt:10
10882
"Internally bzr treats all locations as URLs. For any file system paths\n"
10883
"that are specified it will automatically determine the appropriate URL\n"
10884
"representation, and escape special characters where necessary."
10887
#: en/help_topics/url-special-chars.txt:14
10889
"There are a few characters which have special meaning in URLs and need "
10891
"handling to avoid ambiguities. Characters can be escaped with a % and a hex\n"
10892
"value in URLs. Any non-ASCII characters in a file path will automatically "
10894
"urlencoded when the path is converted to a URL."
10897
#: en/help_topics/url-special-chars.txt:19
10899
"URLs represent non-ASCII characters in an encoding defined by the server, "
10901
"usually UTF-8. The % escapes should be of the UTF-8 bytes. Bazaar tries to "
10903
"generous in what it accepts as a URL and to print them in a way that\n"
10904
"will be readable."
10907
#: en/help_topics/url-special-chars.txt:24
10909
"For example, if you have a directory named '/tmp/%2False' these are all "
10911
"ways of accessing the content (0x2F, or 47, is the ASCII code for forward "
10915
#: en/help_topics/url-special-chars.txt:27
10918
" bzr log /tmp/%2False\n"
10919
" bzr log %2False\n"
10920
" bzr log file:///tmp/%252False\n"
10921
" bzr log file://localhost/tmp/%252False\n"
10922
" bzr log file:%252False"
10925
#: en/help_topics/url-special-chars.txt:34
10926
msgid "These are valid but do not refer to the same file::"
10929
#: en/help_topics/url-special-chars.txt:36
10931
" bzr log file:///tmp/%2False (refers to a file called /tmp/\\/alse)\n"
10932
" bzr log %252False (refers to a file called /tmp/%252False)"
10935
#: en/help_topics/url-special-chars.txt:39
10937
"Comma also has special meaning in URLs, because it denotes `segment "
10941
#: en/help_topics/url-special-chars.txt:41
10943
"_`segment parameters`: http://www.ietf.org/rfc/rfc3986.txt (section 3.3)"
10946
#: en/help_topics/url-special-chars.txt:43
10948
"Comma is also special in any file system paths that are specified. To use a "
10950
"comma in a file system path, specify a URL and URL encode the comma::"
10953
#: en/help_topics/url-special-chars.txt:46
10955
" bzr log foo,branch=bla # path \"foo\" with the segment parameter \"branch"
10956
"\" set to \"bla\"\n"
10957
" bzr log file:foo%2Cbranch=bla # path \"foo,branch=bla\"\n"
10958
" bzr log file:foo,branch=bla # path \"foo\" with segment parameter \"branch"
10959
"\" set to \"bla\"\n"
10962
#: en/help_topics/urlspec.txt:1
10963
msgid "URL Identifiers"
10966
#: en/help_topics/urlspec.txt:3
10967
msgid "Supported URL prefixes::"
10970
#: en/help_topics/urlspec.txt:5
10972
" aftp:// Access using active FTP.\n"
10973
" bzr:// Fast access using the Bazaar smart server.\n"
10974
" bzr+ssh:// Fast access using the Bazaar smart server over SSH.\n"
10975
" file:// Access using the standard filesystem (default)\n"
10976
" ftp:// Access using passive FTP.\n"
10977
" http:// Read-only access of branches exported on the web.\n"
10978
" https:// Read-only access of branches exported on the web using "
10980
" sftp:// Access using SFTP (most SSH servers provide SFTP)."
10983
#: en/help_topics/urlspec.txt:14
10984
msgid "Supported modifiers::"
10987
#: en/help_topics/urlspec.txt:16
10988
msgid " gio+ Access using any GIO supported protocols."
10991
#: en/help_topics/urlspec.txt:18
10992
msgid "Bazaar supports all of the standard parts within the URL::"
10995
#: en/help_topics/urlspec.txt:20
10996
msgid " <protocol>://[user[:password]@]host[:port]/[path]"
10999
#: en/help_topics/urlspec.txt:22
11000
msgid "allowing URLs such as::"
11003
#: en/help_topics/urlspec.txt:24
11004
msgid " http://bzruser:BadPass@bzr.example.com:8080/bzr/trunk"
11007
#: en/help_topics/urlspec.txt:26
11009
"For bzr+ssh:// and sftp:// URLs, Bazaar also supports paths that begin\n"
11010
"with '~' as meaning that the rest of the path should be interpreted\n"
11011
"relative to the remote user's home directory. For example if the user\n"
11012
"``remote`` has a home directory of ``/home/remote`` on the server\n"
11013
"shell.example.com, then::"
11016
#: en/help_topics/urlspec.txt:32
11017
msgid " bzr+ssh://remote@shell.example.com/~/myproject/trunk"
11020
#: en/help_topics/urlspec.txt:34
11021
msgid "would refer to ``/home/remote/myproject/trunk``."
11024
#: en/help_topics/urlspec.txt:36
11026
"Many commands that accept URLs also accept location aliases too.\n"
11027
"See :doc:`location-alias-help` and :doc:`url-special-chars-help`.\n"