Přemysl Eric Janouch
00d6c5ede9
This deduplicates code between nncmpp and hex, while adding functionality.
86 lines
2.0 KiB
Plaintext
86 lines
2.0 KiB
Plaintext
hex(1)
|
|
======
|
|
:doctype: manpage
|
|
:manmanual: hex Manual
|
|
:mansource: hex {release-version}
|
|
|
|
Name
|
|
----
|
|
hex - Interpreting hex viewer
|
|
|
|
Synopsis
|
|
--------
|
|
*hex* [_OPTION_]... [_PATH_]
|
|
|
|
Description
|
|
-----------
|
|
*hex* is a hex viewer that uses Lua scripts to interpret fields within files,
|
|
colorizes them, and shows their descriptions on the side.
|
|
|
|
When run without arguments, it reads from its standard input stream.
|
|
|
|
Options
|
|
-------
|
|
*-o*, *--offset* _OFFSET_::
|
|
Byte offset into the file. All preceding data will be ignored.
|
|
|
|
*-s*, *--size* _SIZE_::
|
|
Size limit in bytes. Any following data will be ignored.
|
|
+
|
|
The _SIZE_ argument accepts similar suffixes as in *dd*(1): _c_=1,
|
|
_w_=2, _b_=512, _K_=1024, _KB_=1000, _M_=1024K, _MB_=1000KB,
|
|
_G_=1024M, and _GB_=1000M. The default value is 1G.
|
|
|
|
*-t*, *--type* _TYPE_::
|
|
Force interpretation as the given type, skipping autodetection.
|
|
Pass in "list" for a listing of all available decoders.
|
|
|
|
*-d*, *--debug*::
|
|
Run in debug mode.
|
|
|
|
*-x*, *--x11*::
|
|
Use an X11 interface even when run from a terminal.
|
|
Note that the application may be built with this feature disabled.
|
|
|
|
*-h*, *--help*::
|
|
Display a help message and exit.
|
|
|
|
*-V*, *--version*::
|
|
Output version information and exit.
|
|
|
|
Configuration
|
|
-------------
|
|
Create _~/.config/hex/hex.conf_ with contents like the following:
|
|
|
|
....
|
|
colors = {
|
|
footer = ""
|
|
footer_hl = "bold"
|
|
bar = "reverse"
|
|
bar_hl = "reverse bold"
|
|
even = ""
|
|
odd = ""
|
|
selection = "reverse"
|
|
}
|
|
....
|
|
|
|
Terminal attributes are accepted in a format similar to that of *git-config*(1),
|
|
only named colours aren't supported.
|
|
|
|
Files
|
|
-----
|
|
*hex* follows the XDG Base Directory Specification.
|
|
|
|
_~/.config/hex/hex.conf_::
|
|
The configuration file.
|
|
|
|
_~/.local/share/hex/plugins/_::
|
|
_/usr/local/share/hex/plugins/_::
|
|
_/usr/share/hex/plugins/_::
|
|
Plugins are loaded from these directories, in order.
|
|
|
|
Reporting bugs
|
|
--------------
|
|
Use https://git.janouch.name/p/hex to report bugs, request features,
|
|
or submit pull requests.
|