]> thyrsus.com Git - src.git/commitdiff
Documentation polishing.
authorEric S. Raymond <esr@thyrsus.com>
Sat, 8 Nov 2014 16:21:45 +0000 (11:21 -0500)
committerEric S. Raymond <esr@thyrsus.com>
Sat, 8 Nov 2014 16:21:45 +0000 (11:21 -0500)
src.asc

diff --git a/src.asc b/src.asc
index 969be72915ed56ba5280be7696daf790dbf490ad..9116b2e41d51aa3168fbbf2e33130bfea8b787dd 100644 (file)
--- a/src.asc
+++ b/src.asc
@@ -15,10 +15,10 @@ venerable RCS, hence the anagrammatic acronym. The desigh is
 tuned for use cases like all those little scripts in your ~/bin 
 directory, or a directory full of HOWTOs.
 
-SRC revision histories are single, human-readable files beneath a hidden .src 
-subdirectory in the directory where they live.  There may be multiple
-histories under one directory; SRC treats them as separate projects,
-and history files can be moved elsewhere at any time.
+SRC revision histories are single, human-readable files beneath a
+hidden .src subdirectory in the directory where they live.  There may
+be multiple histories under one directory; SRC treats them as separate
+projects, and history files can be moved elsewhere at any time.
 
 SRC gives you simple, consecutive integer revision numbers. It
 supports tags and branching. It does not show committer information,
@@ -110,7 +110,8 @@ succeeded.  This behavior can be suppressed with the -q option, placed
 
 == BACKWARD COMPATIBILITY ==
 
-SRC history files are RCS master files. There is no hidden state.
+SRC history files are RCS master files. SRC maintains no state other
+than these files.
 
 In order to maintain complete backwards compatibility, one compromise
 was made: any commit comment containing a string exactly matching an
@@ -136,13 +137,16 @@ revision and fixes the user information to be used in fast-export;
 It also attributes all commits to J. Random Hacker and sets a
 constant screen witch of 79. It's for regression testing.
 
-== DANGER! DANGER! ==
-This is a proof-of-concept alpha release. The 'branch' command is not
-yet implemented; it is described here to document the design.
+== LIMITATIONS ==
+
+The 'branch' command is not yet implemented; it is described here to
+document the UI design choice.
 
 == REPORTING BUGS ==
+
 Report bugs to Eric S. Raymond <esr@thyrsus.com>.  The project page is
 at http://catb.org/~esr/src
 
 == SEE ALSO ==
+
 rcs(1).