runtime(doc): regenerate xxd manpage

Commit f6fc255e8d (v9.0.1834) updated xxd.1 but the xxd.man
page wasn't re-generated. So let's just regenerate it now.

Signed-off-by: Christian Brabandt <cb@256bit.org>

runtime/doc/xxd.man

@@ -30,19 +30,19 @@ OPTIONS
        notation.  Thus -c8, -c 8, -c 010 and -cols 8 are all equivalent.
 
        -a | -autoskip
-              Toggle autoskip: A single '*' replaces nul-lines.  Default off.
+              Toggle autoskip: A single '*' replaces NUL-lines.  Default off.
 
        -b | -bits
               Switch to bits (binary digits) dump, rather than hex dump.  This
               option  writes octets as eight digits "1"s and "0"s instead of a
               normal hexadecimal dump. Each line is preceded by a line  number
-              in  hexadecimal and followed by an ascii (or ebcdic) representa‐
+              in  hexadecimal and followed by an ASCII (or EBCDIC) representa‐
               tion. The command line switches -r, -p, -i do not work with this
               mode.
 
        -c cols | -cols cols
               Format  <cols> octets per line. Default 16 (-i: 12, -ps: 30, -b:
-              6). Max 256.  No maxmimum for -ps. With -ps, 0  results  in  one
+              6). Max 256.  No maximum for -ps. With -ps,  0  results  in  one
               long line of output.
 
        -C | -capitalize
@@ -54,18 +54,19 @@ OPTIONS
               to EBCDIC.  This does not change the hexadecimal representation.
               The option is meaningless in combinations with -r, -p or -i.
 
-       -e     Switch to little-endian hexdump.  This option treats byte groups
+       -e     Switch to little-endian  hex  dump.   This  option  treats  byte
-              as words in little-endian byte order.  The default grouping of 4
+              groups as words in little-endian byte order.  The default group‐
-              bytes may be changed using -g.  This option only applies to hex‐
+              ing of 4 bytes may be changed using -g.  This  option  only  ap‐
-              dump,  leaving  the  ASCII (or EBCDIC) representation unchanged.
+              plies to the hex dump, leaving the ASCII (or EBCDIC) representa‐
-              The command line switches -r, -p, -i do not work with this mode.
+              tion unchanged.  The command line switches -r,  -p,  -i  do  not
+              work with this mode.
 
        -g bytes | -groupsize bytes
               Separate  the  output of every <bytes> bytes (two hex characters
-              or eight bit-digits each) by a whitespace.  Specify -g 0 to sup‐
+              or eight bit digits each) by a whitespace.  Specify -g 0 to sup‐
               press grouping.  <Bytes> defaults to 2 in normal mode, 4 in lit‐
               tle-endian mode and 1 in bits mode.  Grouping does not apply  to
-              postscript or include style.
+              PostScript or include style.
 
        -h | -help
               Print  a summary of available commands and exit.  No hex dumping
@@ -87,7 +88,7 @@ OPTIONS
               Add <offset> to the displayed file position.
 
        -p | -ps | -postscript | -plain
-              Output in postscript continuous hexdump  style.  Also  known  as
+              Output  in  PostScript  continuous hex dump style. Also known as
               plain hex dump style.
 
        -r | -revert
@@ -95,9 +96,15 @@ OPTIONS
               not  writing  to stdout, xxd writes into its output file without
               truncating it. Use the combination -r -p to read plain hexadeci‐
               mal dumps without line number information and without a particu‐
-              lar column layout. Additional Whitespace and line-breaks are al‐
+              lar column layout. Additional whitespace and line breaks are al‐
               lowed anywhere.
 
+       -R when
+              In  output the hex-value and the value are both colored with the
+              same color depending on the hex-value. Mostly helping to differ‐
+              entiate  printable and non-printable characters.  when is never,
+              always, or auto.
+
        -seek offset
               When used after -r: revert with <offset> added to file positions
               found in hex dump.
@@ -110,28 +117,27 @@ OPTIONS
               (or if combined with +: before the current stdin file position).
               Without -s option, xxd starts at the current file position.
 
