~garyvdm/bzr-upload/ignore_build

« back to all changes in this revision

Viewing changes to README

  • Committer: Vincent Ladeuil
  • Date: 2009-09-02 22:31:06 UTC
  • Revision ID: v.ladeuil+lp@free.fr-20090902223106-u93g8rhrh3fexczr
Fix bug #423331 by adding a way to configure the path used to
store the revid.

* tests/test_upload.py:
(TestUploadMixin.test_upload_revid_path_in_dir): Smoke test that
we can force a different path.
(TestFullUpload.test_full_upload_empty_tree,
TestIncrementalUpload.test_upload_for_the_first_time_do_a_full_upload):
Update references to the revid path.

* __init__.py:
(get_upload_revid_location, set_upload_revid_location): New config
variable.
(BzrUploader.set_uploaded_revid, BzrUploader.get_uploaded_revid):
Use the config variable defining the path.

* README: 
Document the .bzr-upload.revid file and upload_revid_location
configuration variable.

Show diffs side-by-side

added added

removed removed

Lines of Context:
28
28
    bzr upload sftp://user@host/location/on/webserver
29
29
 
30
30
This will initially upload the whole working tree, and leave a file on the
31
 
remote location indicating the last revision that was uploaded, in order to 
32
 
avoid uploading unnecessary information the next time.
 
31
remote location indicating the last revision that was uploaded
 
32
(.bzr-upload.revid), in order to avoid uploading unnecessary information
 
33
the next time.
33
34
 
34
35
If you would like to upload a specific revision, you just do:
35
36
 
43
44
    bzr upload --full sftp://user@host/location/on/webserver
44
45
 
45
46
 
 
47
If the layout of your remote server is such that you can't write in the
 
48
root directory but only in the directories inside that root, you will need
 
49
to use the 'upload_revid_location' configuration variable to specify the
 
50
relative path to be used. That configuration variable can be specified in
 
51
locations.conf or branch.conf.
 
52
 
 
53
For example, given the following layout:
 
54
 
 
55
  Project/
 
56
    private/
 
57
    public/
 
58
 
 
59
you may have write access in 'private' and 'public' but in 'Project'
 
60
itself. In that case, you can add the following in your locations.conf or
 
61
branch.conf file:
 
62
 
 
63
  upload_revid_location = private/.bzr-upload.revid
 
64
 
 
65
 
46
66
Automatically Uploading
47
67
-----------------------
48
68