Merge pull request #2 from LewisODB/dev

Document project provenance

Author: aadimator

.gitignore

@@ -14,6 +14,7 @@ hs_err_pid*
 /.classpath
 /build/*
 /bin/
+/.gradle/
 *.gradle/
 /gradle.properties
 /site/

.gradle/2.10/taskArtifacts/cache.properties

@@ -3,6 +3,17 @@ Thank you for downloading the Omniscient Debugger (the ODB), the Java debugger t
 "backwards in time" so you can examine your program's execution.
 Also please visit the project [website](http://omniscientdebugger.github.io/)
 
+# Provenance
+
+The Omniscient Debugger was originally written by Bil Lewis. This repository
+continues that work under the LewisODB organization.
+
+This codebase was restarted from the community-maintained
+[OmniscientDebugger/LewisOmniscientDebugger](https://github.com/OmniscientDebugger/LewisOmniscientDebugger)
+repository, which preserved and modernized the project after the original
+distribution. We gratefully acknowledge that work and the contributors whose
+history is preserved in Git.
+
 # System Requirements
 ODB 1.4 works on code complied for JDK 1.3 and 1.4. ODB 1.5 works on code compiled for JDK 1.5. 
 I have tested it on 1.6 and it works. Code compiled for Java 7 and up use invokedetatch, which seems to cause problems at the moment. See [Issue](https://github.com/OmniscientDebugger/LewisOmniscientDebugger/issues/1):  The Jar's compiled for 1.6 and older do work on the 1.8 JVM. 
@@ -70,7 +81,7 @@ mkdocs build --strict
 # Development
 Here is how to build and run the debug the debugger step
 ```
-git clone https://github.com/OmniscientDebugger/LewisOmniscientDebugger.git
+git clone https://github.com/LewisODB/OmniscientDebugger.git
 
 gradle jar
 

.gradle/2.10/taskArtifacts/cache.properties.lock

@@ -289,8 +289,8 @@ Here is a sample. All of the lines may have duplicate entires (e.g., the DontIns
     StartPattern:
     StopPattern:
     SourceDirectory:    
-    OnlyInstrument:         "org.apache"
-    OnlyInstrument:         "fr.emn.info.eaop.cps"
+    OnlyInstrument:         "org.apache."
+    OnlyInstrument:         "fr.emn.info.eaop.cps."
     DontInstrument:         "recoder.java.declaration.TypeDeclaration"
     DontInstrumentMethod:       "*   toString"
     DontInstrumentMethod:       "*   valueOf"
@@ -303,7 +303,7 @@ Here is a sample. All of the lines may have duplicate entires (e.g., the DontIns
 
 You may request some objects to include a field value in their print string by setting the user selected field as above. The field choosen must be a primitive and must not change.
 
-The ODB will write out a "`DidntInstrument/OnlyInstrument`" line for every single class loaded. This makes it easier to change the set of classes being instrumented. By default, only the classes in the package of the "main" method are instrumented.
+The ODB will write out a "`DidntInstrument/OnlyInstrument`" line for every single class loaded. This makes it easier to change the set of classes being instrumented. By default, only the classes in the package of the "main" method are instrumented. A trailing dot means a package prefix, such as `"java_programs."`; package-only lists let the runtime loader delegate non-matching classes to the parent loader.
 
 ## Finding the Source Code
 

.gradle/2.10/taskArtifacts/fileHashes.bin

@@ -166,7 +166,7 @@ public final class Debugify implements Constants {
             NO_ATHROW = false, NO_CATCH = false, NO_INVOKESTATIC = false,
             NO_NEW = false, NO_AASTORE = false, NO_PREVIOUS = false,
             NO_LOCKS = false, NO_WAITS = false, DONT_REPLACE_VECTOR = false;
-    static VectorD dontRecord, dontInstrument, instrumentOnlyPackages;
+    static VectorD dontRecord, dontInstrument;
     static CodeExceptionGen[] ceg;
     static String classPackageName, className, classNoNumbers;
 
@@ -291,7 +291,6 @@ public static void initialize() {
         // Read the file for methods not to record
         dontInstrument = Defaults.dontInstrument;
         // Read the file for methods not to instrument
-        instrumentOnlyPackages = Defaults.instrumentOnlyPackages;
     }
 
     public static JavaClass debugifyClass(JavaClass javaClass1,
@@ -569,24 +568,7 @@ public static JavaClass publicifyClass(JavaClass javaClass1,
     static boolean dontProcessPackage(String cName) {
         if (calledFromDebugify)
             return false; // If this is a direct request, do it!
-        int len = instrumentOnlyPackages.size();
-        if (len == 0)
-            return false;
-
-        for (int i = 0; i < len; i++) {
-            String iOnly = (String) instrumentOnlyPackages.elementAt(i);
-            // Debugger.println("only methods: " + cName + "."+ "? startswith "
-            // + iOnly);
-            if (iOnly.equals("")) {
-                int dot = cName.indexOf(".");
-                if (dot == -1)
-                    return false;
-            } else if (cName.startsWith(iOnly))
-                return false;
-        }
-        if (!Defaults.didntInstrument.contains(cName))
-            Defaults.didntInstrument.add(cName);
-        return true;
+        return Defaults.instrumentOnlyExcludes(cName, false);
     }
 
     static boolean dontProcessMethod(VectorD cmPairs, String mName,