doc: update the README and man page

Mention the -t option and simplify the information presented

Author: pixelb

README.md

@@ -9,7 +9,7 @@ but for backwards compatible reasons the ps_mem name remains.
 Usage:
 
 ```
-ps_mem [-h|--help] [-s|--split-args] [-p PID] [-w N]
+ps_mem [-h|--help] [-p PID,...] [-s|--split-args] [-t|--total] [-w N]
 ```
 
 Example output:
@@ -27,7 +27,7 @@ Example output:
 =================================
 ```
 
-The [-p PID] option allows filtering the results.
+The [-p PID,...] option allows filtering the results.
 For example to restrict output to the current $USER you could:
 
 ```

ps_mem.1

@@ -1,11 +1,10 @@
-.\" Simple man page to ps_mem.py script
+.\" Simple man page to ps_mem script
 .\" Contact [email protected]
-.TH ps_mem 1 "31 July 2013" "" ""
+.TH ps_mem 1 "04 October 2014" "" ""
 .SH NAME
 ps_mem \- Memory profiling tool
 .SH SYNOPSIS
-.B ps_mem
-[\-h|\-\-help] [\-s|\-\-split\-args] [\-p PID] [\-w N]
+.B ps_mem [OPTION]...
 .SH DESCRIPTION
 Display the core memory used per program (not per process)
 .br
@@ -14,7 +13,9 @@ In detail it reports:
 .br
 .PP
 .RS
-sum(private RAM for program processes) + sum(Shared RAM for program processes).
+sum (private RAM for program processes) +
+.br
+sum (shared RAM for program processes)
 .br
 .RE
 .PP
@@ -24,12 +25,15 @@ The shared RAM is problematic to calculate, and the tool automatically selects t
 \-h \-\-help
 Show help message
 .TP
+\-p PID[,PID2,...PIDN]
+Show memory consumption for the specified processes
+.TP
 \-s \-\-split\-args
 Show and separate memory usage entries by command line arguments
 and not just the program name.
 .TP
-\-p PID
-Show memory consumption of process with specified PID
+\-t \-\-total
+Only display the total number of bytes for the selected processes
 .TP
 \-w N
 Report memory consumption every N seconds

ps_mem.py

@@ -176,7 +176,7 @@ def parse_options():
     return (split_args, pids_to_show, watch, only_total)
 
 def help():
-    help_msg = 'ps_mem.py - Show process memory usage\n'\
+    help_msg = 'ps_mem - Show process memory usage\n'\
     '\n'\
     '-h                            Show this help\n'\
     '-w <N>                        Measure and show process memory every N seconds\n'\