Release Linux-Proc-Maps 0.001

  * Initial release

diff --git a/Changes b/Changes
index 79dd49f3a811c1f1101b1925d6010a70f0001b60..e4febab26434e5b30bc1d3526191a2b800bd07f6 100644 (file)
--- a/Changes
+++ b/Changes
@@ -2,3 +2,7 @@ Revision history for Linux-Proc-Maps.
 
 {{$NEXT}}
 
+0.001     2016-11-25 22:53:07-07:00 MST7MDT
+
+  * Initial release
+

diff --git a/README.md b/README.md
index cbf3513e6e293ac148c7f70fb3f0543ee67276c7..3bc06f0fbf976f2b2b3b6f52a670b28c2392a089 100644 (file)
--- a/README.md
+++ b/README.md
@@ -25,21 +25,25 @@ This module reads and writes `/proc/[pid]/maps` files that contain listed mapped
 
 # METHODS
 
-## read\_maps %args
+## read\_maps
 
 Read and parse a maps file, returning an arrayref of regions (each represented as a hashref). See
 ["parse\_maps\_single\_line"](#parse_maps_single_line) to see the format of the hashrefs.
 
+    my $regions = read_maps(%args);
+
 Arguments:
 
 - `file` - Path to maps file
 - `pid` - Process ID (one of `file` or `pid` is required)
 - `mnt` - Absolute path where [proc(5)](http://man.he.net/man5/proc) is mounted (optional, default: `/proc`)
 
-## write\_maps \\@regions, %args
+## write\_maps
 
 Returns a string with the contents of a maps file from the memory regions passed.
 
+    my $file_content = write_maps(\@regions, %args);
+
 This is the opposite of ["read\_maps"](#read_maps).
 
 Arguments:
@@ -47,10 +51,12 @@ Arguments:
 - `fh` - Write maps to this open file handle (optional)
 - `file` - Open this filepath and write maps to that file (optional)
 
-## parse\_maps\_single\_line $line
+## parse\_maps\_single\_line
 
 Parse and return a single line from a maps file into a region represented as a hashref.
 
+    my $region = parse_maps_single_line($line);
+
 For example,
 
     # address         perms offset  dev   inode   pathname
@@ -71,10 +77,12 @@ becomes:
         pathname        => '/usr/sbin/gpm',
     }
 
-## format\_maps\_single\_line \\%region
+## format\_maps\_single\_line
 
 Return a single line for a maps file from a region represented as a hashref.
 
+    my $line = format_maps_single_line(\%region);
+
 This is the opposite of ["parse\_maps\_single\_line"](#parse_maps_single_line).
 
 # SEE ALSO