Remove all installation talk from docbook
authorPaul Crowley <paul@lshift.net>
Tue, 10 Nov 2009 11:04:06 +0000
changeset 185 f8f8b4018381
parent 184 ec3047e1dadc
child 186 4fa13d8412c1
child 194 b1ddf7ced7e7
Remove all installation talk from docbook
README
doc/manual.docbook
--- a/README	Tue Nov 10 11:03:21 2009 +0000
+++ b/README	Tue Nov 10 11:04:06 2009 +0000
@@ -1,6 +1,8 @@
 mercurial-server
 
-mercurial-server gives your developers remote read/write access to centralized Mercurial repositories using SSH public key authentication; it provides convenient and fine-grained key management and access control. 
+mercurial-server gives your developers remote read/write access to
+centralized Mercurial repositories using SSH public key authentication; it
+provides convenient and fine-grained key management and access control. 
 
 http://www.lshift.net/mercurial-server.html
 
@@ -20,9 +22,15 @@
     with this program; if not, write to the Free Software Foundation, Inc.,
     51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 
-Though mercurial-server is currently targeted at Debian-based systems such as Ubuntu, other users have reported success getting it running on other Unix-based systems such as Red Hat. Running it on a non-Unix system such as Windows is not supported. You will need root privileges to install it. 
+Though mercurial-server is currently targeted at Debian-based systems such
+as Ubuntu, other users have reported success getting it running on other
+Unix-based systems such as Red Hat. Running it on a non-Unix system such as
+Windows is not supported. You will need root privileges to install it. 
 
-The best way to install mercurial-server is using your package management system.  However, there is some provision for installing it directly.  On Debian based systems such as Ubuntu, use the command
+The best way to install mercurial-server is using your package management
+system - there are pre-built .deb files on the website. However, there is
+some provision for installing it directly. On Debian based systems such as
+Ubuntu, use the command
 
     sudo make setup-adduser
 
--- a/doc/manual.docbook	Tue Nov 10 11:03:21 2009 +0000
+++ b/doc/manual.docbook	Tue Nov 10 11:04:06 2009 +0000
@@ -38,31 +38,17 @@
 Key Authentication tutorial</link> may be helpful.
 </para>
 <section>
-<title>Installing mercurial-server</title>
+<title>Initial access to mercurial-server</title>
 <para>
 In what follows, we assume that your username is <systemitem
 class="username">jay</systemitem>, that you usually sit at a machine called
-<systemitem class="systemname">spoon</systemitem> and you wish to
-install mercurial-server on <systemitem
-class="systemname">jeeves</systemitem>. We assume that you have created your SSH public key, set up your SSH agent with this key, and that this key gives you access to <systemitem
+<systemitem class="systemname">spoon</systemitem> and you have
+installed mercurial-server on <systemitem
+class="systemname">jeeves</systemitem> using the package management system (see the README for more on installation). We assume that you have created your SSH public key, set up your SSH agent with this key, and that this key gives you access to <systemitem
 class="systemname">jeeves</systemitem>.  
 </para>
-<para>First install mercurial-server on <systemitem
-class="systemname">jeeves</systemitem>:</para>
-<screen><computeroutput>jay@spoon:~$ </computeroutput><userinput>scp mercurial-server_0.6.1_amd64.deb jeeves:</userinput>
-<computeroutput>mercurial-server_0.6.1_amd64.deb 100%
-jay@spoon:~$ </computeroutput><userinput>ssh -A jeeves</userinput>
-<computeroutput>jay@jeeves:~$ </computeroutput><userinput>sudo dpkg -i mercurial-server_0.7_amd64.deb</userinput>
-<computeroutput>[sudo] password for jay: 
-Selecting previously deselected package mercurial-server.
-(Reading database ... 144805 files and directories currently installed.)
-Unpacking mercurial-server (from .../mercurial-server_0.7_amd64.deb) ...
-Setting up mercurial-server (0.7) ...
-jay@jeeves:~$ </computeroutput></screen>
-<para>
-mercurial-server is now installed on the repository host.  Next, we need to give you permission to access its repositories.
-</para>
-<screen><computeroutput>jay@jeeves:~$ </computeroutput><userinput>ssh-add -L > my-key</userinput>
+<screen><computeroutput>jay@spoon:~$ </computeroutput><userinput>ssh -A jeeves</userinput>
+<computeroutput>jay@jeeves:~$ </computeroutput><userinput>ssh-add -L > my-key</userinput>
 <computeroutput>jay@jeeves:~$ </computeroutput><userinput>sudo mkdir -p /etc/mercurial-server/keys/root/jay</userinput>
 <computeroutput>jay@jeeves:~$ </computeroutput><userinput>sudo cp my-key /etc/mercurial-server/keys/root/jay/spoon</userinput>
 <computeroutput>jay@jeeves:~$ </computeroutput><userinput>sudo -u hg /usr/share/mercurial-server/refresh-auth</userinput>