r825 - in trunk: . scripts

lizardo at linuxfromscratch.org lizardo at linuxfromscratch.org
Sun Aug 8 21:37:53 PDT 2004


Author: lizardo
Date: 2004-08-08 22:37:51 -0600 (Sun, 08 Aug 2004)
New Revision: 825

Removed:
   trunk/scripts/cl2html.pl
   trunk/scripts/cvs2cl.pl
   trunk/usermap
Modified:
   trunk/scripts/rsync-ignore
   trunk/scripts/update-website.mk
Log:
Removed some unused files, added some files to the rsync ignore list


Deleted: trunk/scripts/cl2html.pl
===================================================================
--- trunk/scripts/cl2html.pl	2004-08-09 03:35:48 UTC (rev 824)
+++ trunk/scripts/cl2html.pl	2004-08-09 04:37:51 UTC (rev 825)
@@ -1,227 +0,0 @@
-#!/usr/bin/perl
-# cl2html.pl - Convert the XML output of cvs2cl.pl to (X)HTML
-
-# Copyright (C) 2003 Anderson Lizardo
-# 
-# This program is free software; you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation; either version 2 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program; if not, write to the Free Software
-# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
-
-# $Id: cl2html.pl,v 1.7 2004/06/19 05:44:57 lizardo Exp $
-
-use strict;
-use warnings;
-
-use XML::Parser;
-use Getopt::Long;
-use Pod::Usage;
-use POSIX qw(strftime);
-
-# Some commit messages are in Unicode, so we need to tell Perl about it
-binmode(STDOUT, ":utf8");
-
-# Output only the last $entries_limit CVS changes
-my $entries_limit = 10;
-
-# Convert ISO 8601 date (yyyy-mm-dd) to the specified format
-sub isodate2any {
-    my ($date, $format) = @_;
-    if ($date =~ /(\d{4})-(\d{2})-(\d{2})/) {
-        return strftime($format, 0, 0, 0, $3, $2 - 1, $1 - 1900);
-    }
-    else {
-        return undef;
-    }
-}
-
-my $help = 0;
-my $man = 0;
-my $infile = "";
-my $with_filename = 0;
-my $with_branchname = 0;
-
-GetOptions(
-    "help" => \$help,
-    "man" => \$man,
-    "infile=s" => \$infile,
-    "with-filename", \$with_filename,
-    "with-branchname", \$with_branchname,
-) or pod2usage(1);
-
-pod2usage(1) if $help;
-pod2usage(-exitstatus => 0, -verbose => 2) if $man;
-
-my $date = "";     # Current date
-my $buffer = "";   # Current text in buffer
-my $author = "";   # Current author
-my $branch = "";   # Current branch
-my @messages = (); # Commit messages of the same author
-my $files = "";    # Files affected by CVS change
-my $branches = ""; # Branches affected by CVS change
-
-my $entry_count = 0;
-
-sub print_log {
-    exit 0 if $entry_count++ == $entries_limit;
-
-    print "<ul>\n\t<li>\n\t\t<h4>" . $author . " - " .
-    isodate2any($date, '%Y/%m/%d') . "</h4>\n";
-    print "\t\t<ul>\n";
-    foreach (@messages) {
-        print "\t\t\t<li>" . $_ . "</li>\n";
-    }
-    print "\t\t</ul>\n";
-    print "\t</li>\n</ul>\n\n";
-    @messages = ();
-}
-
-my $parser = new XML::Parser(
-    Handlers => {
-        Start => \&handle_StartTag,
-        End => \&handle_EndTag,
-        Char => \&handle_Text,
-    },
-);
-
-if ($infile) {
-    eval { $parser->parsefile($infile) } or pod2usage("$0: $@");
-}
-else {
-    $parser->parse(\*STDIN);
-}
-
-sub handle_StartTag {
-    my (undef, $tag) = @_;
-
-    $buffer = "";
-    $branch = "" if $tag eq "file";
-}
-
-sub handle_EndTag {
-    my (undef, $tag) = @_;
-
-    if ($tag eq "date") {
-        print_log() if ($buffer ne $date and @messages and $author and $date);
-        $date = $buffer;
-    }
-    elsif ($tag eq "author") {
-        print_log() if ($buffer ne $author and @messages and $author and $date);
-        $author = $buffer;
-    }
-    elsif ($tag eq "msg") {
-        if ($with_filename) {
-            $files =~ s/, $/: /;
-            $buffer = $files . $buffer;
-            $files = "";
-        }
-        if ($with_branchname) {
-            $branches =~ s/, $/: /;
-            $buffer = $branches . $buffer;
-            $branches = "";
-        }
-        unshift @messages, $buffer;
-    }
-    elsif ($tag eq "name" and $with_filename) {
-        $files .= $buffer . ", ";
-    }
-    elsif ($tag eq "branch" and $with_branchname) {
-        $branch = $buffer;
-    }
-    elsif ($tag eq "file" and $with_branchname) {
-        $branch = "HEAD" unless $branch;
-        unless ($branches =~ /(^|\s+)$branch,/) {
-            $branches .= $branch . ", ";
-            $branch = "";
-        }
-    }
-}
-
-sub handle_Text {
-    my ($expat, $text) = @_;
-
-    # Encode "special" entities
-    $text =~ s/\&/\&/g;
-    $text =~ s/</\</g;
-    $text =~ s/>/\>/g;
-    #$text =~ s/\"/\"/g;
-    #$text =~ s/\'/\'/g;
-
-    # Add current text to the buffer
-    $buffer .= $text;
-}
-
-__END__
-
-=head1 NAME
-
-cl2html.pl - convert the XML output of cvs2cl.pl to (X)HTML
-
-=head1 SYNOPSIS
-
-cl2html.pl  [--help|--man]  [--with-filename]  [--infile xml_file]
-
-    Options:
-        --infile          Parse XML from a file
-        --with-branchname Prepend branch names to commit messages
-        --with-filename   Prepend filenames to commit messages
-        --help            Show brief help message
-        --man             Full documentation
-
-=head1 DESCRIPTION
-
-B<cl2html.pl> converts the XML outputted by cvs2cl.pl's C<--xml> option to
-HTML or XHTML code.
-
-=head1 OPTIONS
-
-=over
-
-=item B<--infile xml_file>
-
-Specify which XML file to parse. This file must be the output of cvs2cl.pl's
-C<--xml> option. By default, B<cl2html.pl> reads XML code from standard input.
-
-=item B<--with-branchname>
-
-This option prepends branch names to each commit message.
-
-=item B<--with-filename>
-
-This option prepends filenames to each commit message.
-
-=item B<--help>
-
-Print a brief help message and exits.
-
-=item B<--man>
-
-Print the manual page and exits.
-
-=back
-
-=head1 AUTHOR
-
-Copyright (C) 2003 Anderson Lizardo <andersonlizardo at yahoo.com.br>
-
-This program is free software; you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation; either version 2 of the License, or
-(at your option) any later version.
-
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-GNU General Public License for more details.
-
-=cut
-

Deleted: trunk/scripts/cvs2cl.pl
===================================================================
--- trunk/scripts/cvs2cl.pl	2004-08-09 03:35:48 UTC (rev 824)
+++ trunk/scripts/cvs2cl.pl	2004-08-09 04:37:51 UTC (rev 825)
@@ -1,2429 +0,0 @@
-#!/bin/sh
-exec perl -w -x $0 ${1+"$@"} # -*- mode: perl; perl-indent-level: 2; -*-
-#!perl -w
-
-
-##############################################################
-###                                                        ###
-### cvs2cl.pl: produce ChangeLog(s) from `cvs log` output. ###
-###                                                        ###
-##############################################################
-
-## $Revision: 1.2 $
-## $Date: 2003/11/22 15:55:36 $
-## $Author: jeroen $
-##
-##   (C) 2001,2002,2003 Martyn J. Pearce <fluffy at cpan.org>, under the GNU GPL.
-##   (C) 1999 Karl Fogel <kfogel at red-bean.com>, under the GNU GPL.
-##
-##   (Extensively hacked on by Melissa O'Neill <oneill at cs.sfu.ca>.)
-##   (Gecos hacking by Robin Johnson <robbat2 at orbis-terrarum.net>.)
-##
-## cvs2cl.pl is free software; you can redistribute it and/or modify
-## it under the terms of the GNU General Public License as published by
-## the Free Software Foundation; either version 2, or (at your option)
-## any later version.
-##
-## cvs2cl.pl is distributed in the hope that it will be useful,
-## but WITHOUT ANY WARRANTY; without even the implied warranty of
-## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-## GNU General Public License for more details.
-##
-## You may have received a copy of the GNU General Public License
-## along with cvs2cl.pl; see the file COPYING.  If not, write to the
-## Free Software Foundation, Inc., 59 Temple Place - Suite 330,
-## Boston, MA 02111-1307, USA.
-
-

-use strict;
-use Text::Wrap qw( );
-use Time::Local;
-use File::Basename qw( fileparse );
-use User::pwent;
-
-

-# The Plan:
-#
-# Read in the logs for multiple files, spit out a nice ChangeLog that
-# mirrors the information entered during `cvs commit'.
-#
-# The problem presents some challenges. In an ideal world, we could
-# detect files with the same author, log message, and checkin time --
-# each <filelist, author, time, logmessage> would be a changelog entry.
-# We'd sort them; and spit them out.  Unfortunately, CVS is *not atomic*
-# so checkins can span a range of times.  Also, the directory structure
-# could be hierarchical.
-#
-# Another question is whether we really want to have the ChangeLog
-# exactly reflect commits. An author could issue two related commits,
-# with different log entries, reflecting a single logical change to the
-# source. GNU style ChangeLogs group these under a single author/date.
-# We try to do the same.
-#
-# So, we parse the output of `cvs log', storing log messages in a
-# multilevel hash that stores the mapping:
-#   directory => author => time => message => filelist
-# As we go, we notice "nearby" commit times and store them together
-# (i.e., under the same timestamp), so they appear in the same log
-# entry.
-#
-# When we've read all the logs, we twist this mapping into
-# a time => author => message => filelist mapping for each directory.
-#
-# If we're not using the `--distributed' flag, the directory is always
-# considered to be `./', even as descend into subdirectories.
-
-

