Overview
SHA1 Hash: | a938517964be69264642e76eb249f1a296b0388a |
---|---|
Date: | 2007-08-26 02:01:58 |
User: | aku |
Comment: | Fixed a number of simple typos. |
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/concepts.html from [c70816f44a] to [8da6496b93].
@@ -10,11 +10,11 @@ <h2>1.0 Introduction</h2> <p> <a href="index.html">Fossil</a> is a <a href="http://en.wikipedia.org/wiki/Software_configuration_management"> software configuration management</a> system. -Fossil is software that is design to control and track the +Fossil is software that is designed to control and track the development of a software project and to record the history of the project. There are many such systems in use today. Fossil strives to distinguish itself from the others by being extremely simple to setup and operate.</p> @@ -34,23 +34,23 @@ <p>A "repository" is a database that contains copies of all historical versions or baselines for a project. Baselines are normally stored in the repository in a highly space-efficient compressed format (delta encoding). But that is an implementation detail that you the user need not worry over. -Think of the repository as a safe place where all your old baselines +Think of the repository as a safe place where all your old baselines are securely stored away and available for retrieval whenever you need them.</p> <p>A repository in fossil is a single file on your disk. This file -might be rather larger (dozens or hundreds of megabytes for a large +might be rather large (dozens or hundreds of megabytes for a large or long running project) but it is nevertheless just a file. You can move it around, rename it, write it out to a memory stick, or do anything else you normally do with files.</p> <p>Each source tree that is controlled by fossil is associated with -a single repository on the local disk drive. You can two or more -source trees tied to a single repository if you want (though one +a single repository on the local disk drive. You can tie two or more +source trees to a single repository if you want (though one tree per repository is the most common configuration.) So a single repository can be associated with many source trees, but each source tree is associated with only one repository.</p> <p>Fossil source tree may not overlap. A fossil source tree is identified @@ -69,12 +69,12 @@ source tree in which to work. Developers share their work by "syncing" the content of their local repositories either directly or through a central server. Changes can "push" from the local repository into a remote repository. Or changes can "pull" from a remote repository into a local repository. Or one can do a "sync" -which is shortcut for doing both a push and a pull at the same time. -Fossil also has the concept of "cloning". A "clone" is like a "pull" +which is a shortcut for doing both a push and a pull at the same time. +Fossil also has the concept of "cloning". A "clone" is like a "pull", except that instead of beginning with an existing local repository, a clone begins with nothing and creates a new local repository that is a replicate of a remote repository.</p> <p>Communication between repositories is via HTTP. Remote @@ -86,13 +86,13 @@ <p>A particular version of a particular file is called an "artifact". Each artifact has a universally unique name which is the <a href="http://en.wikipedia.org/wiki/SHA">SHA1</a> hash of the content of that file expressed as 40 characters of lower-case hexadecimal. Such -such has is referred to as the Universally Unique Identifier or UUID +a hash is referred to as the Universally Unique Identifier or UUID for the artifact. The SHA1 algorithm is created with the purpose of -provide a highly forgery-resistent identifier for a file. Given any +providing a highly forgery-resistent identifier for a file. Given any file it is simple to find the UUID for that file. But given a UUID it is computationally intractable to generate a file that will generate that UUID.</p> @@ -137,11 +137,11 @@ with each check-in or commit is really just the UUID of the manifest for that baseline.</p> <p>Fossil automatically generates a manifest whenever you "commit" a new baseline. So this is not something that you, the developer, -need to worry with. The format of a manifest is intentially +need to worry with. The format of a manifest is intentionally designed to be simple to parse, however, so that if you want to read and interpret a manifest, either by hand or with a script, that is easy to do.</p> <p>In addition to identifying all files in the baseline, a @@ -160,28 +160,28 @@ <li>A <b>repository</b> keeps a record of historical baselines.</li> <li>Repositories share their changes using <b>push</b>, <b>pull</b>, <b>sync</b>, and <b>clone</b>.</li> <li>A particular version of a particular file is an <b>artifact</b> that is identified by a <b>UUID</b>.</li> -<li>Artifacts tracked by fossil are inheriently immutable.</li> +<li>Artifacts tracked by fossil are inherently immutable.</li> <li>Fossil automatically generates a <b>manifest</b> file that identifies every artifact in a baseline.</li> <li>The UUID of the manifest is the UUID of the baseline.</li> </ul> <h2>3.0 Fossil - The Program</h2> <p>Fossil is software. The implementation of fossil is in the form -of a single executable name "fossil". To install fossil on your system, +of a single executable named "fossil". To install fossil on your system, all you have to do is obtain a copy of this one executable file (either by downloading a precompiled version or compiling it yourself) and then putting that file somewhere on your PATH.</p> <p>Fossil is completely self-contained. It is not necessary to install any other software in order to use fossil. You do <u>not</u> need CVS, gzip, diff, rsync, Python, Perl, Tcl, Java, apache, PostgreSQL, MySQL, -SQLite, Tcl, patch, or any similar software on your system in order to use +SQLite, patch, or any similar software on your system in order to use fossil effectively. You will want to have some kind of text editor for entering check-in comments. Fossil will use whatever text editor is identified by your VISUAL environment variable. Fossil will also use GPG to clearsign your manifests if you happen to have it installed, but fossil will skip that step if you do not have GPG so it is not