From dc573554c82617a87c1737fc80d9da0d4dddb0f8 Mon Sep 17 00:00:00 2001
From: Brian Warner <warner@lothar.com>
Date: Thu, 11 Oct 2007 03:38:24 -0700
Subject: [PATCH] rename bin/allmydata-tahoe to bin/tahoe. Closes #155.

---
 Makefile                          |  9 +++--
 README                            | 62 +++++++++++++++----------------
 Tahoe.home                        |  3 +-
 bin/{allmydata-tahoe => tahoe}    |  0
 docs/configuration.txt            |  4 +-
 misc/feisty/debian/rules          |  8 ++--
 misc/sid/debian/rules             |  8 ++--
 setup.py                          |  2 +-
 src/allmydata/test/test_runner.py |  2 +-
 9 files changed, 50 insertions(+), 48 deletions(-)
 rename bin/{allmydata-tahoe => tahoe} (100%)

diff --git a/Makefile b/Makefile
index 78113636..b28f8d02 100644
--- a/Makefile
+++ b/Makefile
@@ -78,6 +78,9 @@ endif
 PP=PYTHONPATH="$(SRCPATH)$(PATHSEP)$(EGGSPATH)$(PATHSEP)$(PYTHONPATH)"
 
 .PHONY: make-version build
+# N.B.: the first argument to make-version.py is used to find darcs tags that
+# represent released versions, so it needs to match whatever release
+# conventions are in use.
 make-version:
 	$(PYTHON) misc/make-version.py "allmydata-tahoe" "src/allmydata/_version.py"
 
@@ -87,7 +90,7 @@ make-version:
 
 build: 
 	$(PYTHON) ./setup.py build_ext -i
-	chmod +x bin/allmydata-tahoe
+	chmod +x bin/tahoe
 
 # 'make install' will do the following:
 #   build+install tahoe (probably to /usr/lib/pythonN.N/site-packages)
@@ -239,10 +242,10 @@ check-memory-once: .built
 
 check-speed: .built
 	if [ -z '$(TESTCLIENTDIR)' ]; then exit 1; fi
-	$(PYTHON) bin/allmydata-tahoe start $(TESTCLIENTDIR)
+	$(PYTHON) bin/tahoe start $(TESTCLIENTDIR)
 	sleep 5
 	$(PYTHON) src/allmydata/test/check_speed.py $(TESTCLIENTDIR)
-	$(PYTHON) bin/allmydata-tahoe stop $(TESTCLIENTDIR)
+	$(PYTHON) bin/tahoe stop $(TESTCLIENTDIR)
 
 test-darcs-boringfile:
 	$(MAKE)
diff --git a/README b/README
index 4bb568e9..22a7b335 100644
--- a/README
+++ b/README
@@ -180,11 +180,11 @@ Running-In-Place Way, and The Debian Way.  Choose one:
 
   3. Build Tahoe by running "make".
 
-  4. Once you've built it then you can execute "./bin/allmydata-tahoe". (When
-     the allmydata-tahoe script is in a Tahoe source distribution, it adds
-     the necessary directory to the Python "sys.path".  It also looks for any
-     dependencies that you installed by "make build-deps" and includes them
-     in the sys.path.)  See the RUNNING section, below.
+  4. Once you've built it then you can execute "./bin/tahoe". (When the tahoe
+     script is in a Tahoe source distribution, it adds the necessary
+     directory to the Python "sys.path". It also looks for any dependencies
+     that you installed by "make build-deps" and includes them in the
+     sys.path.) See the RUNNING section, below.
 
  The Debian Way:
 
@@ -215,15 +215,15 @@ TESTING THAT IT IS PROPERLY INSTALLED
  slow computers.  There are a lot of tests and some of them do a lot of
  public-key cryptography.)
 
- Executing the allmydata-tahoe script from the "bin" subdirectory will work
- only if Tahoe itself is installed, either because it is installed into the
- local subdirectory (as per "The Running-In-Place Way") or because it is
- installed into your system (as per the other three ways of installing).
+ Executing the tahoe script from the "bin" subdirectory will work only if
+ Tahoe itself is installed, either because it is installed into the local
+ subdirectory (as per "The Running-In-Place Way") or because it is installed
+ into your system (as per the other three ways of installing).
 
 
 RUNNING:
 
- Run the "allmydata-tahoe" executable.
+ Run the "tahoe" executable.
 
  If you installed "The Running-In-Place Way", then it is in your source tree,
  in the "bin" subdirectory thereof.  If you installed in one of the other