-############### Globals ################
-
-use constant MAILNAME => "/etc/mailname";
-
-# What we run to generate it:
-my $Log_Source_Command = "cvs -Q log";
-
-# In case we have to print it out:
-my $VERSION = '$Revision: 1.2 $';
-$VERSION =~ s/\S+\s+(\S+)\s+\S+/$1/;
-
-## Vars set by options:
-
-# Print debugging messages?
-my $Debug = 0;
-
-# Just show version and exit?
-my $Print_Version = 0;
-
-# Just print usage message and exit?
-my $Print_Usage = 0;
-
-# Single top-level ChangeLog, or one per subdirectory?
-my $Distributed = 0;
-
-# What file should we generate (defaults to "ChangeLog")?
-my $Log_File_Name = "ChangeLog";
-
-# Grab most recent entry date from existing ChangeLog file, just add
-# to that ChangeLog.
-my $Cumulative = 0;
-
-# `cvs log -d`, this will repeat the last entry in the old log.  This is OK,
-# as it guarantees at least one entry in the update changelog, which means
-# that there will always be a date to extract for the next update.  The repeat
-# entry can be removed in postprocessing, if necessary.
-
-# MJP 2003-08-02
-# I don't think this actually does anything useful
-my $Update = 0;
-
-# Expand usernames to email addresses based on a map file?
-my $User_Map_File = "";
-my $User_Passwd_File;
-my $Mail_Domain;
-
-# Output log in chronological order? [default is reverse chronological order]
-my $Chronological_Order = 0;
-
-# Grab user details via gecos
-my $Gecos = 0;
-
-# User domain for gecos email addresses
-my $Domain;
-
-# Output to a file or to stdout?
-my $Output_To_Stdout = 0;
-
-# Eliminate empty log messages?
-my $Prune_Empty_Msgs = 0;
-
-# Tags of which not to output
-my %ignore_tags;
-
-# Show only revisions with Tags
-my %show_tags;
-
-# Don't call Text::Wrap on the body of the message
-my $No_Wrap = 0;
-
-# Don't do any pretty print processing
-my $Summary = 0;
-
-# Separates header from log message.  Code assumes it is either " " or
-# "\n\n", so if there's ever an option to set it to something else,
-# make sure to go through all conditionals that use this var.
-my $After_Header = " ";
-
-# XML Encoding
-my $XML_Encoding = '';
-
-# Format more for programs than for humans.
-my $XML_Output = 0;
-my $No_XML_Namespace = 0;
-
-# Do some special tweaks for log data that was written in FSF
-# ChangeLog style.
-my $FSF_Style = 0;
-
-# Show times in UTC instead of local time
-my $UTC_Times = 0;
-
-# Show times in output?
-my $Show_Times = 1;
-
-# Show day of week in output?
-my $Show_Day_Of_Week = 0;
-
-# Show revision numbers in output?
-my $Show_Revisions = 0;
-
-# Show dead files in output?
-my $Show_Dead = 0;
-
-# Hide dead trunk files which were created as a result of additions on a
-# branch?
-my $Hide_Branch_Additions = 1;
-
-# Show tags (symbolic names) in output?
-my $Show_Tags = 0;
-
-# Show tags separately in output?
-my $Show_Tag_Dates = 0;
-
-# Show branches by symbolic name in output?
-my $Show_Branches = 0;
-
-# Show only revisions on these branches or their ancestors.
-my @Follow_Branches;
-
-# Don't bother with files matching this regexp.
-my @Ignore_Files;
-
-# How exactly we match entries.  We definitely want "o",
-# and user might add "i" by using --case-insensitive option.
-my $Case_Insensitive = 0;
-
-# Maybe only show log messages matching a certain regular expression.
-my $Regexp_Gate = "";
-
-# Pass this global option string along to cvs, to the left of `log':
-my $Global_Opts = "";
-
-# Pass this option string along to the cvs log subcommand:
-my $Command_Opts = "";
-
-# Read log output from stdin instead of invoking cvs log?
-my $Input_From_Stdin = 0;
-
-# Don't show filenames in output.
-my $Hide_Filenames = 0;
-
-# Don't shorten directory names from filenames.
-my $Common_Dir = 1;
-
-# Max checkin duration. CVS checkin is not atomic, so we may have checkin
-# times that span a range of time. We assume that checkins will last no
-# longer than $Max_Checkin_Duration seconds, and that similarly, no
-# checkins will happen from the same users with the same message less
-# than $Max_Checkin_Duration seconds apart.
-my $Max_Checkin_Duration = 180;
-
-# What to put at the front of [each] ChangeLog.
-my $ChangeLog_Header = "";
-
-# Whether to enable 'delta' mode, and for what start/end tags.
-my $Delta_Mode = 0;
-my $Delta_From = "";
-my $Delta_To = "";
-
-my $TestCode;
-
-# Whether to parse filenames from the RCS filename, and if so what
-# prefix to strip.
-my $RCS_Mode = 0;
-my $RCS_Root = "";
-
-## end vars set by options.
-
-# latest observed times for the start/end tags in delta mode
-my $Delta_StartTime = 0;
-my $Delta_EndTime = 0;
-
-# In 'cvs log' output, one long unbroken line of equal signs separates
-# files:
-my $file_separator = "======================================="
-                   . "======================================";
-
-# In 'cvs log' output, a shorter line of dashes separates log messages
-# within a file:
-my $logmsg_separator = "----------------------------";
-
-my $No_Ancestors = 0;
-
-############### End globals ############
-
-

-
-&parse_options ();
-if ( defined $TestCode ) {
-  eval $TestCode;
-  die "Eval failed: '$@'\n"
-    if $@;
-} else {
-  &derive_change_log ();
-}
-
-

