# HG changeset patch # User Paul Eggert # Date 1082268136 0 # Node ID 860258597b7852cbe0970440bf1aa15a823580c8 # Parent 4732f3096a88dc67c514a5dcc33543793988a7d2 * rcs2log (Help): Clarify wording of the usage message. diff -r 4732f3096a88 -r 860258597b78 lib-src/ChangeLog --- a/lib-src/ChangeLog Sun Apr 18 02:05:02 2004 +0000 +++ b/lib-src/ChangeLog Sun Apr 18 06:02:16 2004 +0000 @@ -1,3 +1,9 @@ +2004-04-17 Paul Eggert + + * rcs2log (Help): Clarify wording of the usage message. + Problem reported by Alan Mackenzie in + . + 2004-04-07 Stefan Monnier * make-docfile.c (xmalloc): Fix return type. diff -r 4732f3096a88 -r 860258597b78 lib-src/rcs2log --- a/lib-src/rcs2log Sun Apr 18 02:05:02 2004 +0000 +++ b/lib-src/rcs2log Sun Apr 18 06:02:16 2004 +0000 @@ -2,34 +2,57 @@ # RCS to ChangeLog generator -# Generate a change log prefix from RCS files (perhaps in the CVS repository) -# and the ChangeLog (if any). -# Output the new prefix to standard output. -# You can edit this prefix by hand, and then prepend it to ChangeLog. +Help=' +Generate ChangeLog entries from RCS files (perhaps in a CVS repository) +and the ChangeLog file (if any). An RCS file typically has a name +ending in ",v", and represents the entire history of a file that is +under revision control. The ChangeLog file logs entries for changes, +in reverse chronological order. + +Generate entries for changes entered into RCS (or CVS) more recently +than the newest existing entry in the ChangeLog file. You can then +edit these entries by hand, and prepend them to the ChangeLog file. + +Output the resulting ChangeLog entries to standard output. +Each entry looks something like this: + +2004-04-17 Paul Eggert -# Ignore log entries that start with `#'. -# Clump together log entries that start with `{topic} ', -# where `topic' contains neither white space nor `}'. + * rcs2log (Help): Clarify wording of the usage message. + Problem reported by Alan Mackenzie in + . -Help='The default FILEs are the files registered under the working directory. +ChangeLog entries contain the current date, full name, email address +including hostname, the name of the affected file, and commentary. +RCS and CVS logs lack full names and email addresses, so they are +inferred from login names using a heuristic that can be overridden +via the -u option. + +Ignore log entries that start with "#". +Clump together log entries that start with "{topic} ", +where "topic" contains neither white space nor "}". + +If no FILE is specified, use all files under the working directory +that are maintained under version control. + Options: - -c CHANGELOG Output a change log prefix to CHANGELOG (default ChangeLog). + -c FILE Output ChangeLog entries for FILE (default ChangeLog). -h HOSTNAME Use HOSTNAME in change log entries (default current host). -i INDENT Indent change log lines by INDENT spaces (default 8). -l LENGTH Try to limit log lines to LENGTH characters (default 79). - -L FILE Use rlog-format FILE for source of logs. + -L FILE Use FILE (same format as "rlog") for source of logs. -R If no FILEs are given and RCS is used, recurse through working directory. - -r OPTION Pass OPTION to subsidiary log command. + -r OPTION Pass OPTION to subsidiary command (either "rlog" or "cvs -q log"). -t TABWIDTH Tab stops are every TABWIDTH characters (default 8). - -u "LOGINFULLNAMEMAILADDR" Assume LOGIN has FULLNAME and MAILADDR. + -u "LOGINFULLNAMEEMAILADDR" LOGIN has FULLNAME and EMAILADDR. -v Append RCS revision to file names in log lines. --help Output help. --version Output version number. Report bugs to .' -Id='$Id: rcs2log,v 1.52 2003/12/27 08:18:08 uid65632 Exp $' +Id='$Id: rcs2log,v 1.53 2004/02/15 07:41:58 uid65632 Exp $' # Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 2001, 2002, 2003, # 2004 Free Software Foundation, Inc.