[Bps-public-commit] SD branch, master, updated. d3f6758b9c0807b726b1572adc2c319b3be08c91

[spang at bestpractical.com]

The branch, master has been updated
       via  d3f6758b9c0807b726b1572adc2c319b3be08c91 (commit)
       via  d9f6fd26209c76c3da5dc527301c6ec7b6e60568 (commit)
      from  c92489b0302829cb4efbfb5e8622a01428b7412a (commit)

Summary of changes:
 lib/App/SD/CLI/Command/Help/Sync.pm |   20 ++++++++++++++++++++
 1 files changed, 20 insertions(+), 0 deletions(-)

- Log -----------------------------------------------------------------
commit d9f6fd26209c76c3da5dc527301c6ec7b6e60568
Author: Christine Spang <spang at bestpractical.com>
Date:   Thu Jul 16 22:57:15 2009 +0100

    some doc for friendly names

diff --git a/lib/App/SD/CLI/Command/Help/Sync.pm b/lib/App/SD/CLI/Command/Help/Sync.pm
index 67c1d6a..68c279a 100644
--- a/lib/App/SD/CLI/Command/Help/Sync.pm
+++ b/lib/App/SD/CLI/Command/Help/Sync.pm
@@ -89,6 +89,26 @@ The RT server is specified as as rt:serveraddress|Queue|Query
 
     ${cmd}clone --from github:miyagawa/remedie
 
+SD also supports naming replicas, so you can push, pull, and publish
+to short, human-friendly names instead of URLs. When a replica is
+initialized, cloned, or published, a [replica "name"] section is created in
+the replica-specific configuration file (replica_root/config). Its name is, by
+default, the URL you passed to the command. You can change this to a more
+memorable name with:
+
+    ${cmd}config edit
+
+You can then use sync commands like this:
+
+    ${cmd}pull --from name
+    ${cmd}push --to name
+    ${cmd}publish --to name
+
+For pull and push, the given name is substituted with the value of the
+replica.name.url config variable. For publish, replica.name.publish-url
+is used. If different urls are needed for push and pull for a given
+replica, you can override replica.name.url with replica.name.push-url
+and/or replica.name.pull-url.
 
 EOF
 

commit d3f6758b9c0807b726b1572adc2c319b3be08c91
Merge: d9f6fd2... c92489b...
Author: Christine Spang <spang at bestpractical.com>
Date:   Thu Jul 16 22:57:54 2009 +0100

    Merge branch 'master' of code.bestpractical.com:/git/sd


-----------------------------------------------------------------------