Overview
| SHA1 Hash: | 06689854aee056442322467e836a0686f3ee3ee5 |
|---|---|
| Date: | 2008-05-17 20:32:50 |
| User: | drh |
| Comment: | Documentation tweaks. |
| Timelines: | ancestors | descendants | both | trunk |
| Other Links: | files | ZIP archive | manifest |
Tags And Properties
- branch=trunk inherited from [a28c83647d]
- sym-trunk inherited from [a28c83647d]
Changes
[hide diffs]Modified www/build.wiki from [61aa0809d1] to [75b978c24a].
@@ -1,5 +1,6 @@ +<nowiki> <h1>Installing Fossil</h1> <p>This page describes how to build and install Fossil. The whole process is designed to be very easy.</p>
Modified www/index.wiki from [afae3536c0] to [6a1fbd69a9].
@@ -4,15 +4,17 @@ Fossil is a new <a href="http://en.wikipedia.org/wiki/Revision_control"> distributed software revision control system</a> that includes an integrated <a href="http://en.wikipedia.org/wiki/Wiki">Wiki</a> and an integrated <a href="http://en.wikipedia.org/wiki/Bugtracker"> -bug-tracking system</a> all into a single easy-to-use stand-alone +bug-tracking system</a> all in a single easy-to-use stand-alone executable. -(NB: The bug-tracker component is still not completely functional...) +(NB: The bug-tracker component is still not completely functional yet, but +we expect it to be available soon.) Fossil is -<a href="http://www.fossil-scm.org/fossil/timeline">self-hosting</a> on +<a href="http://www.fossil-scm.org/fossil/timeline">self-hosting</a> +since 2007-07-21 on <a href="http://www.hwaci.com/cgi-bin/fossil/timeline">two separate servers</a>. You can download the lastest sources compile it yourself using the instructions below. Or you can grab <a href="http://www.fossil-scm.org/download.html">precompiled binaries</a>. @@ -79,31 +81,37 @@ <a href="http://www.oreillynet.com/pub/a/oreilly/tim/news/2005/09/30/what-is-web-20.html">Web 2.0</a>. Fossil attempts to better capture "collective intelligence" and "the wisdom of crowds" by opening up write access to the masses.</li> </ul> -<p>Other Links:</p> +<p>User Links:</p> <ul> <li>The <a href="concepts.wiki">concepts</b> behind fossil</li> <li><a href="build.wiki">Building And Installing</a></li> <li><a href="quickstart.wiki">Quick Start</a> guide to using fossil -<li><a href="pop.wiki">Principles Of Operation</a></li> <li>The <a href="selfcheck.wiki">automatic self-check</a> mechanism helps insure project integrity.</li> +<li>The <a href="http://www.fossil-scm.org/fossil/wiki">self-hosting + fossil wiki</a>, capable of hosting static pages and community-editable wiki + content.</li> +<li>There is a + <a href="http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users"> + mailing list</a> available for discussing fossil issues.</li> +</ul> + +<p>Developer Links: </p> + +<ul> +<li><a href="pop.wiki">Principles Of Operation</a></li> <li>The <a href="fileformat.wiki">file format</a> used by every content file stored in the repository.</li> <li>The <a href="delta_format.wiki">format of deltas</a> used to efficiently store changes between file revisions.</li> <li>The <a href="delta_encoder_algorithm.wiki">encoder algorithm</a> used to efficiently generate deltas.</li> <li>The <a href="sync.wiki">synchronization protocol</a>.</li> -<li>There is a <a href="http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users"> - mailing list</a> available for discussing fossil issues.</li> -<li>The <a href="http://www.fossil-scm.org/fossil/wiki">self-hosting - fossil wiki</a>, capable of hosting static pages and community-editable wiki - content.</li> </ul> <p>Competing Projects:</p> <ul>
Modified www/quickstart.wiki from [5e0abce227] to [e76c743118].
@@ -50,17 +50,21 @@
project or create a new project of your own, you usually want to do some
local configuration. This is accomplished using a webbrowser. First
start a fossil webserver like this:</p>
<blockquote>
- <b>fossil server </b><i> repository-filename</i>
+ <b>fossil ui </b><i> repository-filename</i>
</blockquote>
<p>This creates a mini-webserver listening on port 8080. You can
specify a different port using the <b>-port</b> option on the command-line.
- After the server is running, point your webbrowser at
- http://localhost:8080/ and start configuring.</p>
+ After the server is running, fossil will then attempt to launch your
+ web browser and make it point to this web server. If your system
+ has an unusual configuration, fossil might not be able to figure out
+ how to start your web browser. In that case, start the web browser
+ yourself and point it at http://localhost:8080/. Click on the
+ "Setup" link on the menu bar to start configuring your repository.</p>
<p>By default, fossil does not require a login for HTTP connections
coming in from the IP loopback address 127.0.0.1. You can, and perhaps
should, change this after you create a few users.</p>
@@ -76,18 +80,13 @@
<blockquote>
<b>fossil open </b><i> repository-filename</i>
</blockquote>
- <p>This leaves you with the original (empty) version of the tree
- checked out. To get to the latest version, also do this:</p>
-
- <blockquote>
- <b>fossil update</b>
- </blockquote>
-
- <p>From anywhere underneath the root of your local tree, you
+ <p>This leaves you with the newest version of the tree
+ checked out.
+ From anywhere underneath the root of your local tree, you
can type commands like the following to find out the status of
your local tree:</p>
<blockquote>
<b>fossil info</b><br>
@@ -182,11 +181,20 @@
<blockquote>
<b>fossil server</b> <i>repository-filename</i>
</blockquote>
- <p>You can omit the <i>repository-filename</i> if you are within
+ <p>Or</b>
+
+ <blockquote>
+ <b>fossil ui</b> <i>repository-filename</i>
+ </blockquote>
+
+ <p>The difference between these two command is that <b>ui</b>
+ attempts to automatically start your web browser point at the
+ server whereas <b>server</b> does not.
+ You can omit the <i>repository-filename</i> if you are within
a checked-out local tree. This server uses port 8080 by default
but you can specify a different port using the <b>-port</b> command.</p>
<p>Command-line servers like this are useful when two people want
to share a repository on temporary or ad-hoc basis. For a more