Open files in binary mode

This should fix GitHub issue #4.

Additionally, opening in binary mode already forces the ASCII-8BIT
encoding, so there's no need to specify it anymore.

Escape filename when passing it to RCS

Passing the unquoted filename to `co` when expanding keywords would fail
for filenames containing spaces, quotes or other odds and ends. Use the
escape function provided by the Shellwords module to quote it.

Transcode non-UTF-8 log messages

git fast-import assumes that the log messages are in UTF-8, and if this
is not the case strange things can happen (such as truncated log message
and whatnot). Allow the user to specify the encoding of log messages,
and in this case transcode all logs from the specified encoding to
UTF-8.

patch from Jonathan Neider, with one fixup - the emit_committer function has
to be outside the class-functions.

Conflicts:
rcs-fast-export.rb

add a to-do for symbolic revisions.  I label releases, and omit files from
a label when the files have been deleted.

Minor tweaks for expand_keywords

implement --expand-keywords option, which replaces the head/diff text that
was read from the archive file with the output from "co -p", thereby expanding
all of the rcs keywords.

Warn about missing authors in map

Warn (once) for each RCS username that has no corresponding map entry.
The warning can be disabled.

Inspired by a Thomas Dickey <dickey@his.com> patch.

Framework to ignore files

Feature inspired by a Thomas Dickey <dickey@his.com> patch to ignore
files named `RCS` (managed by `permit`).

make that change a little less ugly by using a procedure.
I considered using
$stdout.flush if $stdout.tty?
but that doesn't help in vile, since both stderr/stdout are non-tty's

flush stdout before stderr writes, avoiding confusion when debugging.

Typo in comment

Also search hidden directories for RCS files.

Useful when converting configuration files managed with RCS.

We have no --usage flag, it's called help

Fix date parsing for Ruby 1.9

Only check for empty first diff line if there are diff lines

When an RCS commit is forced, the diff will be empty (no diff lines),
so chomping the first (non-existant) line to check if it's empty will
raise an exception.

Fix by not checking for the emptiness of the first line if there aren't
any lines in the diff.

Set standard output in binary mode

This ensures that in Windows the lines are terminated by a single 0x0a
line ending instead of the DOS/Windows 0x0d 0x0a line ending, which is
not appreciated by git fast-import.

Find the location when the executable is not a symlink

When finding the path to the real `rcs-fast-export.rb`, we can't use
`File.readlink` on its own because it will fail with `Errno::EINVAL` if
`__FILE__` is not a symlink. Rescue with `__FILE__` to catch this case.

Cope with empty initial diff lines

Some malformed RCS files can have an inital empty line in the text block
for diffs, e.g.

    text
    @
    d1 1
    @

instead of

    text
    @d1 1
    @

Survive this by skipping an initial empty line, but alert the user so
they know something fishy is going on.

auxiliary function to alert of (recoverable) errors

Verboser error on malformed diffs

Small introductory blurb on top

Add --version

