ronin-hexdump.1 in ronin-2.0.0.beta5

- old
+ new
@@ -308,9 +308,198 @@
 \fBon_cyan\fR
 .IP \(bu 2
 \fBon_white\fR
 .RE
 .LP
+.SH EXAMPLES
+.LP
+.PP
+Hexdump a file:
+.LP
+.nf
+    \[Do] ronin hexdump \[sl]bin\[sl]ls
+    00000000  7f 45 4c 46 02 01 01 00 00 00 00 00 00 00 00 00  \[or]\.ELF\.\.\.\.\.\.\.\.\.\.\.\.\[or]
+    00000010  03 00 3e 00 01 00 00 00 d0 6b 00 00 00 00 00 00  \[or]\.\.>\.\.\.\.\.\.k\.\.\.\.\.\.\[or]
+    00000020  40 00 00 00 00 00 00 00 18 23 02 00 00 00 00 00  \[or]\[at]\.\.\.\.\.\.\.\.\[sh]\.\.\.\.\.\.\[or]
+    00000030  00 00 00 00 40 00 38 00 0d 00 40 00 20 00 1f 00  \[or]\.\.\.\.\[at]\.8\.\.\.\[at]\. \.\.\.\[or]
+    00000040  06 00 00 00 04 00 00 00 40 00 00 00 00 00 00 00  \[or]\.\.\.\.\.\.\.\.\[at]\.\.\.\.\.\.\.\[or]
+    00000050  40 00 00 00 00 00 00 00 40 00 00 00 00 00 00 00  \[or]\[at]\.\.\.\.\.\.\.\[at]\.\.\.\.\.\.\.\[or]
+    \.\.\.
+.fi
+.LP
+.PP
+Hexdump a UTF\-8 data:
+.LP
+.nf
+    \[Do] ronin hexdump \-\-encoding utf8 file\.txt
+    00000000  e8 80 80 e8 80 80 e8 80 80 e8 80 80 e8 80 80 e8  \[or]耀耀耀耀耀\.\[or]
+    00000010  80 80 e8 80 80 e8 80 80                          \[or]\.\.耀耀\[or]
+    00000018
+.fi
+.LP
+.PP
+Control the number of columns:
+.LP
+.nf
+    \[Do] ronin hexdump \-\-columns 10 a\.txt
+    00000000  41 41 41 41 41 41 41 41 41 41  \[or]AAAAAAAAAA\[or]
+    \.\.\.
+.fi
+.LP
+.PP
+Show repeating data instead of omitting them with a \fB*\fR:
+.LP
+.nf
+    \[Do] ronin hexdump \-\-repeating a\.txt
+    00000000  41 41 41 41 41 41 41 41 41 41  \[or]AAAAAAAAAA\[or]
+    0000000a  41 41 41 41 41 41 41 41 41 41  \[or]AAAAAAAAAA\[or]
+    00000014  41 41 41 41 41 41 41 41 41 41  \[or]AAAAAAAAAA\[or]
+.fi
+.LP
+.PP
+Grouping columns together:
+.LP
+.nf
+    \[Do] ronin hexdump \-\-group\-columns 4 \-\-columns 16 abcd\.txt
+    00000000  41 42 43 44  41 42 43 44  41 42 43 44  41 42 43 44  \[or]ABCDABCDABCDABCD\[or]
+    \.\.\.
+.fi
+.LP
+.PP
+Grouping the characters together:
+.LP
+.nf
+    \[Do] ronin hexdump \-\-group\-chars 4 abcd\.txt
+    00000000  41 42 43 44 41 42 43 44 41 42 43 44 41 42 43 44  \[or]ABCD\[or]ABCD\[or]ABCD\[or]ABCD\[or]
+    \.\.\.
+.fi
+.LP
+.PP
+Disabling the characters column:
+.LP
+.nf
+    \[Do] ronin hexdump \-\-no\-chars\-column a\.txt
+    00000000  41 41 41 41 41 41 41 41 41 41 41 41 41 41 41 41
+    \.\.\.
+.fi
+.LP
+.PP
+Print the numbers as decimals (base 10):
+.LP
+.nf
+    \[Do] ronin hexdump \-\-base 10 hello\.txt
+    00000000  104 101 108 108 111   0                                          \[or]hello\.\[or]
+.fi
+.LP
+.PP
+Print the numbers as octals (base 8):
+.LP
+.nf
+    \[Do] ronin hexdump \-\-base 8 hello\.txt
+    00000000  0150 0145 0154 0154 0157 0000                                                    \[or]hello\.\[or]
+.fi
+.LP
+.PP
+Print the numbers as binary (base 2):
+.LP
+.nf
+    \[Do] ronin hexdump \-\-base 2 hello\.txt
+    00000000  01101000 01100101 01101100 01101100 01101111 00000000                                                                                            \[or]hello\.\[or]
+.fi
+.LP
+.PP
+Decode \fBuint32\fR values:
+.LP
+.nf
+    \[Do] ronin hexdump \-\-type uint32 abcd\.txt
+    00000000  44434241 44434241 44434241 44434241  \[or]ABCDABCDABCDABCD\[or]
+    \.\.\.
+.fi
+.LP
+.PP
+Decode \fBuint32\fR (little\-endian) values:
+.LP
+.nf
+    \[Do] ronin hexdump \-\-type uint32\[ru]le abcd\.txt
+    00000000  44434241 44434241 44434241 44434241  \[or]ABCDABCDABCDABCD\[or]
+    \.\.\.
+.fi
+.LP
+.PP
+Decode \fBuint32\fR (big\-endian) values:
+.LP
+.nf
+    \[Do] ronin hexdump \-\-type uint32\[ru]be abcd\.txt
+    00000000  41424344 41424344 41424344 41424344  \[or]ABCDABCDABCDABCD\[or]
+    \.\.\.
+.fi
+.LP
+.PP
+Decode \fBint32\fR values:
+.LP
+.nf
+    \[Do] ronin hexdump \-\-type int32 \-\-base 10 data\.bin
+    00000000       65535         \-1                          \[or]\.\.\.\.\.\.\.\.\[or]
+    00000008
+.fi
+.LP
+.PP
+Decode characters:
+.LP
+.nf
+    \[Do] ronin hexdump \-\-type char hello\.txt
+    00000000    h   e   l   l   o  \e0                                          \[or]hello\.\[or]
+    00000006
+.fi
+.LP
+.PP
+Decode \fBfloat\fR values:
+.LP
+.nf
+    \[Do] ronin hexdump \-\-type float64\[ru]le floats\.bin
+    00000000          0\.000000e\[pl]00         1\.000000e\[pl]00  \[or]\.\.\.\.\.\.\.\.\.\.\.\.\.\.\.?\[or]
+    00000010         \-1\.000000e\[pl]00                  NaN  \[or]\.\.\.\.\.\.\.\.\.\.\.\.\.\.\.\.\[or]
+    \.\.\.
+.fi
+.LP
+.PP
+Skipping to an offset:
+.LP
+.nf
+    \[Do] ronin hexdump \-\-offset 7 data\.bin
+.fi
+.LP
+.PP
+Zero\-pad the data:
+.LP
+.nf
+    \[Do] ronin hexdump \-\-type uint32\[ru]be \-\-zero\-pad abcd\.txt
+    00000000  41424344 41424344 41424344 41424344  \[or]ABCDABCDABCDABCD\[or]
+    00000010  41420000                             \[or]AB\.\.\[or]
+    00000014
+.fi
+.LP
+.PP
+ANSI coloring:
+.LP
+.nf
+    \[Do] ronin hexdump \-\-style\-index white \e
+                    \-\-style\-numeric green \e
+                    \-\-style\-chars cyan \e
+                    data\.bin
+.fi
+.LP
+.PP
+ANSI highlighting:
+.LP
+.nf
+    \[Do] ronin hexdump \-\-highlight\-index \[sl]00\[Do]\[sl]:white,bold \e
+                    \-\-highlight\-numeric \[sl]\(ha\[lB]8\-f\[rB]\[lB]0\-9a\-f\[rB]\[Do]\[sl]:faint \e
+                    \-\-highlight\-numeric \[sl]f\[sl]:cyan \e
+                    \-\-highlight\-numeric 00:black,on\[ru]red \e
+                    \-\-highlight\-chars \[sl]\[lB]\(ha\e\.\[rB]\[pl]\[sl]:green data\.bin
+.fi
+.LP
 .SH AUTHOR
 .LP
 .PP
 Postmodern 
 .MT postmodern\.mod3\[at]gmail\.com
\ No newline at end of file