From 30c44f15864cc4bcc8902f7536675fab07a1ee19 Mon Sep 17 00:00:00 2001
From: erickson <erickson@dcc99617-32d9-48b4-a31d-7c20da2025e4>
Date: Fri, 11 May 2007 23:10:26 +0000
Subject: [PATCH] fixed some doc strings.  added sample makefile

git-svn-id: svn://svn.open-ils.org/ILS/trunk@7249 dcc99617-32d9-48b4-a31d-7c20da2025e4
---
 OpenSRF/src/java/Makefile                          | 39 ++++++++++++++++++++++
 .../src/java/org/opensrf/net/xmpp/XMPPReader.java  |  1 -
 OpenSRF/src/java/org/opensrf/util/Config.java      |  2 --
 OpenSRF/src/java/org/opensrf/util/JSONReader.java  |  3 +-
 OpenSRF/src/java/org/opensrf/util/JSONWriter.java  |  2 +-
 OpenSRF/src/java/org/opensrf/util/Utils.java       |  2 +-
 6 files changed, 42 insertions(+), 7 deletions(-)
 create mode 100644 OpenSRF/src/java/Makefile

diff --git a/OpenSRF/src/java/Makefile b/OpenSRF/src/java/Makefile
new file mode 100644
index 0000000000..67891e7ade
--- /dev/null
+++ b/OpenSRF/src/java/Makefile
@@ -0,0 +1,39 @@
+#JAVA_LIBS = .:lib:ext/json-jdk1.5-2007-05-01.jar:ext/wstx-asl-3.2.1.jar:ext/stax-api-1.0.1.jar:ext/xercesImpl-1.4.4-2.jar
+JAVA_LIBDIR = .lib
+JAVAC=javac -J-Xmx256m
+JAVA=java -Xmx256m 
+JAVA_LIBS = .:$(JAVA_LIBDIR):ext/json-jdk1.5-2007-05-01.jar:ext/wstx-asl-3.2.1.jar:ext/stax-api-1.0.1.jar
+JAVA_SRC = \
+	org/opensrf/net/xmpp/*.java \
+	org/opensrf/util/*.java \
+	org/opensrf/*.java \
+	org/opensrf/test/*.java 
+
+all:
+	mkdir -p $(JAVA_LIBDIR)
+	$(JAVAC) -d $(JAVA_LIBDIR) -cp $(JAVA_LIBS) $(JAVA_SRC) 2>&1 
+
+# only prints the first 30 lines of errors
+slim:
+	mkdir -p $(JAVA_LIBDIR)
+	$(JAVAC) -d $(JAVA_LIBDIR) -cp $(JAVA_LIBS) $(JAVA_SRC) 2>&1 | head -n 30
+	@echo -e "\nTruncating at 30 lines"
+
+check:
+	mkdir -p $(JAVA_LIBDIR)
+	$(JAVAC) -Xlint:unchecked -d $(JAVA_LIBDIR) -cp $(JAVA_LIBS) $(JAVA_SRC) 2>&1 | head -n 30
+	@echo -e "\nTruncating at 30 lines"
+
+run:
+	$(JAVA) -cp $(JAVA_LIBS) $(JAVA_EXE) $(JAVA_ARGS)
+
+docs:
+	find . -name *.java > files;
+	javadoc -classpath $(JAVA_LIBS) -d doc @files;
+	rm files;
+
+clean:
+	rm -r $(JAVA_LIBDIR)
+	
+
+
diff --git a/OpenSRF/src/java/org/opensrf/net/xmpp/XMPPReader.java b/OpenSRF/src/java/org/opensrf/net/xmpp/XMPPReader.java
index 3c06b1133f..01a4f91309 100644
--- a/OpenSRF/src/java/org/opensrf/net/xmpp/XMPPReader.java
+++ b/OpenSRF/src/java/org/opensrf/net/xmpp/XMPPReader.java
@@ -153,7 +153,6 @@ public class XMPPReader implements Runnable {
 
     /**
      * Parses XML data from the provided XMPP stream.
-     * @param inStream The stream to parse.
      */
     public void read() {
 
diff --git a/OpenSRF/src/java/org/opensrf/util/Config.java b/OpenSRF/src/java/org/opensrf/util/Config.java
index 03de8acf65..7b3a0bf25b 100644
--- a/OpenSRF/src/java/org/opensrf/util/Config.java
+++ b/OpenSRF/src/java/org/opensrf/util/Config.java
@@ -50,7 +50,6 @@ public class Config {
 
     /**
      * Returns the configuration value found at the requested path.
-     * @see org.opensrf.util.Utils.findPath for path description.
      * @param path The search path
      * @return The config value, or null if no value exists at the given path.  
      * @throws ConfigException thrown if nothing is found at the path
@@ -79,7 +78,6 @@ public class Config {
 
     /**
      * Returns the configuration object found at the requested path.
-     * @see org.opensrf.util.Utils.findPath for path description.
      * @param path The search path
      * @return The config value
      * @throws ConfigException thrown if nothing is found at the path
diff --git a/OpenSRF/src/java/org/opensrf/util/JSONReader.java b/OpenSRF/src/java/org/opensrf/util/JSONReader.java
index 634c249435..b115140122 100644
--- a/OpenSRF/src/java/org/opensrf/util/JSONReader.java
+++ b/OpenSRF/src/java/org/opensrf/util/JSONReader.java
@@ -23,7 +23,7 @@ public class JSONReader {
     private String json;
 
     /**
-     * @param The JSON to parse
+     * @param json The JSON to parse
      */
     public JSONReader(String json) {
         this.json = json;
@@ -31,7 +31,6 @@ public class JSONReader {
 
     /**
      * Parses JSON and creates an object.
-     * @param json The JSON string to parse
      * @return The resulting object which may be a List, 
      * Map, Number, String, Boolean, or null
      */
diff --git a/OpenSRF/src/java/org/opensrf/util/JSONWriter.java b/OpenSRF/src/java/org/opensrf/util/JSONWriter.java
index 6af7e3ed57..7cb2cca02d 100644
--- a/OpenSRF/src/java/org/opensrf/util/JSONWriter.java
+++ b/OpenSRF/src/java/org/opensrf/util/JSONWriter.java
@@ -21,7 +21,7 @@ public class JSONWriter {
 
 
     /**
-     * @see write(Object, StringBuffer)
+     * Encodes a java object to JSON.
      */
     public String write() {
         StringBuffer sb = new StringBuffer();
diff --git a/OpenSRF/src/java/org/opensrf/util/Utils.java b/OpenSRF/src/java/org/opensrf/util/Utils.java
index 9bf819f983..159d254706 100644
--- a/OpenSRF/src/java/org/opensrf/util/Utils.java
+++ b/OpenSRF/src/java/org/opensrf/util/Utils.java
@@ -26,7 +26,7 @@ public class Utils {
 
 
     /**
-     * @see escape(String, StringBuffer)
+     * Escapes a string.
      */
     public static String escape(String string) {
         StringBuffer sb = new StringBuffer();
-- 
2.11.0