Add a minimal versioning infrastructure to the script, to assist both
bug reporters (it's easier to report the development version being used,
it's just the output of `rcs-fast-export.rb --version`) and packagers
(which are assumed to set the RFE_VERSION constant to a meaningful
string based on tagged released and whatever else they may feel
appropriate).

There can be multiple branches per line, obviously

Don't misinterpret `branches`

The `branches` keyword indicates which branches depart from the current
revision. Its value should therefore _not_ be stored in the current
commit `branches` set.

Removing this prevents the generation of spurious branches at every
branch point.

Always specify from if present

Not specifying `from` during the export is a useless optimization, and
can in fact cause problems when the commit export sequence jumps between
branches.

Fix previous commit

By supporting one-line branches specification, the previous commit
actually broke support for multi-line specifications. Fix by also
checking for end-of-line right after the `branches` keyword.

Fix branch handling

The script assumed that when the branches keyword had arguments, these
were in subsequent lines; however, this is not always the case: we can
also have

    branches somebranch;

Fix this by catching any lines _starting_ with 'branches ' rather than
just matching the word. This must be done after skipping over empty
branches line, and by re-processing the line after stripping the initial
'branches ' part so that the :branches action processing only finds the
actual branch.

don't trim "RCS" that is part of longer dir name

When a directory is specified on the command line and the program
is converting the names of the input files being processed into output
filenames, don't strip "RCS" off the end unless that's the full name of
the final directory in the input path.

(Before this fix, an input file named something like
"from_RCS/sourcefile,v" have produced an output path of
"from_/sourcefile".)

ignore trailing slash on directory argument

When a directory is specified on the command line, ignore any trailing
slashes on that path name. (Before this fix, including a trailing
slash on a directory name would prevent that path from being stripped
off the front of the output filenames as it should have been.)

Commit.exports(): use #join (to work in Ruby 1.9)

When rcs-fast-export.rb was run in "directory" mode under Ruby 1.9, then
log messages that were output came out in "array" format rather than plain
text, as in
  ["log line 1\n","log line 2\n"]

Switching from ".to_s" to ".join" allows this to work in both Ruby 1.8 and
1.9.

(This is fix is similar to commit 3dbc2f0ee9e36444c6927ad1ec7dc163f08d6f2f
from Jan 12 2011, which makes a similar change to the log messages output
when the script processes a single RCS file.)

steal_username: be more Ruby 1.9-friendly

The closing empty array was making Ruby 1.9 nervous, get rid of it.

Support deleted files

Some RCS derivatives (cs-rcs, cvs) use the 'dead' file state to mark
files that are deleted from a specific revision. Support this.

Preserve commit date during coalesce

Instead of altering the commit date when coalescing commits, keep a
minimum and maximum date that get updated to span the whole time range
from the first to the last commit merged.

Rewrite commit coalescing logic to preserve monotonicity

The previous logic would allow a situation such as A A' B B' C C'
where A' B' and C' could be merged to result in A A* B C violating
history flow for files in B and C.

The new strategy coalesces less commits but the result is (or should be
modulo new bugs) correct.

Allow export of main branch for multi-file repos

Make branches into a Set too

Commit 9698794877f857871b48a1d39afc6f9eb50d2e79 broke the single-file
branch management by causing a failure when branches and symbols were
merged. Fix by making branches into a Set too.

ruby 1.9: Array#to_s != Array#join

Since Ruby 1.9, Array#to_s maps to #inspect of #join, so just use #join,
as it works in both.

ruby 1.9: open RCS file with ASCII-8BIT encoding

Mark TODO about commitid

Apparently, RCS 5.8 and later are going to support commitid (from CVS).
Consider adding this to rcs-fast-export too as it would make life
easier for us.

Suggest a simple "git reset" after import

This is much safer than git reset --hard as it doesn't overwriter local
changes that might be present.

Always coalesce commits if symbols lists are subsets

Commit coalescing is now skipped only if each symbol list has an item
which is not in the other, and --no-symbol-check overrides this. To
speed things up in this sense, the symbols list is now a Set instead of
an Array.

Add some related TODOs and rewrite the warning messages too.

Option to coalesce commits with differing symbol lists

Small help text rewording

Typo fixes and documentation improvements.

Handle fuzzy coalescing errors

Detect failures to coalesce commits fuzzily and inform the user without
crashing.

Atomic merges

Move the tree-merging method to Tree, and make it atomic: if merging
fails, the tree is not updated. Since the error propagates up, and the
tree merge is the first step of a commit merge, commit merges are atomic
too.

Skip unhandled commands correctly

Commands such as access can be multi-line, so keep skipping until we come
across the terminating semicolon.

Fixed bug when binary file changed in RCS.

If the RCS file being tracked is missing a final new-line character, the
program would crash whenever the last line was deleted and then added.

Reproduction steps:

mkdir /tmp/bug_demo && cd /tmp/bug_demo
rcs -i foo.txt
echo -n "foo" > foo.txt
ci foo.txt
co -l foo.txt
echo -n "d" >> foo.txt
ci foo.txt
git init
~/bin/rcs-fast-export.rb foo.txt,v

Added 'expand' to the list of known but unhandled RCS commands.

Proper file modes

Preliminary support for full-repo export

Improve parsing

Some (older?) RCS files have a more lax syntax (e.g. symbols in the same line
as the symbols command itself, multiple symbols per line, etc). Handle this
situation, and take the change to give the parser an overall cleaner approach.
In particular, tell apart unsupported (skipped) commands from unknown ones (abort).

Import entire directories

It is now possible to specify directories instead of files, in which
case the directory structure is descended, importing all RCS-tracked
files, considered with their path relative to the specified directory.

Feature suggested in private communication by David Kettler.

Option to prepend filenames to commit logs

Feature suggested in private comunication by David Kettler.

Suppress two more warnings

* parenthesize an Array explosion
* define :date as an attribute reader since we're going to define the
  :date= writer ourselves

Fix warning about missing parens around arg

Backport Integer#odd? to older Ruby versions

As pointed out by a private communication from Ben Jackson, Integer#odd?
was introduced in Ruby 1.8.7; to make the script runnable on older Ruby
versions, we define the method ourselves if it's missing.

Fix diff index handling

Inserting text at index 0 (a0 N command, to prepend N lines) resulted in
text being appended since the diff index 0 was mapped to Ruby index -1.
The solution is to turn insertions into Array#unshift rather than
Array#<<, so that they can use the same index as the diff, and only
decrementing the diff index for deletions.

Build buffer as an array of arrays

Sanitizing the buffer by splitting buffer entries at newlines causes the
newlines to disappear. A much cleaner solution, which doesn't have this
serious bug, is to turn the buffer into a buffer of arrays of strings,
to be flattened right before the final assignment.

sanitize buffer after ranges of additions

When adding a range of lines, they would be added as a single string
with embedded newlines so as to preserve line indices for subsequent
insertions/deletions. However, such lines need to be split before
loading them into the next revision text buffer, to ensure that
revisions using the new one as diff base find the correct lines.

Export all branches for each revision

Handle symbolic heads

RCS files can contain symbols that don't point to an actual commit;
checking out these symbols retrieves the highest revision with matching
major numbers. Fo example, with symbol SYM:3 and revisions 2.1, 3.1,
3.2, 4.1, checking out SYM results in 3.2 being checked out.

This feature translates pretty straightforwardly to git heads. These
symbols are detected by their missing date and are deleted after
assigning their name as branch to the appropriate revision.

Try to guess the user's name and email

A common use case for RCS fast export is likely to be of a user trying to
convert its RCS histories into git histories. In these cases we don't need an
authors file, since the committer full name and email are information likely
to be found elsewhere.

We look at the git config, but also the gecos entry in the passwd file. As
extreme resources we also peek in their .hgrc and .vimrc files

Document config options in usage

Also read config option rcs.tageachrev

Config before command line

Improve usage

Expand authorsfile path

Also read config option rcs.authorsfile

Implement --authors-file option

Implement --tag-each-rev option

Options infrastructure

Import RCS symbols as lightweight git tags

Fix branch names

Initial commit