Check-in [ec1fbd7f68]
Not logged in
Overview

SHA1 Hash:ec1fbd7f687d2bd87b6e9e608a56583de900e37c
Date: 2007-12-04 01:55:07
User: drh
Comment:Fix typos in the "concepts.html" document.
Timelines: ancestors | descendants | both | trunk
Other Links: files | ZIP archive | manifest

Tags And Properties
Changes
[hide diffs]

Modified www/concepts.html from [599347ea73] to [d4951ef603].

@@ -30,11 +30,12 @@
 <p>A software project normally consists of a "source tree".
 A source tree is a hierarchy of files that are used to generate
 the end product.  The source tree changes over time as the
 software grows and expands and as features are added and bugs
 are fixed.  A snapshot of the source tree at any point in time
-is called a "version" or a "baseline" of the product.</p>
+is called a "version" or "revision" or a "baseline" of the product.
+In fossil, we use the name "baseline".</p>
 
 <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.
@@ -53,11 +54,11 @@
 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
+<p>Fossil source trees may not overlap.  A fossil source tree is identified
 by a file named "_FOSSIL_" in the root directory of the source tree.  Every
 file that is a sibling of _FOSSIL_ and every file in every subfolder is
 considered potentially a part of the source tree.  The _FOSSIL_ file
 contains (among other things) the pathname of the repository with which
 the source tree is associated.  On the other hand, the repository has
@@ -93,11 +94,11 @@
 a hash is referred to as the Universally Unique Identifier or UUID
 for the artifact.  The SHA1 algorithm is created with the purpose of
 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>
+have that UUID.</p>
 
 
 <p>UUIDs look something like this:</p>
 
 <blockquote><b>
@@ -156,11 +157,11 @@
 be PGP clearsigned.</p>
 
 <h3>2.3 Key concepts</h3>
 
 <ul>
-<li>A <b>baseline</b> or <b>version</b> is a set of files arranged
+<li>A <b>baseline</b> is a set of files arranged
     in a hierarchy.</li>
 <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>
@@ -185,12 +186,14 @@
 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
-essential.</p>
+but fossil will skip that step if GPG missing from your system.
+You can optionally set up fossil to use external "diff" programs,
+though a perfectly functional "diff" algorithm is built it and works
+find for most people.</p>
 
 <p>To uninstall fossil, simply delete the executable.</p>
 
 <p>To upgrade an older version of fossil to a newer version, just
 replace the old executable with the new one.  You might need to