more doc

bindings/java/.sigar_shellrc

@@ -23,3 +23,6 @@ alias myag ptql CredName.User.eq=$user.name,State.Name.eq=java,Args.-1.ew=Spider
 #find all java procs except the shell itself
 #($$ is the current process id)
 alias java ptql State.Name.eq=java,Pid.Pid.ne=$$
+
+#find all processes owned by the current user
+alias myproc ptql CredName.User.eq=$user.name

bindings/java/src/net/hyperic/sigar/cmd/CpuInfo.java

@@ -3,6 +3,9 @@ package net.hyperic.sigar.cmd;
 import net.hyperic.sigar.CpuPerc;
 import net.hyperic.sigar.SigarException;
 
+/**
+ * Display cpu information for each cpu found on the system.
+ */
 public class CpuInfo extends SigarCommandBase {
 
     public CpuInfo(Shell shell) {

bindings/java/src/net/hyperic/sigar/cmd/Df.java

@@ -11,6 +11,9 @@ import net.hyperic.sigar.FileSystemUsage;
 import net.hyperic.sigar.shell.FileCompleter;
 import net.hyperic.sigar.util.GetlineCompleter;
 
+/**
+ * Report filesytem disk space usage.
+ */
 public class Df extends SigarCommandBase {
 
     private static final String OUTPUT_FORMAT =

bindings/java/src/net/hyperic/sigar/cmd/Free.java

@@ -4,6 +4,9 @@ import net.hyperic.sigar.Mem;
 import net.hyperic.sigar.Swap;
 import net.hyperic.sigar.SigarException;
 
+/**
+ * Display amount of free and used memory in the system.
+ */
 public class Free extends SigarCommandBase {
 
     public Free(Shell shell) {

bindings/java/src/net/hyperic/sigar/cmd/Ifconfig.java

@@ -9,6 +9,9 @@ import net.hyperic.sigar.NetInterfaceConfig;
 import net.hyperic.sigar.NetInterfaceStat;
 import net.hyperic.sigar.NetFlags;
 
+/**
+ * Display network interface configuration and metrics.
+ */
 public class Ifconfig extends SigarCommandBase {
 
     public Ifconfig(Shell shell) {

bindings/java/src/net/hyperic/sigar/cmd/Kill.java

@@ -2,6 +2,9 @@ package net.hyperic.sigar.cmd;
 
 import net.hyperic.sigar.SigarException;
 
+/**
+ * Send a signal to a process.
+ */
 public class Kill extends SigarCommandBase {
 
     public Kill(Shell shell) {

bindings/java/src/net/hyperic/sigar/cmd/Netstat.java

@@ -5,6 +5,9 @@ import net.hyperic.sigar.SigarException;
 import net.hyperic.sigar.NetConnection;
 import net.hyperic.sigar.NetFlags;
 
+/**
+ * Display network connections.
+ */
 public class Netstat extends SigarCommandBase {
 
     public Netstat(Shell shell) {
@@ -20,7 +23,7 @@ public class Netstat extends SigarCommandBase {
     }
 
     public String getUsageShort() {
-        return "Show network connections";
+        return "Display network connections";
     }
 
     //poor mans getopt.

bindings/java/src/net/hyperic/sigar/cmd/PTQL.java

@@ -22,6 +22,10 @@ import net.hyperic.sigar.shell.ShellCommandInitException;
 import net.hyperic.sigar.shell.ShellCommandHandler;
 import net.hyperic.sigar.shell.ShellCommandUsageException;
 
+/**
+ * Run process table queries.
+ * @see net.hyperic.sigar.ptql.ProcessQueryBuilder
+ */
 public class PTQL
     extends MultiwordShellCommand
     implements GetlineCompleter {

bindings/java/src/net/hyperic/sigar/cmd/ProcFileInfo.java

@@ -5,6 +5,9 @@ import net.hyperic.sigar.SigarException;
 import net.hyperic.sigar.ProcFd;
 import net.hyperic.sigar.ProcExe;
 
+/**
+ * Display process file information.
+ */
 public class ProcFileInfo extends SigarCommandBase {
 
     public ProcFileInfo(Shell shell) {

bindings/java/src/net/hyperic/sigar/cmd/ProcModuleInfo.java

@@ -6,6 +6,9 @@ import net.hyperic.sigar.Sigar;
 import net.hyperic.sigar.SigarException;
 import net.hyperic.sigar.SigarNotImplementedException;
 
+/**
+ * Display process module info.
+ */
 public class ProcModuleInfo extends SigarCommandBase {
 
     public ProcModuleInfo(Shell shell) {

bindings/java/src/net/hyperic/sigar/cmd/Ps.java

@@ -14,6 +14,9 @@ import java.util.List;
 import java.text.SimpleDateFormat;
 import java.util.Date;
 
+/**
+ * Show process status.
+ */
 public class Ps extends SigarCommandBase {
 
     public Ps(Shell shell) {

bindings/java/src/net/hyperic/sigar/cmd/ShowArgs.java

@@ -3,6 +3,9 @@ package net.hyperic.sigar.cmd;
 import net.hyperic.sigar.SigarException;
 import net.hyperic.sigar.SigarNotImplementedException;
 
+/**
+ * Show process command line arguments.
+ */
 public class ShowArgs extends SigarCommandBase {
 
     public ShowArgs(Shell shell) {

bindings/java/src/net/hyperic/sigar/cmd/ShowEnv.java

@@ -5,6 +5,9 @@ import java.util.Iterator;
 
 import net.hyperic.sigar.SigarException;
 
+/**
+ * Show process environment.
+ */
 public class ShowEnv extends SigarCommandBase {
 
     public ShowEnv(Shell shell) {

bindings/java/src/net/hyperic/sigar/cmd/Tail.java

@@ -10,6 +10,9 @@ import net.hyperic.sigar.FileInfo;
 import net.hyperic.sigar.FileTail;
 import net.hyperic.sigar.FileWatcherThread;
 
+/**
+ * Display the last part of files to the standard output.
+ */
 public class Tail {
 
     public static void main(String[] args) throws SigarException {

bindings/java/src/net/hyperic/sigar/cmd/Top.java

@@ -10,8 +10,15 @@ import net.hyperic.sigar.ProcCpu;
 import net.hyperic.sigar.CurrentProcessSummary;
 
 /**
- * Example:<br>
+ * Display system resource utilization summaries and process information.
+ * <p>
+ * This version of the top command requires a ptql query to select which
+ * processes to display.
+ *
+ * Example to display java processes only:<br>
  * <code>% java -jar sigar-bin/lib/sigar.jar Top State.Name.eq=java</code>
+ *
+ * @see net.hyperic.sigar.ptql.ProcessQueryBuilder
  */
 public class Top {
     private static final int SLEEP_TIME = 1000 * 5;

bindings/java/src/net/hyperic/sigar/cmd/Uptime.java

@@ -8,6 +8,9 @@ import net.hyperic.sigar.util.PrintfFormat;
 import java.text.SimpleDateFormat;
 import java.util.Date;
 
+/**
+ * Display how long the system has been running and the current load averages.
+ */
 public class Uptime extends SigarCommandBase {
 
     private static Object[] loadAvg = new Object[3];
@@ -24,7 +27,7 @@ public class Uptime extends SigarCommandBase {
     }
 
     public String getUsageShort() {
-        return "Show how long the system has been running";
+        return "Display how long the system has been running";
     }
 
     public void output(String[] args) throws SigarException {

bindings/java/src/net/hyperic/sigar/cmd/Version.java

@@ -7,6 +7,9 @@ import java.net.UnknownHostException;
 import net.hyperic.sigar.Sigar;
 import net.hyperic.sigar.SigarException;
 
+/**
+ * Display Sigar, java and system version information.
+ */
 public class Version extends SigarCommandBase {
     private static String[] SYS_PROPS = {
         "os.name",

bindings/java/src/net/hyperic/sigar/cmd/Watch.java

@@ -12,6 +12,9 @@ import net.hyperic.sigar.FileInfo;
 import net.hyperic.sigar.FileWatcher;
 import net.hyperic.sigar.FileWatcherThread;
 
+/**
+ * Watch a file or directory displaying attribute changes.
+ */
 public class Watch {
 
     private static void printHeader(Sigar sigar, FileInfo info)