File:  [mozdev] / archangel / www / installation.html
Revision 1.15: download - view: text, annotated - select for diffs - revision graph
Sat Jan 3 22:16:41 2004 UTC (13 years, 9 months ago) by marnanel
Branches: MAIN
CVS tags: HEAD
clarification

<script language="javascript">
<!--

function triggerURL(url) {

        if (!InstallTrigger.updateEnabled())
          return false; 

        else
          InstallTrigger.startSoftwareUpdate(url); 

}

//-->
</script>


<!-- MAIN CONTENT -->
<h5 class="page-header">Installation</h5>

<p>Archangel is still under development, so don't expect anything to work. This software is currently only provided for testing. It has only been tested under Firebird, not classic Mozilla ("Seamonkey"). Please let me know about your installation successes and failures.</p>

<p>How to install:</p>
<ol>
<li>Read <a href="http://www.gnu.org/copyleft/gpl.html">the General Public Licence</a>, under which Archangel is distributed, and agree to its terms.</li>
<li>Start Mozilla. If you're running under Unix, <strong>you must start Mozilla as root</strong> the time you install Archangel. You're installing new software, after all. (The only exception is when Moz was installed under your own UID-- but if this applies to you, you probably already know about it.)</li>

<li><b>Then</b> return to this page, and install Archangel by clicking on this picture:

<div align="center"><a href="#" onclick="triggerURL('http://downloads.mozdev.org/archangel/archangel-0.5.0.xpi');"><img src="broken-wing.jpg" alt="[Install Archangel]" width="200" height="267"></a></div></li>

<li>Then</b> restart Mozilla as an ordinary user. (Unix users shouldn't attempt to use Archangel as root, not only for the ordinary security reasons, but also because it messes up cache file ownership.)</li>

<li>Mozilla will now understand the "rgtp" protocol.

<p><b>The first time you run Archangel</b>, it will need to download the whole RGTP index from the server. For a large server, such as GROGGS, this may take several minutes. At present, Archangel prints status messages while it's doing this to standard output. (Sooner or later, we'll add a status dialogue.) This only needs to be done once, and it'll happen automatically the first time you connect to a server. Other than the status messages, Mozilla will appear to lock up.</p>

<p>Get started by trying one of these addresses:<br>
<a href="rgtp://rgtp-serv.groggs.group.cam.ac.uk/index">rgtp://rgtp-serv.groggs.group.cam.ac.uk/index</a> (the main GROGGS server)<br>
<a href="rgtp://rgtp-serv.groggs.group.cam.ac.uk:1432/index">rgtp://rgtp-serv.groggs.group.cam.ac.uk:1432/index</a> (the test GROGGS server, which will be faster to load, but contains test junk instead of discussions)</p>
</li>

</ol>

<p>Archangel is a very basic client at present-- for example, it's not yet capable of posting.
Until it's more advanced, you might also want to
use <a href="/other-clients.html">another client</a>, such as
<a href="http://rgtp.thurman.org.uk/gossip/groggs/browse">Yarrow</a> or <a href="http://www.chiark.greenend.org.uk/~owend/free/GREED.html">GREED</a>.</p>

<p>Many thanks to <a href="http://myriadcolours.com/green/">Firinel</a> for the photograph.</p>



FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>