v1.2

README.md

@@ -98,14 +98,14 @@ Copy gztool.c to the directory where you compiled zlib, and do:
 Usage
 =====
 
-      gztool (v1.1.1)
+      gztool (v1.2)
       GZIP files indexer, compressor and data retriever.
       Create small indexes for gzipped files and use them
       for quick and random-positioned data extraction.
       No more waiting when the end of a 10 GiB gzip is needed!
       //github.com/circulosmeos/gztool (by Roberto S. Galende)
 
-      $ gztool [-[abLnsv] #] [-cCdDeEfFhilpPStTwWxX|u[cCdD]] [-I <INDEX>] <FILE>...
+      $ gztool [-[abLnsv] #] [-cCdDeEfFhilpPrRStTwWxX|u[cCdD]] [-I <INDEX>] <FILE>...
 
       Note that actions `-bcStT` proceed to an index file creation (if
       none exists) INTERLEAVED with data flow. As data flow and
@@ -145,6 +145,10 @@ Usage
      -P: like `-p`, but when used with `-[ST]` implies that checking
          for errors in stream is made as quick as possible as the gzip file
          grows. Warning: this may lead to some errors not being patched.
+     -r #: number of bytes to extract when using `-[bL]`.
+         Accepts '0', '0x', and suffixes 'kmgtpe' (^10) 'KMGTPE' (^2).
+     -R #: number of lines to extract when using `-[bL]`.
+         Accepts '0', '0x', and suffixes 'kmgtpe' (^10) 'KMGTPE' (^2).
      -s #: span in uncompressed MiB between index points when
          creating the index. By default is `10`.
      -S: Supervise indicated file: create a growing index,
@@ -420,7 +424,7 @@ Other interesting links
 Version
 =======
 
-This version is **v1.1.1**.
+This version is **v1.2**.
 
 Please, read the *Disclaimer*. In case of any errors, please open an [issue](https://github.com/circulosmeos/gztool/issues).
 

configure.ac

@@ -1,4 +1,4 @@
-AC_INIT([gztool], [1.1.1], [[email protected]])
+AC_INIT([gztool], [1.2], [[email protected]])
 AM_INIT_AUTOMAKE([-Wall -Werror foreign])
 AC_PROG_CC
 AC_PROG_CC_C99

gztool.1

@@ -4,7 +4,7 @@
 .\" First parameter, NAME, should be all caps
 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 .\" other parameters are allowed: see man(7), man(1)
-.TH gztool 1 "Feb 20 2021" "gztool v1.1"
+.TH gztool 1 "Jul 04 2021" "gztool v1.2"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -21,7 +21,7 @@
 gztool \- extract random-positioned data from gzip files, even like `tail -f`
 .SH SYNOPSIS
 .B gztool
-.RI \ [\ [-[abLnsv]\ #]\ [-cCdDeEfFhilpPStTwWxX|u[cCdD]]\ [-I\ <INDEX>]\ ]\ "files"\ ...
+.RI \ [\ [-[abLnsv]\ #]\ [-cCdDeEfFhilpPrRStTwWxX|u[cCdD]]\ [-I\ <INDEX>]\ ]\ "files"\ ...
 .br
 
 Note that actions `-bcStT` proceed to an index file creation (if
@@ -124,6 +124,14 @@ like `-p`, but when used with `-[ST]` implies that checking
 for errors in stream is made as quick as possible as the gzip file
 grows. Warning: this may lead to some errors not being patched.
 .TP
+.BR \-r\ #
+number of bytes to extract when using `-[bL]`.
+Accepts '0', '0x', and suffixes 'kmgtpe' (^10) 'KMGTPE' (^2).
+.TP
+.BR \-R\ #
+number of lines to extract when using `-[bL]`.
+Accepts '0', '0x', and suffixes 'kmgtpe' (^10) 'KMGTPE' (^2).
+.TP
 .BR \-s\ #
 span in uncompressed MiB between index points when
 creating the index. By default is `10`.