~ubuntu-branches/ubuntu/lucid/bzr/lucid-proposed

« back to all changes in this revision

Viewing changes to doc/optional-edit.txt

  • Committer: Bazaar Package Importer
  • Author(s): Jeff Bailey
  • Date: 2006-03-20 08:31:00 UTC
  • mfrom: (1.1.2 upstream)
  • mto: This revision was merged to the branch mainline in revision 4.
  • Revision ID: james.westby@ubuntu.com-20060320083100-ovdi2ssuw0epcx8s
Tags: 0.8~200603200831-0ubuntu1
* Snapshot uploaded to Dapper at Martin Pool's request.

* Disable testsuite for upload.  Fakeroot and the testsuite don't
  play along.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
******************************
2
 
Optional explicit edit command
3
 
******************************
4
 
 
5
 
The default is for each branch to have an editable working copy, which
6
 
can be modified and committed.  However, in some cases (following RCS
7
 
and BK) people might prefer to have either a read-only working copy,
8
 
or none at all.
9
 
 
10
 
Reasons:
11
 
 
12
 
 - Branches which are never edited don't need it; removing it saves
13
 
   some time and space.  In particular this applies to branches on a
14
 
   server which are meant to be branched from or committed too, not
15
 
   edited.
16
 
 
17
 
 - Files for which there is no working copy or a read-only copy are
18
 
   known not to be edited, and this can make some operations such as
19
 
   diffing a bit simpler.
20
 
 
21
 
Since this is mostly an optimization and requires user knowledge it
22
 
perhaps should not be added.  Certainly not yet.
23
 
 
24
 
Sketch::
25
 
 
26
 
  $ bzr get --no-wc SOURCE TARGET
27
 
  $ bzr edit --remove
28
 
  $ bzr edit --read-only .
29
 
  $ bzr edit --write foo.c
30