EditLinks: edit the links in a set of HTML files

NAME
EditLinks: a utility to edit the links in a set of HTML files, for use when the files being referenced have been moved.

SYNOPSIS
java -classpath javatest.jar com.sun.javatest.EditLinks options file...

AVAILABILITY
EditLinks is a Java program distributed with JavaTest, in the main jar file for JavaTest, javatest.jar.

DESCRIPTION
EditLinks reads one or more files or directories and copies them to new file or directory. Files whose name ends with ".html" are checked to see if they contain any HTML links that begin with certain filenames. Any that do are rewritten with a corresponding different filename. All other files are copied without change.

OPTIONS
The various options are as follows:
-e oldPrefix newPrefix
Any links that begin with the string oldPrefix are rewritten to begin with newPrefix. Note that only the target of the link is rewritten, and not the presentation text. Thus the edit is effectively transparent when the file is viewed in a browser. Multiple -e options may be given; when editing a file, the options are checked in the order they are given.

For example, if the argument

    -e /work/ /java/jck-dev/scratch/12Jun00/jck-lab3/
            
is used on a file that contains the following segment:
    <a href="/work/api/java_lang/results.jtr">/work/api/java_lang/results.jtr</a>
            
the text shown bold below will match:
    <a href="/work/api/java_lang/results.jtr">/work/api/java_lang/results.jtr</a>
            
and the resulting new file will contain the following:
    <a href="/java/jck-dev/scratch/12Jun00/jck-lab3/api/java_lang/results.jtr">/work/api/java_lang/results.jtr</a>
            

-ignore file
When scanning directories, ignore any entries named file. Multiple -ignore may be given.

For example, '-ignore SCCS' will cause any directories named SCCS to be ignored.

-o file
The output file or directory. The output may only be a file if the input is a single file; otherwise, the output should be a directory into which the edited copies of the input files will be placed.

file...
The input files to be edited. If any of the specified files are directories, they will be recursively copied to the output directory, and any HTML files within them updated.

RETURN CODE
The program will exit with one of the following return codes:
0the copy was successful
1there was a problem with the command line arguments
2an error occurred while trying to perform the copy