-### Everything below is subroutine definitions. ###
-
-sub run_ext {
-  my ($cmd) = @_;
-  $cmd = [$cmd]
-    unless ref $cmd;
-  local $" = ' ';
-  my $out = qx"@$cmd 2>&1";
-  my $rv  = $?;
-  my ($sig, $core, $exit) = ($? & 127, $? & 128, $? >> 8);
-  return $out, $exit, $sig, $core;
-}
-
-# If accumulating, grab the boundary date from pre-existing ChangeLog.
-sub maybe_grab_accumulation_date ()
-{
-  if (! $Cumulative || $Update) {
-    return "";
-  }
-
-  # else
-
-  open (LOG, "$Log_File_Name")
-      or die ("trouble opening $Log_File_Name for reading ($!)");
-
-  my $boundary_date;
-  while (<LOG>)
-  {
-    if (/^(\d\d\d\d-\d\d-\d\d\s+\d\d:\d\d)/)
-    {
-      $boundary_date = "$1";
-      last;
-    }
-  }
-
-  close (LOG);
-
-  # convert time from utc to local timezone if the ChangeLog has
-  # dates/times in utc
-  if ($UTC_Times && $boundary_date)
-  {
-    # convert the utc time to a time value
-    my ($year,$mon,$mday,$hour,$min) = $boundary_date =~
-      m#(\d+)-(\d+)-(\d+)\s+(\d+):(\d+)#;
-    my $time = timegm(0,$min,$hour,$mday,$mon-1,$year-1900);
-    # print the timevalue in the local timezone
-    my ($ignore,$wday);
-    ($ignore,$min,$hour,$mday,$mon,$year,$wday) = localtime($time);
-    $boundary_date=sprintf ("%4u-%02u-%02u %02u:%02u",
-                            $year+1900,$mon+1,$mday,$hour,$min);
-  }
-
-  return $boundary_date;
-}
-
-# Don't call this wrap, because with 5.5.3, that clashes with the
-# (unconditional :-( ) export of wrap() from Text::Wrap
-sub mywrap {
-  my ($indent1, $indent2, @text) = @_;
-  # If incoming text looks preformatted, don't get clever
-  my $text = Text::Wrap::wrap($indent1, $indent2, @text);
-  if ( grep /^\s+/m, @text ) {
-    return $text;
-  }
-  my @lines = split /\n/, $text;
-  $indent2 =~ s!^((?: {8})+)!"\t" x (length($1)/8)!e;
-  $lines[0] =~ s/^$indent1\s+/$indent1/;
-  s/^$indent2\s+/$indent2/
-    for @lines[1..$#lines];
-  my $newtext = join "\n", @lines;
-  $newtext .= "\n"
-    if substr($text, -1) eq "\n";
-  return $newtext;
-}
-
-# Fills up a ChangeLog structure in the current directory.
-sub derive_change_log ()
-{
-  # See "The Plan" above for a full explanation.
-
-  my %grand_poobah;
-
-  my $file_full_path;
-  my $time;
-  my $revision;
-  my $author;
-  my $state;
-  my $lines;
-  my $cvsstate;
-  my $msg_txt;
-  my $detected_file_separator;
-
-  my %tag_date_printed;
-
-  # Might be adding to an existing ChangeLog
-  my $accumulation_date = &maybe_grab_accumulation_date ();
-  if ($accumulation_date) {
-    # Insert -d immediately after 'cvs log'
-    my $Log_Date_Command = "-d\'>${accumulation_date}\'";
-    $Log_Source_Command =~ s/(^.*log\S*)/$1 $Log_Date_Command/;
-    &debug ("(adding log msg starting from $accumulation_date)\n");
-  }
-
-  # We might be expanding usernames
-  my %usermap;
-
-  # In general, it's probably not very maintainable to use state
-  # variables like this to tell the loop what it's doing at any given
-  # moment, but this is only the first one, and if we never have more
-  # than a few of these, it's okay.
-  my $collecting_symbolic_names = 0;
-  my %symbolic_names;    # Where tag names get stored.
-  my %branch_names;      # We'll grab branch names while we're at it.
-  my %branch_numbers;    # Save some revisions for @Follow_Branches
-  my @branch_roots;      # For showing which files are branch ancestors.
-
-  # Bleargh.  Compensate for a deficiency of custom wrapping.
-  if (($After_Header ne " ") and $FSF_Style)
-  {
-    $After_Header .= "\t";
-  }
-
-  if (! $Input_From_Stdin) {
-    &debug ("(run \"${Log_Source_Command}\")\n");
-    open (LOG_SOURCE, "$Log_Source_Command |")
-        or die "unable to run \"${Log_Source_Command}\"";
-  }
-  else {
-    open (LOG_SOURCE, "-") or die "unable to open stdin for reading";
-  }
-
-  binmode LOG_SOURCE;
-
-  %usermap = &maybe_read_user_map_file ();
-
-  while (<LOG_SOURCE>)
-  {
-    # Canonicalize line endings
-    s/\r$//;
-    my $new_full_path;
-
-    # If on a new file and don't see filename, skip until we find it, and
-    # when we find it, grab it.
-    if (! (defined $file_full_path))
-    {
-      if (/^Working file: (.*)/) {
-        $new_full_path = $1;
-      } elsif ($RCS_Mode && m|^RCS file: $RCS_Root[/\\](.*),v$|) {
-        $new_full_path = $1;
-      }
-    }
-
-    if (defined $new_full_path)
-    {
-      $file_full_path = $new_full_path;
-      if (@Ignore_Files)
-      {
-        my $base;
-        ($base, undef, undef) = fileparse ($file_full_path);
-        # Ouch, I wish trailing operators in regexps could be
-        # evaluated on the fly!
-        if ($Case_Insensitive) {
-          if (grep ($file_full_path =~ m|$_|i, @Ignore_Files)) {
-            undef $file_full_path;
-          }
-        }
-        elsif (grep ($file_full_path =~ m|$_|, @Ignore_Files)) {
-          undef $file_full_path;
-        }
-      }
-      next;
-    }
-
-    # Just spin wheels if no file defined yet.
-    next if (! $file_full_path);
-
-    # Collect tag names in case we're asked to print them in the output.
-    if (/^symbolic names:$/) {
-      $collecting_symbolic_names = 1;
-      next;  # There's no more info on this line, so skip to next
-    }
-    if ($collecting_symbolic_names)
-    {
-      # All tag names are listed with whitespace in front in cvs log
-      # output; so if see non-whitespace, then we're done collecting.
-      if (/^\S/) {
-        $collecting_symbolic_names = 0;
-      }
-      else    # we're looking at a tag name, so parse & store it
-      {
-        # According to the Cederqvist manual, in node "Tags", tag
-        # names must start with an uppercase or lowercase letter and
-        # can contain uppercase and lowercase letters, digits, `-',
-        # and `_'.  However, it's not our place to enforce that, so
-        # we'll allow anything CVS hands us to be a tag:
-        /^\s+([^:]+): ([\d.]+)$/;
-        my $tag_name = $1;
-        my $tag_rev  = $2;
-
-        # A branch number either has an odd number of digit sections
-        # (and hence an even number of dots), or has ".0." as the
-        # second-to-last digit section.  Test for these conditions.
-        my $real_branch_rev = "";
-        if (($tag_rev =~ /^(\d+\.\d+\.)+\d+$/)   # Even number of dots...
-            and (! ($tag_rev =~ /^(1\.)+1$/)))   # ...but not "1.[1.]1"
-        {
-          $real_branch_rev = $tag_rev;
-        }
-        elsif ($tag_rev =~ /(\d+\.(\d+\.)+)0.(\d+)/)  # Has ".0."
-        {
-          $real_branch_rev = $1 . $3;
-        }
-        # If we got a branch, record its number.
-        if ($real_branch_rev)
-        {
-          $branch_names{$real_branch_rev} = $tag_name;
-          if (@Follow_Branches) {
-            if (grep ($_ eq $tag_name, @Follow_Branches)) {
-              $branch_numbers{$tag_name} = $real_branch_rev;
-            }
-          }
-        }
-        else {
-          # Else it's just a regular (non-branch) tag.
-          push (@{$symbolic_names{$tag_rev}}, $tag_name);
-        }
-      }
-    }
-    # End of code for collecting tag names.
-
-    # If have file name, but not revision, and see revision, then grab
-    # it.  (We collect unconditionally, even though we may or may not
-    # ever use it.)
-    if ((! (defined $revision)) and (/^revision (\d+\.[\d.]+)/))
-    {
-      $revision = $1;
-
-      if (@Follow_Branches)
-      {
-        foreach my $branch (@Follow_Branches)
-        {
-          # Special case for following trunk revisions
-          if (($branch =~ /^trunk$/i) and ($revision =~ /^[0-9]+\.[0-9]+$/))
-          {
-            goto dengo;
-          }
-
-          my $branch_number = $branch_numbers{$branch};
-          if ($branch_number)
-          {
-            # Are we on one of the follow branches or an ancestor of
-            # same?
-            #
-            # If this revision is a prefix of the branch number, or
-            # possibly is less in the minormost number, OR if this
-            # branch number is a prefix of the revision, then yes.
-            # Otherwise, no.
-            #
-            # So below, we determine if any of those conditions are
-            # met.
-
-            # Trivial case: is this revision on the branch?
-            # (Compare this way to avoid regexps that screw up Emacs
-            # indentation, argh.)
-            if ((substr ($revision, 0, ((length ($branch_number)) + 1)))
-                eq ($branch_number . "."))
-            {
-              goto dengo;
-            }
-            # Non-trivial case: check if rev is ancestral to branch
-            elsif ((length ($branch_number)) > (length ($revision))
-                   and
-                   $No_Ancestors)
-            {
-              $revision =~ /^((?:\d+\.)+)(\d+)$/;
-              my $r_left = $1;          # still has the trailing "."
-              my $r_end = $2;
-
-              $branch_number =~ /^((?:\d+\.)+)(\d+)\.\d+$/;
-              my $b_left = $1;  # still has trailing "."
-              my $b_mid  = $2;   # has no trailing "."
-
-              if (($r_left eq $b_left)
-                  && ($r_end <= $b_mid))
-              {
-                goto dengo;
-              }
-            }
-          }
-        }
-      }
-      else    # (! @Follow_Branches)
-      {
-        next;
-      }
-
-      # Else we are following branches, but this revision isn't on the
-      # path.  So skip it.
-      undef $revision;
-    dengo:
-      next;
-    }
-
-    # If we don't have a revision right now, we couldn't possibly
-    # be looking at anything useful.
-    if (! (defined ($revision))) {
-      $detected_file_separator = /^$file_separator$/o;
-      if ($detected_file_separator) {
-        # No revisions for this file; can happen, e.g. "cvs log -d DATE"
-        goto CLEAR;
-      }
-      else {
-        next;
-      }
-    }
-
-    # If have file name but not date and author, and see date or
-    # author, then grab them:
-    unless (defined $time)
-    {
-      if (/^date: .*/)
-      {
-        ($time, $author, $state, $lines) =
-          &parse_date_author_and_state ($_);
-        if (defined ($usermap{$author}) and $usermap{$author}) {
-          $author = $usermap{$author};
-        } elsif(defined $Domain or $Gecos == 1) {
-          my $email = $author;
-          if(defined $Domain && $Domain ne '') {
-            $email = $author."@".$Domain;
-          }
-          my $pw = getpwnam($author);
-          my $fullname;
-          my $office;
-          my $workphone;
-          my $homephone;
-          for (($fullname, $office, $workphone, $homephone) = split /\s*,\s*/, $pw->gecos) {
-            s/&/ucfirst(lc($pw->name))/ge;
-          }
-          if($fullname ne "") {
-            $author = $fullname . "  <" . $email . ">";
-          }
-        }
-      }
-      else {
-        $detected_file_separator = /^$file_separator$/o;
-        if ($detected_file_separator) {
-          # No revisions for this file; can happen, e.g. "cvs log -d DATE"
-          goto CLEAR;
-        }
-      }
-      # If the date/time/author hasn't been found yet, we couldn't
-      # possibly care about anything we see.  So skip:
-      next;
-    }
-
-    # A "branches: ..." line here indicates that one or more branches
-    # are rooted at this revision.  If we're showing branches, then we
-    # want to show that fact as well, so we collect all the branches
-    # that this is the latest ancestor of and store them in
-    # @branch_roots.  Just for reference, the format of the line we're
-    # seeing at this point is:
-    #
-    #    branches:  1.5.2;  1.5.4;  ...;
-    #
-    # Okay, here goes:
-
-    if (/^branches:\s+(.*);$/)
-    {
-      if ($Show_Branches)
-      {
-        my $lst = $1;
-        $lst =~ s/(1\.)+1;|(1\.)+1$//;  # ignore the trivial branch 1.1.1
-        if ($lst) {
-          @branch_roots = split (/;\s+/, $lst);
-        }
-        else {
-          undef @branch_roots;
-        }
-        next;
-      }
-      else
-      {
-        # Ugh.  This really bothers me.  Suppose we see a log entry
-        # like this:
-        #
-        #    ----------------------------
-        #    revision 1.1
-        #    date: 1999/10/17 03:07:38;  author: jrandom;  state: Exp;
-        #    branches:  1.1.2;
-        #    Intended first line of log message begins here.
-        #    ----------------------------
-        #
-        # The question is, how we can tell the difference between that
-        # log message and a *two*-line log message whose first line is
-        #
-        #    "branches:  1.1.2;"
-        #
-        # See the problem?  The output of "cvs log" is inherently
-        # ambiguous.
-        #
-        # For now, we punt: we liberally assume that people don't
-        # write log messages like that, and just toss a "branches:"
-        # line if we see it but are not showing branches.  I hope no
-        # one ever loses real log data because of this.
-        next;
-      }
-    }
-
-    # If have file name, time, and author, then we're just grabbing
-    # log message texts:
-    $detected_file_separator = /^$file_separator$/o;
-    if ($detected_file_separator && ! (defined $revision)) {
-      # No revisions for this file; can happen, e.g. "cvs log -d DATE"
-      goto CLEAR;
-    }
-    unless ($detected_file_separator || /^$logmsg_separator$/o)
-    {
-      $msg_txt .= $_;   # Normally, just accumulate the message...
-      next;
-    }
-    # ... until a msg separator is encountered:
-    # Ensure the message contains something:
-    if ((! $msg_txt)
-        || ($msg_txt =~ /^\s*\.\s*$|^\s*$/)
-        || ($msg_txt =~ /\*\*\* empty log message \*\*\*/))
-    {
-      if ($Prune_Empty_Msgs) {
-        goto CLEAR;
-      }
-      # else
-      $msg_txt = "[no log message]\n";
-    }
-
-    ### Store it all in the Grand Poobah:
-    {
-      my $dir_key;        # key into %grand_poobah
-      my %qunk;           # complicated little jobbie, see below
-
-      # Each revision of a file has a little data structure (a `qunk')
-      # associated with it.  That data structure holds not only the
-      # file's name, but any additional information about the file
-      # that might be needed in the output, such as the revision
-      # number, tags, branches, etc.  The reason to have these things
-      # arranged in a data structure, instead of just appending them
-      # textually to the file's name, is that we may want to do a
-      # little rearranging later as we write the output.  For example,
-      # all the files on a given tag/branch will go together, followed
-      # by the tag in parentheses (so trunk or otherwise non-tagged
-      # files would go at the end of the file list for a given log
-      # message).  This rearrangement is a lot easier to do if we
-      # don't have to reparse the text.
-      #
-      # A qunk looks like this:
-      #
-      #   {
-      #     filename    =>    "hello.c",
-      #     revision    =>    "1.4.3.2",
-      #     time        =>    a timegm() return value (moment of commit)
-      #     tags        =>    [ "tag1", "tag2", ... ],
-      #     branch      =>    "branchname" # There should be only one, right?
-      #     branchroots =>    [ "branchtag1", "branchtag2", ... ]
-      #   }
-
-      if ($Distributed) {
-        # Just the basename, don't include the path.
-        ($qunk{'filename'}, $dir_key, undef) = fileparse ($file_full_path);
-      }
-      else {
-        $dir_key = "./";
-        $qunk{'filename'} = $file_full_path;
-      }
-
-      # This may someday be used in a more sophisticated calculation
-      # of what other files are involved in this commit.  For now, we
-      # don't use it much except for delta mode, because the
-      # common-commit-detection algorithm is hypothesized to be
-      # "good enough" as it stands.
-      $qunk{'time'} = $time;
-
-      # We might be including revision numbers and/or tags and/or
-      # branch names in the output.  Most of the code from here to
-      # loop-end deals with organizing these in qunk.
-
-      $qunk{'revision'} = $revision;
-      $qunk{'state'} = $state;
-      if ( defined( $lines )) {
-        $qunk{'lines'} = $lines;
-      }
-
-      # Grab the branch, even though we may or may not need it:
-      $qunk{'revision'} =~ /((?:\d+\.)+)\d+/;
-      my $branch_prefix = $1;
-      $branch_prefix =~ s/\.$//;  # strip off final dot
-      if ($branch_names{$branch_prefix}) {
-        $qunk{'branch'} = $branch_names{$branch_prefix};
-      }
-
-      # Keep a record of the file's cvs state.
-      $qunk{'cvsstate'} = $state;
-
-      # If there's anything in the @branch_roots array, then this
-      # revision is the root of at least one branch.  We'll display
-      # them as branch names instead of revision numbers, the
-      # substitution for which is done directly in the array:
-      if (@branch_roots) {
-        my @roots = map { $branch_names{$_} } @branch_roots;
-        $qunk{'branchroots'} = \@roots;
-      }
-
-      # Save tags too.
-      if (defined ($symbolic_names{$revision})) {
-        $qunk{'tags'} = $symbolic_names{$revision};
-        delete $symbolic_names{$revision};
-
-        # If we're in 'delta' mode, update the latest observed
-        # times for the beginning and ending tags, and
-        # when we get around to printing output, we will simply restrict
-        # ourselves to that timeframe...
-
-        if ($Delta_Mode) {
-          if (($time > $Delta_StartTime) &&
-              (grep { $_ eq $Delta_From } @{$qunk{'tags'}}))
-          {
-            $Delta_StartTime = $time;
-          }
-
-          if (($time > $Delta_EndTime) &&
-              (grep { $_ eq $Delta_To } @{$qunk{'tags'}}))
-          {
-            $Delta_EndTime = $time;
-          }
-        }
-      }
-
-      unless ($Hide_Branch_Additions and $msg_txt =~ /file \S+ was initially added on branch \S+./) {
-        # Add this file to the list
-        # (We use many spoonfuls of autovivication magic. Hashes and arrays
-        # will spring into existence if they aren't there already.)
-
-        &debug ("(pushing log msg for ${dir_key}$qunk{'filename'})\n");
-
-        # Store with the files in this commit.  Later we'll loop through
-        # again, making sure that revisions with the same log message
-        # and nearby commit times are grouped together as one commit.
-        push (@{$grand_poobah{$dir_key}{$author}{$time}{$msg_txt}}, \%qunk);
-      }
-    }
-
-  CLEAR:
-    # Make way for the next message
-    undef $msg_txt;
-    undef $time;
-    undef $revision;
-    undef $author;
-    undef @branch_roots;
-
-    # Maybe even make way for the next file:
-    if ($detected_file_separator) {
-      undef $file_full_path;
-      undef %branch_names;
-      undef %branch_numbers;
-      undef %symbolic_names;
-    }
-  }
-
-  close (LOG_SOURCE);
-
-  ### Process each ChangeLog
-
-  while (my ($dir,$authorhash) = each %grand_poobah)
-  {
-    &debug ("DOING DIR: $dir\n");
-
-    # Here we twist our hash around, from being
-    #   author => time => message => filelist
-    # in %$authorhash to
-    #   time => author => message => filelist
-    # in %changelog.
-    #
-    # This is also where we merge entries.  The algorithm proceeds
-    # through the timeline of the changelog with a sliding window of
-    # $Max_Checkin_Duration seconds; within that window, entries that
-    # have the same log message are merged.
-    #
-    # (To save space, we zap %$authorhash after we've copied
-    # everything out of it.)
-
-    my %changelog;
-    while (my ($author,$timehash) = each %$authorhash)
-    {
-      my $lasttime;
-      my %stamptime;
-      foreach my $time (sort {$main::a <=> $main::b} (keys %$timehash))
-      {
-        my $msghash = $timehash->{$time};
-        while (my ($msg,$qunklist) = each %$msghash)
-        {
-          my $stamptime = $stamptime{$msg};
-          if ((defined $stamptime)
-              and (($time - $stamptime) < $Max_Checkin_Duration)
-              and (defined $changelog{$stamptime}{$author}{$msg}))
-          {
-            push(@{$changelog{$stamptime}{$author}{$msg}}, @$qunklist);
-          }
-          else {
-            $changelog{$time}{$author}{$msg} = $qunklist;
-            $stamptime{$msg} = $time;
-          }
-        }
-      }
-    }
-    undef (%$authorhash);
-
-    ### Now we can write out the ChangeLog!
-
-    my ($logfile_here, $logfile_bak, $tmpfile);
-
-    if (! $Output_To_Stdout) {
-      $logfile_here =  $dir . $Log_File_Name;
-      $logfile_here =~ s/^\.\/\//\//;   # fix any leading ".//" problem
-      $tmpfile      = "${logfile_here}.cvs2cl$$.tmp";
-      $logfile_bak  = "${logfile_here}.bak";
-
-      open (LOG_OUT, ">$tmpfile") or die "Unable to open \"$tmpfile\"";
-    }
-    else {
-      open (LOG_OUT, ">-") or die "Unable to open stdout for writing";
-    }
-
-    print LOG_OUT $ChangeLog_Header;
-
-    if ($XML_Output) {
-      my $encoding    =
-        length $XML_Encoding ? qq'encoding="$XML_Encoding"' : '';
-      my $version     = 'version="1.0"';
-      my $declaration =
-        sprintf '<?xml %s?>', join ' ', grep length, $version, $encoding;
-      my $root        =
-        $No_XML_Namespace ?
-        '<changelog>'     :
-        '<changelog xmlns="http://www.red-bean.com/xmlns/cvs2cl/">';
-      print LOG_OUT "$declaration\n\n$root\n\n";
-    }
-
-    my @key_list = ();
-    if($Chronological_Order) {
-        @key_list = sort {$main::a <=> $main::b} (keys %changelog);
-    } else {
-        @key_list = sort {$main::b <=> $main::a} (keys %changelog);
-    }
-    foreach my $time (@key_list)
-    {
-      next if ($Delta_Mode &&
-               (($time <= $Delta_StartTime) ||
-                ($time > $Delta_EndTime && $Delta_EndTime)));
-
-      # Set up the date/author line.
-      # kff todo: do some more XML munging here, on the header
-      # part of the entry:
-      my ($ignore,$min,$hour,$mday,$mon,$year,$wday)
-          = $UTC_Times ? gmtime($time) : localtime($time);
-
-      # XML output includes everything else, we might as well make
-      # it always include Day Of Week too, for consistency.
-      if ($Show_Day_Of_Week or $XML_Output) {
-        $wday = ("Sunday", "Monday", "Tuesday", "Wednesday",
-                 "Thursday", "Friday", "Saturday")[$wday];
-        $wday = ($XML_Output) ? "<weekday>${wday}</weekday>\n" : " $wday";
-      }
-      else {
-        $wday = "";
-      }
-
-      my $authorhash = $changelog{$time};
-      if ($Show_Tag_Dates) {
-        my %tags;
-        while (my ($author,$mesghash) = each %$authorhash) {
-          while (my ($msg,$qunk) = each %$mesghash) {
-            foreach my $qunkref2 (@$qunk) {
-              if (defined ($$qunkref2{'tags'})) {
-                foreach my $tag (@{$$qunkref2{'tags'}}) {
-                  $tags{$tag} = 1;
-                }
-              }
-            }
-          }
-        }
-        # Sort here for determinism to ease testing
-        foreach my $tag (sort keys %tags) {
-          if (!defined $tag_date_printed{$tag}) {
-            $tag_date_printed{$tag} = $time;
-            if ($XML_Output) {
-              # NOT YET DONE
-            }
-            else {
-             if ($Show_Times) {
-              printf LOG_OUT ("%4u-%02u-%02u${wday} %02u:%02u  tag %s\n\n",
-                              $year+1900, $mon+1, $mday, $hour, $min, $tag);
-             } else {
-               printf LOG_OUT ("%4u-%02u-%02u${wday}  tag %s\n\n",
-                               $year+1900, $mon+1, $mday, $tag);
-             }
-            }
-          }
-        }
-      }
-      while (my ($author,$mesghash) = each %$authorhash)
-      {
-        # If XML, escape in outer loop to avoid compound quoting:
-        if ($XML_Output) {
-          $author = &xml_escape ($author);
-        }
-
-      FOOBIE:
-        # We sort here to enable predictable ordering for the testing porpoises
-        for my $msg (sort keys %$mesghash)
-        {
-          my $qunklist = $mesghash->{$msg};
-
-          ## MJP: 19.xii.01 : Exclude @ignore_tags
-          for my $ignore_tag (keys %ignore_tags) {
-            next FOOBIE
-              if grep($_ eq $ignore_tag, map(@{$_->{tags}},
-                                             grep(defined $_->{tags},
-                                                  @$qunklist)));
-          }
-          ## MJP: 19.xii.01 : End exclude @ignore_tags
-
-          # show only files with tag --show-tag $show_tag
-          if ( keys %show_tags ) {
-            next FOOBIE
-              if !grep(exists $show_tags{$_}, map(@{$_->{tags}},
-                                                  grep(defined $_->{tags},
-                                                       @$qunklist)));
-          }
-
-          my $files               = &pretty_file_list ($qunklist);
-          my $header_line;          # date and author
-          my $body;                 # see below
-          my $wholething;           # $header_line + $body
-
-          if ($XML_Output) {
-            $header_line =
-                sprintf ("<date>%4u-%02u-%02u</date>\n"
-                         . "${wday}"
-                         . "<time>%02u:%02u</time>\n"
-                         . "<author>%s</author>\n",
-                         $year+1900, $mon+1, $mday, $hour, $min, $author);
-          }
-          else {
-           if ($Show_Times) {
-            $header_line =
-                sprintf ("%4u-%02u-%02u${wday} %02u:%02u  %s\n\n",
-                         $year+1900, $mon+1, $mday, $hour, $min, $author);
-           } else {
-             $header_line =
-                sprintf ("%4u-%02u-%02u${wday}  %s\n\n",
-                         $year+1900, $mon+1, $mday, $author);
-           }
-          }
-
-          $Text::Wrap::huge = 'overflow'
-            if $Text::Wrap::VERSION >= 2001.0130;
-          # Reshape the body according to user preferences.
-          if ($XML_Output)
-          {
-            $msg = &preprocess_msg_text ($msg);
-            $body = $files . $msg;
-          }
-          elsif ($No_Wrap && !$Summary)
-          {
-            $msg = &preprocess_msg_text ($msg);
-            $files = mywrap ("\t", "\t  ", "* $files");
-            $msg =~ s/\n(.+)/\n\t$1/g;
-            unless ($After_Header eq " ") {
-              $msg =~ s/^(.+)/\t$1/g;
-            }
-            $body = $files . $After_Header . $msg;
-          }
-          elsif ($Summary)
-          {
-            my( $filelist, $qunk );
-            my( @DeletedQunks, @AddedQunks, @ChangedQunks );
-
-            $msg = &preprocess_msg_text ($msg);
-            #
-            #     Sort the files (qunks) according to the operation that was
-            # performed.  Files which were added have no line change
-            # indicator, whereas deleted files have state dead.
-            #
-            foreach $qunk ( @$qunklist )
-            {
-              if ( "dead" eq $qunk->{'state'})
-              {
-                push( @DeletedQunks, $qunk );
-              }
-              elsif ( !exists( $qunk->{'lines'}))
-              {
-                push( @AddedQunks, $qunk );
-              }
-              else
-              {
-                push( @ChangedQunks, $qunk );
-              }
-            }
-            #
-            #     The qunks list was  originally in tree search order.  Let's
-            # get that back.  The lists, if they exist, will be reversed upon
-            # processing.
-            #
-
-            #
-            #     Now write the three sections onto $filelist
-            #
-            if ( @DeletedQunks )
-            {
-              $filelist .= "\tDeleted:\n";
-              foreach $qunk ( @DeletedQunks )
-              {
-                $filelist .= "\t\t" . $qunk->{'filename'};
-                $filelist .= " (" . $qunk->{'revision'} . ")";
-                $filelist .= "\n";
-              }
-              undef( @DeletedQunks );
-            }
-            if ( @AddedQunks )
-            {
-              $filelist .= "\tAdded:\n";
-              foreach $qunk ( @AddedQunks )
-              {
-                $filelist .= "\t\t" . $qunk->{'filename'};
-                $filelist .= " (" . $qunk->{'revision'} . ")";
-                $filelist .= "\n";
-              }
-              undef( @AddedQunks );
-            }
-            if ( @ChangedQunks )
-            {
-              $filelist .= "\tChanged:\n";
-              foreach $qunk ( @ChangedQunks )
-              {
-                $filelist .= "\t\t" . $qunk->{'filename'};
-                $filelist .= " (" . $qunk->{'revision'} . ")";
-                $filelist .= ", \"" . $qunk->{'state'} . "\"";
-                $filelist .= ", lines: " . $qunk->{'lines'};
-                $filelist .= "\n";
-              }
-              undef( @ChangedQunks );
-            }
-            chomp( $filelist );
-            $msg =~ s/\n(.*)/\n\t$1/g;
-            unless ($After_Header eq " ") {
-              $msg =~ s/^(.*)/\t$1/g;
-            }
-            $body = $filelist . $After_Header . $msg;
-          }
-          else  # do wrapping, either FSF-style or regular
-          {
-            if ($FSF_Style)
-            {
-              $files = mywrap ("\t", "\t", "* $files");
-
-              my $files_last_line_len = 0;
-              if ($After_Header eq " ")
-              {
-                $files_last_line_len = &last_line_len ($files);
-                $files_last_line_len += 1;  # for $After_Header
-              }
-
-              $msg = &wrap_log_entry
-                  ($msg, "\t", 69 - $files_last_line_len, 69);
-              $body = $files . $After_Header . $msg;
-            }
-            else  # not FSF-style
-            {
-              $msg = &preprocess_msg_text ($msg);
-              $body = $files . $After_Header . $msg;
-              $body = mywrap ("\t", "\t  ", "* $body");
-              $body =~ s/[ \t]+\n/\n/g;
-            }
-          }
-
-          $body =~ s/[ \t]+\n/\n/g;
-          $wholething = $header_line . $body;
-
-          if ($XML_Output) {
-            $wholething = "<entry>\n${wholething}</entry>\n";
-          }
-
-          # One last check: make sure it passes the regexp test, if the
-          # user asked for that.  We have to do it here, so that the
-          # test can match against information in the header as well
-          # as in the text of the log message.
-
-          # How annoying to duplicate so much code just because I
-          # can't figure out a way to evaluate scalars on the trailing
-          # operator portion of a regular expression.  Grrr.
-          if ($Case_Insensitive) {
-            unless ($Regexp_Gate && ($wholething !~ /$Regexp_Gate/oi)) {
-              print LOG_OUT "${wholething}\n";
-            }
-          }
-          else {
-            unless ($Regexp_Gate && ($wholething !~ /$Regexp_Gate/o)) {
-              print LOG_OUT "${wholething}\n";
-            }
-          }
-        }
-      }
-    }
-
-    if ($XML_Output) {
-      print LOG_OUT "</changelog>\n";
-    }
-
-    close (LOG_OUT);
-
-    if (! $Output_To_Stdout)
-    {
-      # If accumulating, append old data to new before renaming.  But
-      # don't append the most recent entry, since it's already in the
-      # new log due to CVS's idiosyncratic interpretation of "log -d".
-      if ($Cumulative && -f $logfile_here)
-      {
-        open (NEW_LOG, ">>$tmpfile")
-            or die "trouble appending to $tmpfile ($!)";
-
-        open (OLD_LOG, "<$logfile_here")
-            or die "trouble reading from $logfile_here ($!)";
-
-        my $started_first_entry = 0;
-        my $passed_first_entry = 0;
-        while (<OLD_LOG>)
-        {
-          if (! $passed_first_entry)
-          {
-            if ((! $started_first_entry)
-                && /^(\d\d\d\d-\d\d-\d\d\s+\d\d:\d\d)/) {
-              $started_first_entry = 1;
-            }
-            elsif (/^(\d\d\d\d-\d\d-\d\d\s+\d\d:\d\d)/) {
-              $passed_first_entry = 1;
-              print NEW_LOG $_;
-            }
-          }
-          else {
-            print NEW_LOG $_;
-          }
-        }
-
-        close (NEW_LOG);
-        close (OLD_LOG);
-      }
-
-      if (-f $logfile_here) {
-        rename ($logfile_here, $logfile_bak);
-      }
-      rename ($tmpfile, $logfile_here);
-    }
-  }
-}
-
-sub parse_date_author_and_state ()
-{
-  # Parses the date/time and author out of a line like:
-  #
-  # date: 1999/02/19 23:29:05;  author: apharris;  state: Exp;
-
-  my $line = shift;
-
-  my ($year, $mon, $mday, $hours, $min, $secs, $author, $state, $rest) =
-    $line =~
-      m#(\d+)/(\d+)/(\d+)\s+(\d+):(\d+):(\d+);\s+author:\s+([^;]+);\s+state:\s+([^;]+);(.*)#
-          or  die "Couldn't parse date ``$line''";
-  die "Bad date or Y2K issues" unless ($year > 1969 and $year < 2258);
-  # Kinda arbitrary, but useful as a sanity check
-  my $time = timegm($secs,$min,$hours,$mday,$mon-1,$year-1900);
-  my $lines;
-  if ( $rest =~ m#\s+lines:\s+(.*)# )
-    {
-      $lines =$1;
-    }
-  return ($time, $author, $state, $lines);
-}
-
-# Here we take a bunch of qunks and convert them into printed
-# summary that will include all the information the user asked for.
-sub pretty_file_list ()
-{
-  if ($Hide_Filenames and (! $XML_Output)) {
-    return "";
-  }
-
-  my $qunksref = shift;
-
-  my @qunkrefs =
-    grep +((! exists $_->{'tags'}                             or
-            ! grep exists $ignore_tags{$_}, @{$_->{'tags'}})        and
-           (! keys %show_tags                                 or
-            (exists $_->{'tags'}                                and
-             grep exists $show_tags{$_}, @{$_->{'tags'}}))
-          ),
-    @$qunksref;
-  my @filenames;
-  my $beauty = "";          # The accumulating header string for this entry.
-  my %non_unanimous_tags;   # Tags found in a proper subset of qunks
-  my %unanimous_tags;       # Tags found in all qunks
-  my %all_branches;         # Branches found in any qunk
-  my $common_dir = undef;   # Dir prefix common to all files ("" if none)
-  my $fbegun = 0;           # Did we begin printing filenames yet?
-
-  # First, loop over the qunks gathering all the tag/branch names.
-  # We'll put them all in non_unanimous_tags, and take out the
-  # unanimous ones later.
- QUNKREF:
-  foreach my $qunkref (@qunkrefs)
-  {
-    # Keep track of whether all the files in this commit were in the
-    # same directory, and memorize it if so.  We can make the output a
-    # little more compact by mentioning the directory only once.
-    if ($Common_Dir && (scalar (@qunkrefs)) > 1)
-    {
-      if (! (defined ($common_dir)))
-      {
-        my ($base, $dir);
-        ($base, $dir, undef) = fileparse ($$qunkref{'filename'});
-
-        if ((! (defined ($dir)))  # this first case is sheer paranoia
-            or ($dir eq "")
-            or ($dir eq "./")
-            or ($dir eq ".\\"))
-        {
-          $common_dir = "";
-        }
-        else
-        {
-          $common_dir = $dir;
-        }
-      }
-      elsif ($common_dir ne "")
-      {
-        # Already have a common dir prefix, so how much of it can we preserve?
-        $common_dir = &common_path_prefix ($$qunkref{'filename'}, $common_dir);
-      }
-    }
-    else  # only one file in this entry anyway, so common dir not an issue
-    {
-      $common_dir = "";
-    }
-
-    if (defined ($$qunkref{'branch'})) {
-      $all_branches{$$qunkref{'branch'}} = 1;
-    }
-    if (defined ($$qunkref{'tags'})) {
-      foreach my $tag (@{$$qunkref{'tags'}}) {
-        $non_unanimous_tags{$tag} = 1;
-      }
-    }
-  }
-
-  # Any tag held by all qunks will be printed specially... but only if
-  # there are multiple qunks in the first place!
-  if ((scalar (@qunkrefs)) > 1) {
-    foreach my $tag (keys (%non_unanimous_tags)) {
-      my $everyone_has_this_tag = 1;
-      foreach my $qunkref (@qunkrefs) {
-        if ((! (defined ($$qunkref{'tags'})))
-            or (! (grep ($_ eq $tag, @{$$qunkref{'tags'}})))) {
-          $everyone_has_this_tag = 0;
-        }
-      }
-      if ($everyone_has_this_tag) {
-        $unanimous_tags{$tag} = 1;
-        delete $non_unanimous_tags{$tag};
-      }
-    }
-  }
-
-  if ($XML_Output)
-  {
-    # If outputting XML, then our task is pretty simple, because we
-    # don't have to detect common dir, common tags, branch prefixing,
-    # etc.  We just output exactly what we have, and don't worry about
-    # redundancy or readability.
-
-    foreach my $qunkref (@qunkrefs)
-    {
-      my $filename    = $$qunkref{'filename'};
-      my $cvsstate    = $$qunkref{'cvsstate'};
-      my $revision    = $$qunkref{'revision'};
-      my $tags        = $$qunkref{'tags'};
-      my $branch      = $$qunkref{'branch'};
-      my $branchroots = $$qunkref{'branchroots'};
-
-      $filename = &xml_escape ($filename);   # probably paranoia
-      $revision = &xml_escape ($revision);   # definitely paranoia
-
-      $beauty .= "<file>\n";
-      $beauty .= "<name>${filename}</name>\n";
-      $beauty .= "<cvsstate>${cvsstate}</cvsstate>\n";
-      $beauty .= "<revision>${revision}</revision>\n";
-      if ($branch) {
-        $branch   = &xml_escape ($branch);     # more paranoia
-        $beauty .= "<branch>${branch}</branch>\n";
-      }
-      foreach my $tag (@$tags) {
-        $tag = &xml_escape ($tag);  # by now you're used to the paranoia
-        $beauty .= "<tag>${tag}</tag>\n";
-      }
-      foreach my $root (@$branchroots) {
-        $root = &xml_escape ($root);  # which is good, because it will continue
-        $beauty .= "<branchroot>${root}</branchroot>\n";
-      }
-      $beauty .= "</file>\n";
-    }
-
-    # Theoretically, we could go home now.  But as long as we're here,
-    # let's print out the common_dir and utags, as a convenience to
-    # the receiver (after all, earlier code calculated that stuff
-    # anyway, so we might as well take advantage of it).
-
-    if ((scalar (keys (%unanimous_tags))) > 1) {
-      foreach my $utag ((keys (%unanimous_tags))) {
-        $utag = &xml_escape ($utag);   # the usual paranoia
-        $beauty .= "<utag>${utag}</utag>\n";
-      }
-    }
-    if ($common_dir) {
-      $common_dir = &xml_escape ($common_dir);
-      $beauty .= "<commondir>${common_dir}</commondir>\n";
-    }
-
-    # That's enough for XML, time to go home:
-    return $beauty;
-  }
-
-  # Else not XML output, so complexly compactify for chordate
-  # consumption.  At this point we have enough global information
-  # about all the qunks to organize them non-redundantly for output.
-
-  if ($common_dir) {
-    # Note that $common_dir still has its trailing slash
-    $beauty .= "$common_dir: ";
-  }
-
-  if ($Show_Branches)
-  {
-    # For trailing revision numbers.
-    my @brevisions;
-
-    foreach my $branch (keys (%all_branches))
-    {
-      foreach my $qunkref (@qunkrefs)
-      {
-        if ((defined ($$qunkref{'branch'}))
-            and ($$qunkref{'branch'} eq $branch))
-        {
-          if ($fbegun) {
-            # kff todo: comma-delimited in XML too?  Sure.
-            $beauty .= ", ";
-          }
-          else {
-            $fbegun = 1;
-          }
-          my $fname = substr ($$qunkref{'filename'}, length ($common_dir));
-          $beauty .= $fname;
-          $$qunkref{'printed'} = 1;  # Just setting a mark bit, basically
-
-          if ($Show_Tags && (defined @{$$qunkref{'tags'}})) {
-            my @tags = grep ($non_unanimous_tags{$_}, @{$$qunkref{'tags'}});
-
-            if (@tags) {
-              $beauty .= " (tags: ";
-              $beauty .= join (', ', @tags);
-              $beauty .= ")";
-            }
-          }
-
-          if ($Show_Revisions) {
-            # Collect the revision numbers' last components, but don't
-            # print them -- they'll get printed with the branch name
-            # later.
-            $$qunkref{'revision'} =~ /.+\.([\d]+)$/;
-            push (@brevisions, $1);
-
-            # todo: we're still collecting branch roots, but we're not
-            # showing them anywhere.  If we do show them, it would be
-            # nifty to just call them revision "0" on a the branch.
-            # Yeah, that's the ticket.
-          }
-        }
-      }
-      $beauty .= " ($branch";
-      if (@brevisions) {
-        if ((scalar (@brevisions)) > 1) {
-          $beauty .= ".[";
-          $beauty .= (join (',', @brevisions));
-          $beauty .= "]";
-        }
-        else {
-          # Square brackets are spurious here, since there's no range to
-          # encapsulate
-          $beauty .= ".$brevisions[0]";
-        }
-      }
-      $beauty .= ")";
-    }
-  }
-
-  # Okay; any qunks that were done according to branch are taken care
-  # of, and marked as printed.  Now print everyone else.
-
-  my %fileinfo_printed;
-  foreach my $qunkref (@qunkrefs)
-  {
-    next if (defined ($$qunkref{'printed'}));   # skip if already printed
-
-    my $b = substr ($$qunkref{'filename'}, length ($common_dir));
-    # todo: Shlomo's change was this:
-    # $beauty .= substr ($$qunkref{'filename'},
-    #              (($common_dir eq "./") ? "" : length ($common_dir)));
-    $$qunkref{'printed'} = 1;  # Set a mark bit.
-
-    if ($Show_Revisions || $Show_Tags || $Show_Dead)
-    {
-      my $started_addendum = 0;
-
-      if ($Show_Revisions) {
-        $started_addendum = 1;
-        $b .= " (";
-        $b .= "$$qunkref{'revision'}";
-      }
-      if ($Show_Dead && $$qunkref{'cvsstate'} =~ /dead/)
-      {
-        # Deliberately not using $started_addendum. Keeping it simple.
-        $b .= "[DEAD]";
-      }
-      if ($Show_Tags && (defined $$qunkref{'tags'})) {
-        my @tags = grep ($non_unanimous_tags{$_}, @{$$qunkref{'tags'}});
-        if ((scalar (@tags)) > 0) {
-          if ($started_addendum) {
-            $b .= ", ";
-          }
-          else {
-            $b .= " (tags: ";
-          }
-          $b .= join (', ', @tags);
-          $started_addendum = 1;
-        }
-      }
-      if ($started_addendum) {
-        $b .= ")";
-      }
-    }
-
-    unless ( exists $fileinfo_printed{$b} ) {
-      if ($fbegun) {
-        $beauty .= ", ";
-      } else {
-        $fbegun = 1;
-      }
-      $beauty .= $b, $fileinfo_printed{$b} = 1;
-    }
-  }
-
-  # Unanimous tags always come last.
-  if ($Show_Tags && %unanimous_tags)
-  {
-    $beauty .= " (utags: ";
-    $beauty .= join (', ', sort keys (%unanimous_tags));
-    $beauty .= ")";
-  }
-
-  # todo: still have to take care of branch_roots?
-
-  $beauty = "$beauty:";
-
-  return $beauty;
-}
-
-sub min ($$) { $_[0] < $_[1] ? $_[0] : $_[1] }
-
-sub common_path_prefix ($$)
-{
-  my ($path1, $path2) = @_;
-
-  # For compatibility (with older versions of cvs2cl.pl), we think in UN*X
-  # terms, and mould windoze filenames to match.  Is this really appropriate?
-  # If a file is checked in under UN*X, and cvs log run on windoze, which way
-  # do the path separators slope?  Can we use fileparse as per the local
-  # conventions?  If so, we should probably have a user option to specify an
-  # OS to emulate to handle stdin-fed logs.  If we did this, we could avoid
-  # the nasty \-/ transmogrification below.
-
-  my ($dir1, $dir2) = map +(fileparse($_))[1], $path1, $path2;
-
-  # Transmogrify Windows filenames to look like Unix.
-  # (It is far more likely that someone is running cvs2cl.pl under
-  # Windows than that they would genuinely have backslashes in their
-  # filenames.)
-  tr!\\!/!
-    for $dir1, $dir2;
-
-  my ($accum1, $accum2, $last_common_prefix) = ('') x 3;
-
-  my @path1 = grep length($_), split qr!/!, $dir1;
-  my @path2 = grep length($_), split qr!/!, $dir2;
-
-  my @common_path;
-  for (0..min($#path1,$#path2)) {
-    if ( $path1[$_] eq $path2[$_]) {
-      push @common_path, $path1[$_];
-    } else {
-      last;
-    }
-  }
-
-  return join '', map "$_/", @common_path;
-}
-
-sub preprocess_msg_text ()
-{
-  my $text = shift;
-
-  # Strip out carriage returns (as they probably result from DOSsy editors).
-  $text =~ s/\r\n/\n/g;
-
-  # If it *looks* like two newlines, make it *be* two newlines:
-  $text =~ s/\n\s*\n/\n\n/g;
-
-  if ($XML_Output)
-  {
-    $text = &xml_escape ($text);
-    chomp $text;
-    $text = "<msg>${text}</msg>\n";
-  }
-  elsif (! $No_Wrap)
-  {
-    # Strip off lone newlines, but only for lines that don't begin with
-    # whitespace or a mail-quoting character, since we want to preserve
-    # that kind of formatting.  Also don't strip newlines that follow a
-    # period; we handle those specially next.  And don't strip
-    # newlines that precede an open paren.
-    1 while ($text =~ s/(^|\n)([^>\s].*[^.\n])\n([^>\n])/$1$2 $3/g);
-
-    # If a newline follows a period, make sure that when we bring up the
-    # bottom sentence, it begins with two spaces.
-    1 while ($text =~ s/(^|\n)([^>\s].*)\n([^>\n])/$1$2  $3/g);
-  }
-
-  return $text;
-}
-
-sub last_line_len ()
-{
-  my $files_list = shift;
-  my @lines = split (/\n/, $files_list);
-  my $last_line = pop (@lines);
-  return length ($last_line);
-}
-
-# A custom wrap function, sensitive to some common constructs used in
-# log entries.
-sub wrap_log_entry ()
-{
-  my $text = shift;                  # The text to wrap.
-  my $left_pad_str = shift;          # String to pad with on the left.
-
-  # These do NOT take left_pad_str into account:
-  my $length_remaining = shift;      # Amount left on current line.
-  my $max_line_length  = shift;      # Amount left for a blank line.
-
-  my $wrapped_text = "";             # The accumulating wrapped entry.
-  my $user_indent = "";              # Inherited user_indent from prev line.
-
-  my $first_time = 1;                # First iteration of the loop?
-  my $suppress_line_start_match = 0; # Set to disable line start checks.
-
-  my @lines = split (/\n/, $text);
-  while (@lines)   # Don't use `foreach' here, it won't work.
-  {
-    my $this_line = shift (@lines);
-    chomp $this_line;
-
-    if ($this_line =~ /^(\s+)/) {
-      $user_indent = $1;
-    }
-    else {
-      $user_indent = "";
-    }
-
-    # If it matches any of the line-start regexps, print a newline now...
-    if ($suppress_line_start_match)
-    {
-      $suppress_line_start_match = 0;
-    }
-    elsif (($this_line =~ /^(\s*)\*\s+[a-zA-Z0-9]/)
-           || ($this_line =~ /^(\s*)\* [a-zA-Z0-9_\.\/\+-]+/)
-           || ($this_line =~ /^(\s*)\([a-zA-Z0-9_\.\/\+-]+(\)|,\s*)/)
-           || ($this_line =~ /^(\s+)(\S+)/)
-           || ($this_line =~ /^(\s*)- +/)
-           || ($this_line =~ /^()\s*$/)
-           || ($this_line =~ /^(\s*)\*\) +/)
-           || ($this_line =~ /^(\s*)[a-zA-Z0-9](\)|\.|\:) +/))
-    {
-      # Make a line break immediately, unless header separator is set
-      # and this line is the first line in the entry, in which case
-      # we're getting the blank line for free already and shouldn't
-      # add an extra one.
-      unless (($After_Header ne " ") and ($first_time))
-      {
-        if ($this_line =~ /^()\s*$/) {
-          $suppress_line_start_match = 1;
-          $wrapped_text .= "\n${left_pad_str}";
-        }
-
-        $wrapped_text .= "\n${left_pad_str}";
-      }
-
-      $length_remaining = $max_line_length - (length ($user_indent));
-    }
-
-    # Now that any user_indent has been preserved, strip off leading
-    # whitespace, so up-folding has no ugly side-effects.
-    $this_line =~ s/^\s*//;
-
-    # Accumulate the line, and adjust parameters for next line.
-    my $this_len = length ($this_line);
-    if ($this_len == 0)
-    {
-      # Blank lines should cancel any user_indent level.
-      $user_indent = "";
-      $length_remaining = $max_line_length;
-    }
-    elsif ($this_len >= $length_remaining) # Line too long, try breaking it.
-    {
-      # Walk backwards from the end.  At first acceptable spot, break
-      # a new line.
-      my $idx = $length_remaining - 1;
-      if ($idx < 0) { $idx = 0 };
-      while ($idx > 0)
-      {
-        if (substr ($this_line, $idx, 1) =~ /\s/)
-        {
-          my $line_now = substr ($this_line, 0, $idx);
-          my $next_line = substr ($this_line, $idx);
-          $this_line = $line_now;
-
-          # Clean whitespace off the end.
-          chomp $this_line;
-
-          # The current line is ready to be printed.
-          $this_line .= "\n${left_pad_str}";
-
-          # Make sure the next line is allowed full room.
-          $length_remaining = $max_line_length - (length ($user_indent));
-
-          # Strip next_line, but then preserve any user_indent.
-          $next_line =~ s/^\s*//;
-
-          # Sneak a peek at the user_indent of the upcoming line, so
-          # $next_line (which will now precede it) can inherit that
-          # indent level.  Otherwise, use whatever user_indent level
-          # we currently have, which might be none.
-          my $next_next_line = shift (@lines);
-          if ((defined ($next_next_line)) && ($next_next_line =~ /^(\s+)/)) {
-            $next_line = $1 . $next_line if (defined ($1));
-            # $length_remaining = $max_line_length - (length ($1));
-            $next_next_line =~ s/^\s*//;
-          }
-          else {
-            $next_line = $user_indent . $next_line;
-          }
-          if (defined ($next_next_line)) {
-            unshift (@lines, $next_next_line);
-          }
-          unshift (@lines, $next_line);
-
-          # Our new next line might, coincidentally, begin with one of
-          # the line-start regexps, so we temporarily turn off
-          # sensitivity to that until we're past the line.
-          $suppress_line_start_match = 1;
-
-          last;
-        }
-        else
-        {
-          $idx--;
-        }
-      }
-
-      if ($idx == 0)
-      {
-        # We bottomed out because the line is longer than the
-        # available space.  But that could be because the space is
-        # small, or because the line is longer than even the maximum
-        # possible space.  Handle both cases below.
-
-        if ($length_remaining == ($max_line_length - (length ($user_indent))))
-        {
-          # The line is simply too long -- there is no hope of ever
-          # breaking it nicely, so just insert it verbatim, with
-          # appropriate padding.
-          $this_line = "\n${left_pad_str}${this_line}";
-        }
-        else
-        {
-          # Can't break it here, but may be able to on the next round...
-          unshift (@lines, $this_line);
-          $length_remaining = $max_line_length - (length ($user_indent));
-          $this_line = "\n${left_pad_str}";
-        }
-      }
-    }
-    else  # $this_len < $length_remaining, so tack on what we can.
-    {
-      # Leave a note for the next iteration.
-      $length_remaining = $length_remaining - $this_len;
-
-      if ($this_line =~ /\.$/)
-      {
-        $this_line .= "  ";
-        $length_remaining -= 2;
-      }
-      else  # not a sentence end
-      {
-        $this_line .= " ";
-        $length_remaining -= 1;
-      }
-    }
-
-    # Unconditionally indicate that loop has run at least once.
-    $first_time = 0;
-
-    $wrapped_text .= "${user_indent}${this_line}";
-  }
-
-  # One last bit of padding.
-  $wrapped_text .= "\n";
-
-  return $wrapped_text;
-}
-
-sub xml_escape ()
-{
-  my $txt = shift;
-  $txt =~ s/&/&/g;
-  $txt =~ s/</</g;
-  $txt =~ s/>/>/g;
-  return $txt;
-}
-
-sub maybe_read_user_map_file ()
-{
-  my %expansions;
-  my $User_Map_Input;
-
-  if ($User_Map_File)
-  {
-    if ( $User_Map_File =~ m{^([-\w\@+=.,\/]+):([-\w\@+=.,\/:]+)} and
-         !-f $User_Map_File )
-    {
-      my $rsh = (exists $ENV{'CVS_RSH'} ? $ENV{'CVS_RSH'} : 'ssh');
-      $User_Map_Input = "$rsh $1 'cat $2' |";
-      &debug ("(run \"${User_Map_Input}\")\n");
-    }
-    else
-    {
-      $User_Map_Input = "<$User_Map_File";
-    }
-
-    open (MAPFILE, $User_Map_Input)
-        or die ("Unable to open $User_Map_File ($!)");
-
-    while (<MAPFILE>)
-    {
-      next if /^\s*#/;  # Skip comment lines.
-      next if not /:/;  # Skip lines without colons.
-
-      # It is now safe to split on ':'.
-      my ($username, $expansion) = split ':';
-      chomp $expansion;
-      $expansion =~ s/^'(.*)'$/$1/;
-      $expansion =~ s/^"(.*)"$/$1/;
-
-      # If it looks like the expansion has a real name already, then
-      # we toss the username we got from CVS log.  Otherwise, keep
-      # it to use in combination with the email address.
-
-      if ($expansion =~ /^\s*<{0,1}\S+ at .*/) {
-        # Also, add angle brackets if none present
-        if (! ($expansion =~ /<\S+@\S+>/)) {
-          $expansions{$username} = "$username <$expansion>";
-        }
-        else {
-          $expansions{$username} = "$username $expansion";
-        }
-      }
-      else {
-        $expansions{$username} = $expansion;
-      }
-    } # fi ($User_Map_File)
-
-    close (MAPFILE);
-  }
-
-  if (defined $User_Passwd_File)
-  {
-    if ( ! defined $Domain ) {
-      if ( -e MAILNAME ) {
-        chomp($Domain = slurp_file(MAILNAME));
-      } else {
-      MAILDOMAIN_CMD:
-        for ([qw(hostname -d)], 'dnsdomainname', 'domainname') {
-          my ($text, $exit, $sig, $core) = run_ext($_);
-          if ( $exit == 0 && $sig == 0 && $core == 0 ) {
-            chomp $text;
-            if ( length $text ) {
-              $Domain = $text;
-              last MAILDOMAIN_CMD;
-            }
-          }
-        }
-      }
-    }
-
-    die "No mail domain found\n"
-      unless defined $Domain;
-
-    open (MAPFILE, "<$User_Passwd_File")
-        or die ("Unable to open $User_Passwd_File ($!)");
-    while (<MAPFILE>)
-    {
-      # all lines are valid
-      my ($username, $pw, $uid, $gid, $gecos, $homedir, $shell) = split ':';
-      my $expansion = '';
-      ($expansion) = split (',', $gecos)
-        if defined $gecos && length $gecos;
-
-      my $mailname = $Domain eq '' ? $username : "$username\@$Domain";
-      $expansions{$username} = "$expansion <$mailname>";
-    }
-    close (MAPFILE);
-  }
-
-  return %expansions;
-}
-
-sub parse_options ()
-{
-  # Check this internally before setting the global variable.
-  my $output_file;
-
-  # If this gets set, we encountered unknown options and will exit at
-  # the end of this subroutine.
-  my $exit_with_admonishment = 0;
-
-  my (@Global_Opts, @Local_Opts);
-
-  while (my $arg = shift (@ARGV))
-  {
-    if ($arg =~ /^-h$|^-help$|^--help$|^--usage$|^-?$/) {
-      $Print_Usage = 1;
-    }
-    elsif ($arg =~ /^--delta$/) {
-      my $narg = shift(@ARGV) || die "$arg needs argument.\n";
-      if ($narg =~ /^([A-Za-z][A-Za-z0-9_\-]*):([A-Za-z][A-Za-z0-9_\-]*)$/) {
-        $Delta_From = $1;
-        $Delta_To = $2;
-        $Delta_Mode = 1;
-      } else {
-        die "--delta FROM_TAG:TO_TAG is what you meant to say.\n";
-      }
-    }
-    elsif ($arg =~ /^--debug$/) {        # unadvertised option, heh
-      $Debug = 1;
-    }
-    elsif ($arg =~ /^--version$/) {
-      $Print_Version = 1;
-    }
-    elsif ($arg =~ /^-g$|^--global-opts$/) {
-      my $narg = shift (@ARGV) || die "$arg needs argument.\n";
-      # Don't assume CVS is called "cvs" on the user's system:
-      push @Global_Opts, $narg;
-      $Log_Source_Command =~ s/(^\S*)/$1 $narg/;
-    }
-    elsif ($arg =~ /^-l$|^--log-opts$/) {
-      my $narg = shift (@ARGV) || die "$arg needs argument.\n";
-      push @Local_Opts, $narg;
-      $Log_Source_Command .= " $narg";
-    }
-    elsif ($arg =~ /^-f$|^--file$/) {
-      my $narg = shift (@ARGV) || die "$arg needs argument.\n";
-      $output_file = $narg;
-    }
-    elsif ($arg =~ /^--accum$/) {
-      $Cumulative = 1;
-    }
-    elsif ($arg =~ /^--update$/) {
-      $Update = 1;
-    }
-    elsif ($arg =~ /^--fsf$/) {
-      $FSF_Style = 1;
-    }
-    elsif ($arg =~ /^--FSF$/) {
-      $Show_Times = 0;
-      $Common_Dir = 0;
-    }
-    elsif ($arg =~ /^--rcs/) {
-      my $narg = shift (@ARGV) || die "$arg needs argument.\n";
-      $RCS_Root = $narg;
-      $RCS_Mode = 1;
-    }
-    elsif ($arg =~ /^-U$|^--usermap$/) {
-      my $narg = shift (@ARGV) || die "$arg needs argument.\n";
-      $User_Map_File = $narg;
-    }
-    elsif ($arg =~ /^--gecos$/) {
-      $Gecos = 1;
-    }
-    elsif ($arg =~ /^--domain$/) {
-      my $narg = shift (@ARGV) || die "$arg needs argument.\n";
-      $Domain = $narg;
-    }
-    elsif ($arg =~ /^--passwd$/) {
-      my $narg = shift (@ARGV) || die "$arg needs argument.\n";
-      $User_Passwd_File = $narg;
-    }
-    elsif ($arg =~ /^--mailname$/) {
-      my $narg = shift (@ARGV) || die "$arg needs argument.\n";
-      warn "--mailname is deprecated; please use --domain instead\n";
-      $Domain = $narg;
-    }
-    elsif ($arg =~ /^-W$|^--window$/) {
-      defined(my $narg = shift (@ARGV)) || die "$arg needs argument.\n";
-      $Max_Checkin_Duration = $narg;
-    }
-    elsif ($arg =~ /^--chrono$/) {
-      $Chronological_Order = 1;
-    }
-    elsif ($arg =~ /^-I$|^--ignore$/) {
-      my $narg = shift (@ARGV) || die "$arg needs argument.\n";
-      push (@Ignore_Files, $narg);
-    }
-    elsif ($arg =~ /^-C$|^--case-insensitive$/) {
-      $Case_Insensitive = 1;
-    }
-    elsif ($arg =~ /^-R$|^--regexp$/) {
-      my $narg = shift (@ARGV) || die "$arg needs argument.\n";
-      $Regexp_Gate = $narg;
-    }
-    elsif ($arg =~ /^--stdout$/) {
-      $Output_To_Stdout = 1;
-    }
-    elsif ($arg =~ /^--version$/) {
-      $Print_Version = 1;
-    }
-    elsif ($arg =~ /^-d$|^--distributed$/) {
-      $Distributed = 1;
-    }
-    elsif ($arg =~ /^-P$|^--prune$/) {
-      $Prune_Empty_Msgs = 1;
-    }
-    elsif ($arg =~ /^-S$|^--separate-header$/) {
-      $After_Header = "\n\n";
-    }
-    elsif ($arg =~ /^--no-wrap$/) {
-      $No_Wrap = 1;
-    }
-    elsif ($arg =~ /^--summary$/) {
-      $Summary = 1;
-      $After_Header = "\n\n"; # Summary implies --separate-header
-    }
-    elsif ($arg =~ /^--gmt$|^--utc$/) {
-      $UTC_Times = 1;
-    }
-    elsif ($arg =~ /^-w$|^--day-of-week$/) {
-      $Show_Day_Of_Week = 1;
-    }
-    elsif ($arg =~ /^--no-times$/) {
-      $Show_Times = 0;
-    }
-    elsif ($arg =~ /^-r$|^--revisions$/) {
-      $Show_Revisions = 1;
-    }
-    elsif ($arg =~ /^--show-dead$/) {
-      $Show_Dead = 1;
-    }
-    elsif ($arg =~ /^--no-hide-branch-additions$/) {
-      $Hide_Branch_Additions = 0;
-    }
-    elsif ($arg =~ /^-t$|^--tags$/) {
-      $Show_Tags = 1;
-    }
-    elsif ($arg =~ /^-T$|^--tagdates$/) {
-      $Show_Tag_Dates = 1;
-    }
-    elsif ($arg =~ /^-b$|^--branches$/) {
-      $Show_Branches = 1;
-    }
-    elsif ($arg =~ /^-F$|^--follow$/) {
-      my $narg = shift (@ARGV) || die "$arg needs argument.\n";
-      push (@Follow_Branches, $narg);
-    }
-    elsif ($arg =~ /^--stdin$/) {
-      $Input_From_Stdin = 1;
-    }
-    elsif ($arg =~ /^--header$/) {
-      my $narg = shift (@ARGV) || die "$arg needs argument.\n";
-      $ChangeLog_Header = &slurp_file ($narg);
-      if (! defined ($ChangeLog_Header)) {
-        $ChangeLog_Header = "";
-      }
-    }
-    elsif ($arg =~ /^--xml-encoding$/) {
-      my $narg = shift (@ARGV) || die "$arg needs argument.\n";
-      $XML_Encoding = $narg ;
-    }
-    elsif ($arg =~ /^--xml$/) {
-      $XML_Output = 1;
-    }
-    elsif ($arg =~ /^--noxmlns$/) {
-      $No_XML_Namespace = 1;
-    }
-    elsif ($arg =~ /^--hide-filenames$/) {
-      $Hide_Filenames = 1;
-      $After_Header = "";
-    }
-    elsif ($arg =~ /^--no-common-dir$/) {
-      $Common_Dir = 0;
-    }
-    elsif ($arg =~ /^--ignore-tag$/ ) {
-      die "$arg needs argument.\n"
-        unless @ARGV;
-      $ignore_tags{shift @ARGV} = 1;
-    }
-    elsif ($arg =~ /^--show-tag$/ ) {
-      die "$arg needs argument.\n"
-        unless @ARGV;
-      $show_tags{shift @ARGV} = 1;
-    }
-    elsif ( lc ($arg) eq '--test-code' ) {
-      # Deliberately undocumented.  This is not a public interface,
-      # and may change/disappear at any time.
-      die "$arg needs argument.\n"
-        unless @ARGV;
-      $TestCode = shift @ARGV;
-    }
-    elsif ($arg =~ /^--no-ancestors$/) {
-      $No_Ancestors = 1;
-    }
-    else {
-      # Just add a filename as argument to the log command
-      $Log_Source_Command .= " '$arg'";
-    }
-  }
-
-  ## Check for contradictions...
-
-  if ($Output_To_Stdout && $Distributed) {
-    print STDERR "cannot pass both --stdout and --distributed\n";
-    $exit_with_admonishment = 1;
-  }
-
-  if ($Output_To_Stdout && $output_file) {
-    print STDERR "cannot pass both --stdout and --file\n";
-    $exit_with_admonishment = 1;
-  }
-
-  if ($Input_From_Stdin && @Global_Opts) {
-    print STDERR "cannot pass both --stdin and -g\n";
-    $exit_with_admonishment = 1;
-  }
-
-  if ($Input_From_Stdin && @Local_Opts) {
-    print STDERR "cannot pass both --stdin and -l\n";
-    $exit_with_admonishment = 1;
-  }
-
-  if ($XML_Output && $Cumulative) {
-    print STDERR "cannot pass both --xml and --accum\n";
-    $exit_with_admonishment = 1;
-  }
-
-  # Or if any other error message has already been printed out, we
-  # just leave now:
-  if ($exit_with_admonishment) {
-    &usage ();
-    exit (1);
-  }
-  elsif ($Print_Usage) {
-    &usage ();
-    exit (0);
-  }
-  elsif ($Print_Version) {
-    &version ();
-    exit (0);
-  }
-
-  ## Else no problems, so proceed.
-
-  if ($output_file) {
-    $Log_File_Name = $output_file;
-  }
-}
-
-sub slurp_file ()
-{
-  my $filename = shift || die ("no filename passed to slurp_file()");
-  my $retstr;
-
-  open (SLURPEE, "<${filename}") or die ("unable to open $filename ($!)");
-  my $saved_sep = $/;
-  undef $/;
-  $retstr = <SLURPEE>;
-  $/ = $saved_sep;
-  close (SLURPEE);
-  return $retstr;
-}
-
-sub debug ()
-{
-  if ($Debug) {
-    my $msg = shift;
-    print STDERR $msg;
-  }
-}
-
-sub version ()
-{
-  print "cvs2cl.pl version ${VERSION}; distributed under the GNU GPL.\n";
-}
-
-sub usage ()
-{
-  &version ();
-  print <<'END_OF_INFO';
-Generate GNU-style ChangeLogs in CVS working copies.
-
-Notes about the output format(s):
-
-   The default output of cvs2cl.pl is designed to be compact, formally
-   unambiguous, but still easy for humans to read.  It is largely
-   self-explanatory, I hope; the one abbreviation that might not be
-   obvious is "utags".  That stands for "universal tags" -- a
-   universal tag is one held by all the files in a given change entry.
-
-   If you need output that's easy for a program to parse, use the
-   --xml option.  Note that with XML output, just about all available
-   information is included with each change entry, whether you asked
-   for it or not, on the theory that your parser can ignore anything
-   it's not looking for.
-
-Notes about the options and arguments (the actual options are listed
-last in this usage message):
-
-  * The -I and -F options may appear multiple times.
-
-  * To follow trunk revisions, use "-F trunk" ("-F TRUNK" also works).
-    This is okay because no would ever, ever be crazy enough to name a
-    branch "trunk", right?  Right.
-
-  * For the -U option, the UFILE should be formatted like
-    CVSROOT/users. That is, each line of UFILE looks like this
-       jrandom:jrandom at red-bean.com
-    or maybe even like this
-       jrandom:'Jesse Q. Random <jrandom at red-bean.com>'
-    Don't forget to quote the portion after the colon if necessary.
-
-  * Many people want to filter by date.  To do so, invoke cvs2cl.pl
-    like this:
-       cvs2cl.pl -l "-d'DATESPEC'"
-    where DATESPEC is any date specification valid for "cvs log -d".
-    (Note that CVS 1.10.7 and below requires there be no space between
-    -d and its argument).
-
-Options/Arguments:
-
-  -h, -help, --help, or -?     Show this usage and exit
-  --version                    Show version and exit
-  -r, --revisions              Show revision numbers in output
-  -b, --branches               Show branch names in revisions when possible
-  -t, --tags                   Show tags (symbolic names) in output
-  -T, --tagdates               Show tags in output on their first occurance
-  --show-dead                  Show dead files
-  --stdin                      Read from stdin, don't run cvs log
-  --stdout                     Output to stdout not to ChangeLog
-  -d, --distributed            Put ChangeLogs in subdirs
-  -f FILE, --file FILE         Write to FILE instead of "ChangeLog"
-  --fsf                        Use this if log data is in FSF ChangeLog style
-  --FSF                        Attempt strict FSF-standard compatible output
-  -W SECS, --window SECS       Window of time within which log entries unify
-  -U UFILE, --usermap UFILE    Expand usernames to email addresses from UFILE
-  --passwd   PASSWORDFILE      Use system passwd file for user name expansion.
-                               If no mail domain is provided (via --domain),
-                               it tries to read one from  /etc/mailname else
-                               output of
-                               hostname -d / dnsdomainname / domainname.  Dies
-                               if none successful.  Use a domain of '' to
-                               prevent the addition of a mail domain.
-  --domain DOMAIN              Domain to build email addresses from
-  --gecos                      Get user information from GECOS data
-  -R REGEXP, --regexp REGEXP   Include only entries that match REGEXP
-  -I REGEXP, --ignore REGEXP   Ignore files whose names match REGEXP
-  -C, --case-insensitive       Any regexp matching is done case-insensitively
-  -F BRANCH, --follow BRANCH   Show only revisions on or ancestral to BRANCH
-  --no-ancestors               When using -F, only track changes since the
-                               BRANCH started
-  --no-hide-branch-additions   By default, entries generated by cvs for a file
-                               added on a branch (a dead 1.1 entry) are not
-                               shown.  This flag reverses that action.
-  -S, --separate-header        Blank line between each header and log message
-  --summary                    Add CVS change summary information
-  --no-wrap                    Don't auto-wrap log message (recommend -S also)
-  --gmt, --utc                 Show times in GMT/UTC instead of local time
-  --accum                      Add to an existing ChangeLog (incompat w/ --xml)
-  -w, --day-of-week            Show day of week
-  --no-times                   Don't show times in output
-  --chrono                     Output log in chronological order
-                               (default is reverse chronological order)
-  --header FILE                Get ChangeLog header from FILE ("-" means stdin)
-  --xml                        Output XML instead of ChangeLog format
-  --xml-encoding ENCODING      Insert encoding clause in XML header
-  --noxmlns                    Don't include xmlns= attribute in root element
-  --hide-filenames             Don't show filenames (ignored for XML output)
-  --no-common-dir              Don't shorten directory names from filenames.
-  --rcs CVSROOT                Handle filenames from raw RCS, for instance
-                               those produced by "cvs rlog" output, stripping
-                               the prefix CVSROOT.
-  -P, --prune                  Don't show empty log messages
-  --ignore-tag TAG             Ignore individual changes that are associated
-                               with a given tag.  May be repeated, if so,
-                               changes that are associated with any of the
-                               given tags are ignored.
-  --show-tag TAG               Log only individual changes that are associated
-                               with a given tag.  May be repeated, if so,
-                               changes that are associated with any of the
-                               given tags are logged.
-  --delta FROM_TAG:TO_TAG      Attempt a delta between two tags (since FROM_TAG
-                               up to & including TO_TAG).  The algorithm is a
-                               simple date-based one (this is a *hard* problem)
-                               so results are imperfect
-  -g OPTS, --global-opts OPTS  Invoke like this "cvs OPTS log ..."
-  -l OPTS, --log-opts OPTS     Invoke like this "cvs ... log OPTS"
-  FILE1 [FILE2 ...]            Show only log information for the named FILE(s)
-
-See http://www.red-bean.com/cvs2cl for maintenance and bug info.
-END_OF_INFO
-}
-
-__END__
-
-=head1 NAME
-
-cvs2cl.pl - produces GNU-style ChangeLogs in CVS working copies, by
-    running "cvs log" and parsing the output.  Shared log entries are
-    unified in an intuitive way.
-
-=head1 DESCRIPTION
-
-This script generates GNU-style ChangeLog files from CVS log
-information.  Basic usage: just run it inside a working copy and a
-ChangeLog will appear.  It requires repository access (i.e., 'cvs log'
-must work).  Run "cvs2cl.pl --help" to see more advanced options.
-
-See http://www.red-bean.com/cvs2cl for updates, and for instructions
-on getting anonymous CVS access to this script.
-
-Maintainer: Karl Fogel <kfogel at red-bean.com>
-Please report bugs to <bug-cvs2cl at red-bean.com>.
-
-=head1 README
-
-This script generates GNU-style ChangeLog files from CVS log
-information.  Basic usage: just run it inside a working copy and a
-ChangeLog will appear.  It requires repository access (i.e., 'cvs log'
-must work).  Run "cvs2cl.pl --help" to see more advanced options.
-
-See http://www.red-bean.com/cvs2cl for updates, and for instructions
-on getting anonymous CVS access to this script.
-
-Maintainer: Karl Fogel <kfogel at red-bean.com>
-Please report bugs to <bug-cvs2cl at red-bean.com>.
-
-=head1 PREREQUISITES
-
-This script requires C<Text::Wrap>, C<Time::Local>, and
-C<File::Basename>.
-It also seems to require C<Perl 5.004_04> or higher.
-
-=pod OSNAMES
-
-any
-
-=pod SCRIPT CATEGORIES
-
-Version_Control/CVS
-
-=cut
-
--*- -*- -*- -*- -*- -*- -*- -*- -*- -*- -*- -*- -*- -*- -*- -*- -*- -*-
-
-Note about a bug-slash-opportunity:
------------------------------------
-
-There's a bug in Text::Wrap, which affects cvs2cl.  This script
-reveals it:
-
-  #!/usr/bin/perl -w
-
-  use Text::Wrap;
-
-  my $test_text =
-  "This script demonstrates a bug in Text::Wrap.  The very long line
-  following this paragraph will be relocated relative to the surrounding
-  text:
-
-  ====================================================================
-
-  See?  When the bug happens, we'll get the line of equal signs below
-  this paragraph, even though it should be above.";
-
-  # Print out the test text with no wrapping:
-  print "$test_text";
-  print "\n";
-  print "\n";
-
-  # Now print it out wrapped, and see the bug:
-  print wrap ("\t", "        ", "$test_text");
-  print "\n";
-  print "\n";
-
-If the line of equal signs were one shorter, then the bug doesn't
-happen.  Interesting.
-
-Anyway, rather than fix this in Text::Wrap, we might as well write a
-new wrap() which has the following much-needed features:
-
-* initial indentation, like current Text::Wrap()
-* subsequent line indentation, like current Text::Wrap()
-* user chooses among: force-break long words, leave them alone, or die()?
-* preserve existing indentation: chopped chunks from an indented line
-  are indented by same (like this line, not counting the asterisk!)
-* optional list of things to preserve on line starts, default ">"
-
-Note that the last two are essentially the same concept, so unify in
-implementation and give a good interface to controlling them.
-
-And how about:
-
-Optionally, when encounter a line pre-indented by same as previous
-line, then strip the newline and refill, but indent by the same.
-Yeah...
-

Modified: trunk/scripts/rsync-ignore
===================================================================
--- trunk/scripts/rsync-ignore	2004-08-09 03:35:48 UTC (rev 824)
+++ trunk/scripts/rsync-ignore	2004-08-09 04:37:51 UTC (rev 825)
@@ -3,3 +3,6 @@
 scripts
 templates
 news-*.txt
+mirrorlist.html
+403.html
+404.html

Modified: trunk/scripts/update-website.mk
===================================================================
--- trunk/scripts/update-website.mk	2004-08-09 03:35:48 UTC (rev 824)
+++ trunk/scripts/update-website.mk	2004-08-09 04:37:51 UTC (rev 825)
@@ -49,18 +49,18 @@
 svn-checkout:
 # The setgid bit on dirs forces all files under it to have the same group of
 # TARGETDIR
-	mkdir -m 2755 -p $(TARGETDIR)
-	chgrp -Rf lfswww $(TARGETDIR)
+	mkdir -m 2755 $(TARGETDIR)
+	chgrp lfswww $(TARGETDIR)
 	svn -q checkout $(SVN)/www/trunk $(TARGETDIR)
-	mkdir -p $(TARGETDIR)/patches/downloads
+	mkdir $(TARGETDIR)/patches/downloads
 	svn -q checkout $(SVN)/patches/trunk $(TARGETDIR)/patches/downloads
-	mkdir -p $(TARGETDIR)/hints/downloads/files
+	mkdir $(TARGETDIR)/hints/downloads/files
 	svn -q checkout $(SVN)/hints/trunk $(TARGETDIR)/hints/downloads/files
-	ln -sf files/ATTACHMENTS $(TARGETDIR)/hints/downloads/attachments
+	ln -s files/ATTACHMENTS $(TARGETDIR)/hints/downloads/attachments
 # Add some compatibility symlinks
-	ln -sf lfs/view $(TARGETDIR)
-	ln -sf images/favicon.ico $(TARGETDIR)
-	ln -sf 2columns.css $(TARGETDIR)/style/screen.css
+	ln -s lfs/view $(TARGETDIR)
+	ln -s images/favicon.ico $(TARGETDIR)
+	ln -s 2columns.css $(TARGETDIR)/style/screen.css
 
 svn-update:
 	svn -q update $(TARGETDIR) -r $(REV)

Deleted: trunk/usermap
===================================================================
--- trunk/usermap	2004-08-09 03:35:48 UTC (rev 824)
+++ trunk/usermap	2004-08-09 04:37:51 UTC (rev 825)
@@ -1,33 +0,0 @@
-alexander:'Alexander Patrakov'
-archaic:'Jeff Colson'
-bdubbs:'Bruce Dubbs'
-billyoc:'Billy O Connor'
-dagmar:'Dagmar d Surreal'
-gerard:'Gerard Beekmans'
-gimli:'Marc Heerdink'
-ian:'Ian Chilton'
-igor:'Igor Zivkovic'
-jamie:'Jamie Bennett'
-jeremy:'Jeremy Utley'
-jeroen:'Jeroen Coumans'
-jim:'Jim Gifford'
-jon:'Jon Ringle'
-jwrober:'James Robertson'
-jyork:'Juan York'
-kpfleming:'Kevin Fleming'
-larry:'Larry Lawrence'
-lizardo:'Anderson Lizardo'
-manuel:'Manuel Canales Esparcia'
-markh:'Mark Hymers'
-matthew:'Matthew Burgess'
-nathan:'Nathan Coulson'
-neven:'Neven Has'
-remenic:'Richard Stellingwerf'
-robert:'Robert Connolly'
-ryan:'Ryan Oliver'
-scot:'Scot Mc Pherson'
-sklein:'Seth Klein'
-thomasp:'Thomas Pegg'
-tushar:'Tushar Teredesai'
-vdzuba:'Vassili Dzuba'
-winkie:'Zack Winkles'




More information about the website mailing list