]> thyrsus.com Git - src.git/commitdiff
list and log documentation.
authorEric S. Raymond <esr@thyrsus.com>
Sat, 15 Nov 2014 22:13:01 +0000 (17:13 -0500)
committerEric S. Raymond <esr@thyrsus.com>
Sat, 15 Nov 2014 22:13:01 +0000 (17:13 -0500)
src

diff --git a/src b/src
index 9ca12e674436071c02f01947e39954d18c687b07..5a2afa595347a498e6a9e5d7c4fb6d97b798d24d 100755 (executable)
--- a/src
+++ b/src
@@ -266,8 +266,10 @@ commands  -- a summary of the commands.
 commit    -- the commit comand: how to commit changes to a file.
 amend     -- the amend command: editing stored change comments.
 checkout  -- the checkout command: retrieving historical versions of files.
-cat       -- the cat command: printing revisions to standard output
+cat       -- the cat command: dumping revisions to standard output
 status    -- the status command: more details and unusual status codes
+log       -- the log command: dump commit log information to standard output
+list      -- the list command: dump commit summaries to standard output
 ignores   -- .srcignore files and their uses.
 """,
     "intro": """
@@ -536,6 +538,27 @@ you give none is the tip revision of the current branch.
 
 This command is mainly intended for use in scripts.
 """,
+   "log" : """
+src log ['revision-range'] ['file'...]
+
+Sends log information about the specified commits of each file
+to standard output.  The log information includes the revision
+number, the date, and the log comment.
+
+With no revision, dumps a log of the entire current branch.
+""",   
+   "list" : """
+src list ['revision-range'] ['file'...]
+
+Sends summary information about the specified commits of each file
+to standard output.  The summary information includes the revision
+number, the date, and the first line of the log comment.
+
+This command is provided assuming you will use the good practice
+of beginning each commit with a self-contained summary line.
+
+With no revision, dumps a log of the entire current branch.
+""",   
    "ignores" : """
 You can have a file named .srcignore containing the names of files that
 SRC should ignore, or more commonly patterns describing files to ignore.