@@ -231,10 +231,10 @@ RUNNING:
  filesystem, perhaps in "/usr/bin" on Unix, or in "C:\Python25\Scripts" on
  Window.
 
- The "allmydata-tahoe" utility is used to create, start, and stop nodes.
- Each node lives in a separate base directory, inside of which you can add
- files to configure and control the node.  Nodes also read and write files
- within that directory.
+ The "tahoe" utility is used to create, start, and stop nodes. Each node
+ lives in a separate base directory, inside of which you can add files to
+ configure and control the node. Nodes also read and write files within that
+ directory.
 
  A grid consists of a single central 'introducer and vdrive' node and one or
  more 'client' nodes.  If you are joining an existing grid, the
@@ -243,28 +243,28 @@ RUNNING:
  create both an introducer-and-vdrive and a client (and then invite other
  people to create their own client nodes and join your grid).
 
- The introducer (-and-vdrive) node is constructed by running 'allmydata-tahoe
- create-introducer --basedir $HERE'.  Once constructed, you can start the
- introducer by running 'allmydata-tahoe start --basedir $HERE' (or, if you
- are already in the introducer's base directory, just type 'allmydata-tahoe
- start').  Inside that base directory, there will be a pair of files
- 'introducer.furl' and 'vdrive.furl'.  Make a copy of these, as they'll be
- needed on the client nodes.
+ The introducer (-and-vdrive) node is constructed by running 'tahoe
+ create-introducer --basedir $HERE'. Once constructed, you can start the
+ introducer by running 'tahoe start --basedir $HERE' (or, if you are already
+ in the introducer's base directory, just type 'tahoe start'). Inside that
+ base directory, there will be a pair of files 'introducer.furl' and
+ 'vdrive.furl'. Make a copy of these, as they'll be needed on the client
+ nodes.
 
  To construct a client node, pick a new working directory for it, then run
- 'allmydata-tahoe create-client --basedir $HERE'.  Copy the two .furl files
- from the introducer into this new directory, then run 'allmydata-tahoe start
- --basedir $HERE'.  After that, the client node should be off and running.
- The first thing it will do is connect to the introducer and introduce itself
- to all other nodes on the grid.  You can follow its progress by looking at
- the $HERE/logs/twistd.log file.
+ 'tahoe create-client --basedir $HERE'. Copy the two .furl files from the
+ introducer into this new directory, then run 'tahoe start --basedir $HERE'.
+ After that, the client node should be off and running. The first thing it
+ will do is connect to the introducer and introduce itself to all other nodes
+ on the grid. You can follow its progress by looking at the
+ $HERE/logs/twistd.log file.
 
  To actually use the client, enable the web interface by writing a port
  number (like "8123") into a file named $HERE/webport and then restarting the
- node with 'allmydata-tahoe restart --basedir $HERE'. This will prompt the
- client node to run a webserver on the desired port, through which you can
- view, upload, download, and delete files. This 'webport' file is actually a
- "strports specification", defined in
+ node with 'tahoe restart --basedir $HERE'. This will prompt the client node
+ to run a webserver on the desired port, through which you can view, upload,
+ download, and delete files. This 'webport' file is actually a "strports
+ specification", defined in
  http://twistedmatrix.com/documents/current/api/twisted.application.strports.html
  , so you can have it only listen on a local interface by writing
  "tcp:8123:interface=127.0.0.1" to this file, or make it use SSL by writing
diff --git a/Tahoe.home b/Tahoe.home
index f3f4dca7..7b4a6e5f 100644
--- a/Tahoe.home
+++ b/Tahoe.home
@@ -1,2 +1 @@
-This file exists so the preamble in bin/allmydata-tahoe can find its source
-tree.
+This file exists so the preamble in bin/tahoe can find its source tree.
diff --git a/bin/allmydata-tahoe b/bin/tahoe
similarity index 100%
rename from bin/allmydata-tahoe
rename to bin/tahoe
diff --git a/docs/configuration.txt b/docs/configuration.txt
index afa54fde..9e329ce8 100644
--- a/docs/configuration.txt
+++ b/docs/configuration.txt
@@ -79,8 +79,8 @@ held while they are being received.
 client.tac : this file defines the client, by constructing the actual Client
 instance each time the node is started. It is used by the 'twistd'
 daemonization program (in the "-y" mode), which is run internally by the
-"allmydata-tahoe start" command. This file is created by the "allmydata-tahoe
-create-client" command.
+"tahoe start" command. This file is created by the "tahoe create-client"
+command.
 
 control.furl : this file contains a FURL that provides access to a control
 port on the client node, from which files can be uploaded and downloaded.
diff --git a/misc/feisty/debian/rules b/misc/feisty/debian/rules
index 3d669dae..a7a6d118 100644
--- a/misc/feisty/debian/rules
+++ b/misc/feisty/debian/rules
@@ -9,9 +9,9 @@ include /usr/share/cdbs/1/class/python-distutils.mk
 
 STAGING_DIR=$(CURDIR)/debian/allmydata-tahoe
 
-# we overwrite the setuptools-generated /usr/bin/allmydata-tahoe with our
-# package's original version, because the setuptools form (using "entry
-# points") insists upon .egg-info -visible forms of dependent packages to be
+# we overwrite the setuptools-generated /usr/bin/tahoe with our package's
+# original version, because the setuptools form (using "entry points")
+# insists upon .egg-info -visible forms of dependent packages to be
 # installed. For a debian package, we rely upon the dependencies that are
 # declared in debian/control .
 #
@@ -23,7 +23,7 @@ STAGING_DIR=$(CURDIR)/debian/allmydata-tahoe
 install/allmydata-tahoe::
 	mkdir -pm755 $(STAGING_DIR)
 	python setup.py install --root=$(STAGING_DIR)
-	cp bin/allmydata-tahoe $(STAGING_DIR)/usr/bin/
+	cp bin/tahoe $(STAGING_DIR)/usr/bin/
 
 	dh_pycentral
 
diff --git a/misc/sid/debian/rules b/misc/sid/debian/rules
index 3d669dae..a7a6d118 100644
--- a/misc/sid/debian/rules
+++ b/misc/sid/debian/rules
@@ -9,9 +9,9 @@ include /usr/share/cdbs/1/class/python-distutils.mk
 
 STAGING_DIR=$(CURDIR)/debian/allmydata-tahoe
 
-# we overwrite the setuptools-generated /usr/bin/allmydata-tahoe with our
-# package's original version, because the setuptools form (using "entry
-# points") insists upon .egg-info -visible forms of dependent packages to be
+# we overwrite the setuptools-generated /usr/bin/tahoe with our package's
+# original version, because the setuptools form (using "entry points")
+# insists upon .egg-info -visible forms of dependent packages to be
 # installed. For a debian package, we rely upon the dependencies that are
 # declared in debian/control .
 #
@@ -23,7 +23,7 @@ STAGING_DIR=$(CURDIR)/debian/allmydata-tahoe
 install/allmydata-tahoe::
 	mkdir -pm755 $(STAGING_DIR)
 	python setup.py install --root=$(STAGING_DIR)
-	cp bin/allmydata-tahoe $(STAGING_DIR)/usr/bin/
+	cp bin/tahoe $(STAGING_DIR)/usr/bin/
 
 	dh_pycentral
 
diff --git a/setup.py b/setup.py
index 27ba5aa8..f33150e8 100644
--- a/setup.py
+++ b/setup.py
@@ -118,7 +118,7 @@ setup(name='allmydata-tahoe',
       test_suite="allmydata.test",
       install_requires=install_requires,
       dependency_links=dependency_links,
-      entry_points = { 'console_scripts': [ 'allmydata-tahoe = allmydata.scripts.runner:run' ] },
+      entry_points = { 'console_scripts': [ 'tahoe = allmydata.scripts.runner:run' ] },
       ext_modules=[
           Extension("allmydata.Crypto.Cipher.AES",
                     include_dirs=["src/allmydata/Crypto"],
diff --git a/src/allmydata/test/test_runner.py b/src/allmydata/test/test_runner.py
index c21d6266..80ef42c1 100644
--- a/src/allmydata/test/test_runner.py
+++ b/src/allmydata/test/test_runner.py
@@ -172,7 +172,7 @@ class RunNode(unittest.TestCase, testutil.PollMixin):
 
         # now we can kill it. TODO: On a slow machine, the node might kill
         # itself before we get a chance too, especially if spawning the
-        # 'allmydata-tahoe stop' command takes a while.
+        # 'tahoe stop' command takes a while.
         def _stop(res):
             open(HOTLINE_FILE, "w").write("")
             self.failUnless(os.path.exists(TWISTD_PID_FILE))
-- 
2.45.2