def help_method(*args):
"Summarize src commands, or (with argument) show help for a single command."
print"""
-A revision-spec can be a 1-origin revno or a pair of them separated by '-'.
-Revisions can be designated by named tags
+A revision-spec can be a 1-origin revno or a pair of them separated by
+'-' or '..'. Revisions can be designated by named tags.
The token "--" tells the command-line interpreter that revision-specs
ad subcommands are done - everything after it is a filename, even
elif args[0].isdigit():
revspec = args.pop(0)
try:
- if "-" in revspec:
- (start, end) = revspec.split("-")
+ if "-" in revspec or ".." in revspec:
+ try:
+ (start, end) = revspec.split("-")
+ except ValueError:
+ try:
+ (start, end) = revspec.split("..")
+ except ValueError:
+ croak("internal error - argument parser is confused")
try:
start = int(start)
except ValueError:
== DESCRIPTION ==
SRC (or src) is simple revision control, a version-control system for
single-file projects by solo developers and authors. It modernizes the
-venerable RCS, hence the anagrammatic acronym.
+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
SRC gives you simple, consecutive integer revision numbers. It
supports tags and branching. It does not show committer information,
-because the committer is always you.
+because the committer is always you. The command set is intended
+to look familiar if you have ever used Subversion, Mercurial, or Git.
SRC interprets the EDITOR variable in the usual way, using it to spawn
an editor instance when you perform a commit.
== COMMAND SUMMARY ==
-A revision spec is a 1-origin integer N, or a range literal M..N.
-Revisions can be designated by named tags
+A revision spec is a 1-origin integer N, or a range literal M-N.
+Revisions can be designated by named tags. ".." is treated as
+a synonym for "-".
The token "--" tells the command-line interpreter that revision-specs
ad subcommands are done - everything after it is a filename, even