diff doc/sphinx/getting-started.rst @ 1740:102e61645069

Updated web-page notes to point to the new EAIT-hosted repository.
author Peter Jacobs <peterj@mech.uq.edu.au>
date Fri, 22 Aug 2014 15:50:11 +1000
parents d7dc0216b139
children c2daa7b406e3
line wrap: on
line diff
--- a/doc/sphinx/getting-started.rst	Thu Aug 21 21:51:25 2014 +1000
+++ b/doc/sphinx/getting-started.rst	Fri Aug 22 15:50:11 2014 +1000
@@ -7,23 +7,25 @@
 To make a clone of the repository::
 
   $ cd $HOME
-  $ hg clone https://cfcfdlocal@triton.pselab.uq.edu.au/cfcfd3-hg/cfcfd3-hg/ cfcfd3
+  $ hg clone https://source.eait.uq.edu.au/hg/cfcfd3 cfcfd3
 
+and provide the username "cfcfd-user@svn.itee.uq.edu.au" for authentication.
 This takes about 40 seconds on campus at UQ.  
 It may take much longer, depending on your internet connection.
 
 To see what's changed::
 
   $ cd cfcfd3
-  $ hg incoming https://cfcfdlocal@triton.pselab.uq.edu.au/cfcfd3-hg/cfcfd3-hg/
+  $ hg incoming https://source.eait.uq.edu.au/hg/cfcfd3
   ...
-  $ hg pull -u https://cfcfdlocal@triton.pselab.uq.edu.au/cfcfd3-hg/cfcfd3-hg/
+  $ hg pull -u https://source.eait.uq.edu.au/hg/cfcfd3
 
 Notes
 
 #. You will need a password for any access.  Please ask.
-#. You can read but not write with the "cfcfdlocal" username.
-#. Some usernames (by negotiation) may push changesets back to the repository.
+#. You can read but not write with the "cfcfd-user" username.
+#. Some usernames (cfcfd-dev@svn.itee.uq.edu.au) may push changesets back 
+   to the repository.  You will need to negotiate a developer role for this access.
 #. Some gas models depend on the NASA CEA code or the NIST REFPROP library.
    If you want to use these models (and there is no look-up-table equivalent
    already available) you will need to obtain these codes and place them 
@@ -165,52 +167,15 @@
 
 SSH access to the repository for developers
 -------------------------------------------
-Alternative access to the Mercurial repository for developers is possible via ssh.
-You will need the password or your public key installed for any access.  Please ask.
+Alternative access to the Mercurial repository for developers is possible via https.
+You will need the password for the cfcfd-dev@svn.itee.uq.edu.au login.  Please ask.
 
 ::
 
   $ cd ~
-  $ hg clone ssh://cfcfd3@triton/cfcfd3-hg cfcfd3
+  $ hg clone https://source.eait.uq.edu.au/hg/cfcfd3 cfcfd3
   $ cd cfcfd3/extern/
-  $ hg clone ssh://cfcfd3@triton/cea2-hg cea2
-  $ hg clone ssh://geothermal@triton/refprop-hg refprop
-
+  $ hg clone https://source.eait.uq.edu.au/hg/cea2 cea2
+  $ hg clone https://source.eait.uq.edu.au/hg/refprop refprop
 
 
-Notes about Mercurial and https certificate warnings
-----------------------------------------------------
-For versions of Mercurial greater than 1.7.3, a warning will be issued
-about the certificate not being verified when accessing the repository
-over https. To satisy Mercurial's complaints, you will need to configure
-the Certificate Authorities (CAs) which it uses. There are two ways to
-do this:
-
-1. configure HTTPS certificate authorities; or
-2. verify ``triton.pselab.uq.edu.au`` individually using its fingerprint.
-
-In either case, you will need to edit your hg configuration file which
-can be a repository-specific file ``.hg/hgrc`` or set globally in
-``~/.hgrc``.
-
-To configure the certificate authorities, the value for ``cacerts`` need to
-be set correctly for your system. For example, a Fedora (or Fedora-like) linux system,
-this can be done by adding the following to the ``hgrc`` file::
-
-  [web]
-  cacerts = /etc/ssl/certs/ca-bundle.crt
-
-Examples for other linux systems can be found at MercurialCAs_.
-
-The alternative is to configure the host fingerprint for
-``triton.pselab.uq.edu.au`` explicitly. To do this, add
-the following to your hg config file::
-
-  [hostfingerprints]
-  triton.pselab.uq.edu.au = 1d:33:32:b0:6c:e2:5c:13:67:35:ba:e6:60:cc:4e:c1:03:63:5a:2e
-
-More information about configuring Mercurial to use your system's certificate
-authorities is available at MercurialCAs_.
-
-
-.. _MercurialCAs: http://mercurial.selenic.com/wiki/CACertificates