-       -u     Use upper case hex letters. Default is lower case.
+       -u     Use upper-case hex letters. Default is lower-case.
 
        -v | -version
               Show version string.
 
 CAVEATS
-       xxd -r has some builtin magic while evaluating line number information.
+       xxd -r has some built-in magic while evaluating  line  number  informa‐
-       If  the  output  file is seekable, then the linenumbers at the start of
+       tion.   If  the  output  file is seekable, then the line numbers at the
-       each hexdump line may be out of order, lines may be missing,  or  over‐
+       start of each hex dump line may be out of order, lines may be  missing,
-       lapping.  In these cases xxd will lseek(2) to the next position. If the
+       or  overlapping. In these cases xxd will lseek(2) to the next position.
-       output file is not seekable, only  gaps  are  allowed,  which  will  be
+       If the output file is not seekable, only gaps are allowed,  which  will
-       filled by null-bytes.
+       be filled by null-bytes.
 
        xxd -r never generates parse errors. Garbage is silently skipped.
 
        When editing hex dumps, please note that xxd -r skips everything on the
        input line after reading enough columns of hexadecimal data (see option
-       -c).  This  also means, that changes to the printable ascii (or ebcdic)
+       -c).  This  also  means that changes to the printable ASCII (or EBCDIC)
-       columns are always ignored. Reverting a  plain  (or  postscript)  style
+       columns are always ignored. Reverting a plain (or PostScript) style hex
-       hexdump  with  xxd  -r -p does not depend on the correct number of col‐
+       dump  with  xxd -r -p does not depend on the correct number of columns.
-       umns. Here anything that looks like a  pair  of  hex-digits  is  inter‐
+       Here, anything that looks like a pair of hex digits is interpreted.
-       preted.
 
        Note the difference between
        % xxd -i file
@@ -142,7 +148,7 @@ CAVEATS
        "rewind" input.  A '+' makes a difference if the input source is stdin,
        and if stdin's file position is not at the start of  the  file  by  the
        time  xxd  is  started and given its input.  The following examples may
-       help to clarify (or further confuse!)...
+       help to clarify (or further confuse!):
 
        Rewind stdin before reading; needed because the `cat' has already  read
        to the end of stdin.
@@ -154,7 +160,7 @@ CAVEATS
        %  sh -c "dd of=plain_snippet bs=1k count=1; xxd -s +128 > hex_snippet"
        < file
 
-       Hexdump from file position 0x100 ( = 1024-768) on.
+       Hex dump from file position 0x100 (=1024-768) onwards.
        % sh -c "dd of=plain_snippet bs=1k count=1; xxd -s +-768 > hex_snippet"
        < file
 
@@ -169,7 +175,7 @@ EXAMPLES
        Print 3 lines (hex 0x30 bytes) from the end of file.
        % xxd -s -0x30 file
 
-       Print 120 bytes as continuous hexdump with 20 octets per line.
+       Print 120 bytes as a continuous hex dump with 20 octets per line.
        % xxd -l 120 -ps -c 20 xxd.1
        2e54482058584420312022417567757374203139
        39362220224d616e75616c207061676520666f72
@@ -218,8 +224,8 @@ EXAMPLES
        leading bytes are suppressed.
        % echo "010000: 41" | xxd -r -s -0x10000 > file
 
-       Use xxd as a filter within an editor such as vim(1) to hexdump a region
+       Use xxd as a filter within an editor such as vim(1) to hex dump  a  re‐
-       marked between `a' and `z'.
+       gion marked between `a' and `z'.
        :'a,'z!xxd
 
        Use xxd as a filter within an editor such as vim(1) to recover a binary
@@ -254,7 +260,7 @@ SEE ALSO
        uuencode(1), uudecode(1), patch(1)
 
 WARNINGS
-       The tools weirdness matches its creators brain.  Use entirely  at  your
+       The tool's weirdness matches its creator's brain.  Use entirely at your
        own risk. Copy files. Trace it. Become a wizard.
 
 VERSION