ram.jar Installation Tutorial

This small installation tutorial describes how to download, install  and use  the library "ram.jar" when invoking standard Java -tools. It does not address the individual features of the library.

Download

https://www.purl.org/stefan_ram/zip/ram.zip

Rebuilding the Archive

Unpack the Zip file and possible an inner Zip file.

Then the ram.jar library can be built and used:

cd src

find . -name *.java -print >sources.txt

javac -d ../lib -source 1.6 -target 1.6 -encoding UTF-8 @sources.txt

cd ..

cd lib

find . -name *.class -print >classes.txt

jar cf ram.jar @classes.txt

javac -classpath .;ram.jar Main.java

java -cp .;ram.jar Main

Instead of the find command, one also might use DIR:

DIR /B /S .java >sources.txt

DIR /B /S .class >sources.txt

The source code version from 2008 contains some Java files that cannot be compile. To built the library, they need to be renamed before compiling the other files.

    In de\dclj\ram\notation\bauer\prescanner rename:

    Cursor.java -> Cursor.txt

    Pretoken.java -> Pretoken.txt

    PretokenListBuilder.java -> PretokenListBuilder.txt

    Autotoken.java -> Autotoken.txt



    In de\dclj\ram\notation\bauer\scanner rename:

    Token.java -> Token.txt



    In de\dclj\ram\notation\bauer\parser rename:

    OperatorToken.java -> OperatorToken.txt

    OperatorStack.java -> OperatorStack.txt



    In de\dclj\ram\system\iteration rename:

    TupleNesting.java -> TupleNesting.txt

    IntegralRange.java -> IntegralRange.txt



    In de\dclj\ram\javax\swing rename:

    GenericMenuItem.java -> GenericMenuItem.txt



    In de\dclj\ram\application\club rename:

    Main.java -> Main.txt

Installation

Unpack the zip file. Find the jar-file in the subdirectory "dist/lib". Possibly, copy (or move) the jar-file to any directory.

(There should be a jar file in the lib directory, but it might be missing sometimes.)

Usage

To use the jar-file, the path to it has to be given as a part of the classpath-argument when calling relevant Java -tools, such as the program "javac" and the program "java". For example,

Two example calls to build a Client

javac -classpath ".;C:\r\f\jar\ram.jar" Client.java

java  -classpath ".;C:\r\f\jar\ram.jar" Client







step 1 in src directory:

DIR /B /S *.java >sources.txt

mkdir ..\build

"C:\Program Files\Java\jdk\bin\javac" -d ..\build -encoding UTF-8 @sources.txt

cd ..\build

DIR /B /S *.class >classes.txt

PAUSE



step 2:

remove the parts before "de" and "optimization" in classes.txt



step 3 in build directory:

jar cf ram.jar @classes.txt

java -cp ram.jar de.dclj.ram.application.james.Main