<!DOCTYPE book PUBLIC  "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
  <!ENTITY kappname "&khexedit;" -- this only *seems* redundant -->
  <!ENTITY % English "INCLUDE">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % ents PUBLIC "-//KDE//ENTITIES Documentation V1.0//EN">
  %ents;
]>
<book lang="&language;">

<bookinfo>
<title>The &khexedit; Handbook</title>

<authorgroup>
<author>
<firstname>Jonathan</firstname>
<surname>Singer</surname>
<affiliation>
<address><email>jsinger@leeta.net</email></address>
</affiliation>
</author>

<othercredit role="developer">
<firstname>Espen</firstname>
<surname>Sand</surname>
<affiliation>
<address><email>espensa@online.no</email></address>
</affiliation>
<contrib>Developer</contrib>
</othercredit>

<othercredit role="reviewer">
<firstname>Lauri</firstname>
<surname>Watts</surname>
<affiliation>
<address><email>vampyr@atconnex.net</email></address>
</affiliation>
<contrib>Reviewer</contrib>
</othercredit>
</authorgroup>

<copyright>
<year>1999-2000</year>
<holder>Jonathan Singer</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>14/12/2000</date>
<releaseinfo>0.08.05</releaseinfo>

<abstract><para>&khexedit; is a hexadecimal editor for the KDE
environment.</para></abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>Kapp</keyword>
<keyword>edit</keyword>
<keyword>binary</keyword>
<keyword>hexadecimal</keyword>
</keywordset>
</bookinfo>

<chapter id="introduction">
<title>Introduction</title>

<para>&khexedit; is an editor for the raw data of binary files. It includes
find/replace functions, bookmarks, many configuration options, drag and drop
support and other powerful options.</para>

</chapter>

<chapter id="starting-khexedit">
<title>Starting &khexedit;</title>
<para>Type <userinput><command>khexedit</command></userinput> at a command
prompt or select <guimenuitem>Binary Editor</guimenuitem> from the
<guisubmenu>Utilities</guisubmenu> group in the <guimenu>KDE start
menu</guimenu>.</para>

<para>The standard &Qt; and KDE command line
options are available, and can be listed by entering
<userinput><command>khexedit</command> <option>--help</option></userinput>. </para>

<para>Other command line options are:</para>

<para><option>file</option> - open the specfied file</para>
<para><option>--offset <replaceable>&lt;offset&gt;</replaceable></option> -
jump to position <replaceable>&lt;offset&gt;</replaceable>
in the opened file.</para>

</chapter>

<chapter id="nutshell">
<title>&khexedit; In A Nutshell</title>

<para>The main &khexedit; window has the following components: menubar, toolbar,
offset column, data editor window, text field, searchbar, conversion field and
status bar. </para>

<screenshot>
<screeninfo>&khexedit; Screen</screeninfo>
        <mediaobject>
          <imageobject>
            <imagedata fileref="khexedit1.png" format="png">
          </imageobject>
          <textobject>
            <phrase>&khexedit; Screen</phrase>
          </textobject>
        </mediaobject>
</screenshot>

<para>When a document is opened, the bytes are displayed in hexadecimal format
in the data editor window. The data can be edited, cut, copied, pasted, dragged
and dropped much as text is in an text editor or word processor. A cursor marks
the current position. Pressing the <keycap>Insert</keycap> key toggles between
overwrite and insert text entry modes. The data can also be displayed as octal,
binary or decimal values, by choosing the desired format in the
<guimenu>View</guimenu> menu.</para>

<para>The offset column on the left indicates the position of a particular byte
in the file. The text field on the right displays the <acronym>ASCII</acronym>
encoding of the file.  The cursor position and edits in the data editor window
are reflected in the text field. The text field can also be edited, and those
changes are reflected in the data editor window.</para>

<para>The searchbar allows the user to search for a specific value --
hexadecimal, octal, binary, decimal or text.</para>

<para>The conversion field displays the value of the byte at the cursor position
in a variety of bases. It also displays the value of all standard data types
starting at the cursor.</para>

<para>Multiple documents can be open at the same time but only one can be
active. Use the <guimenu>Documents</guimenu> menu to select which document will
be active.</para>

</chapter>

<chapter id="menu-commands">
<title>Menu Commands</title>

<para>Note that most menu commands also have a keyboard shortcut.</para>

<sect1 id="file-menu">
<title><guimenu>File</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>N</keycap></keycombo>
</shortcut>
<guimenu><accel>F</accel>ile</guimenu>
<guimenuitem><accel>N</accel>ew</guimenuitem>
</menuchoice></term>
<listitem><para><action>Open a new file.</action></para></listitem>
</varlistentry>
	
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>O</keycap></keycombo>
</shortcut>
<guimenu><accel>F</accel>ile</guimenu>
<guimenuitem><accel>O</accel>pen...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Open an existing file.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>I</keycap></keycombo>
</shortcut>
<guimenu><accel>F</accel>ile</guimenu>
<guimenuitem><accel>I</accel>nsert...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Insert an exiting file in the current
document.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>F</accel>ile</guimenu>
<guisubmenu>Open <accel>R</accel>ecent</guisubmenu>
</menuchoice></term>
<listitem><para><action>Choose from a list of the last opened
files.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>F</accel>ile</guimenu>
<guimenuitem>Re<accel>v</accel>ert</guimenuitem>
</menuchoice></term>
<listitem><para><action>Return edited document to the last saved
state.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>S</keycap></keycombo>
</shortcut>
<guimenu><accel>F</accel>ile</guimenu>
<guimenuitem><accel>S</accel>ave</guimenuitem>
</menuchoice></term>
<listitem><para><action>Save document.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>F</accel>ile</guimenu>
<guimenuitem>Save <accel>A</accel>s...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Save document with a new name.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>W</keycap></keycombo>
</shortcut>
<guimenu><accel>F</accel>ile</guimenu>
<guimenuitem><accel>C</accel>lose</guimenuitem>
</menuchoice></term>
<listitem><para><action>Close the current document.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>P</keycap></keycombo>
</shortcut>
<guimenu><accel>F</accel>ile</guimenu>
<guimenuitem><accel>P</accel>rint...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Print the current document.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>F</accel>ile</guimenu>
<guimenuitem>E<accel>x</accel>port...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Export the selected document or a portion of
it.</action></para><para>Opens a dialog box with these options:</para>
<variablelist>
<varlistentry>
<term><guilabel>Format</guilabel></term>
<listitem><para>Plain text, <acronym>HTML</acronym> table, rich text
format, C array.  Use the <guilabel>Options</guilabel> tab to select
details for a C array or an <acronym>HTML</acronym> table.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Destination</guilabel></term>
<listitem><para>The file to which the data will be
exported</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Export Range</guilabel></term>
<listitem><para>Selects which data will be exported -- the entire document, the
selected portion or the range between two specified
offsets.</para></listitem>
</varlistentry>
</variablelist>
</listitem></varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>F</accel>ile</guimenu>
<guimenuitem><accel>C</accel>ancel Operation</guimenuitem>
</menuchoice></term>
<listitem><para>Stop the current operation</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>F</accel>ile</guimenu>
<guimenuitem>Per<accel>m</accel>issions</guimenuitem>
</menuchoice></term>
<listitem><para>Set write privileges:</para>
<variablelist>

<varlistentry>
<term><guilabel>Read only</guilabel></term>
<listitem><para>When set, changes may not be made to the displayed
file.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Allow Resize</guilabel></term>
<listitem><para>When off, individual bytes may be edited but the total number of
bytes may not be changed.</para></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>F</accel>ile</guimenu>
<guimenuitem>N<accel>e</accel>w Window</guimenuitem>
</menuchoice></term>
<listitem><para><action>Open an additional</action> &khexedit;
window</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>F</accel>ile</guimenu>
<guimenuitem>Close <accel>W</accel>indow</guimenuitem>
</menuchoice></term>
<listitem><para><action>Close the current</action> &khexedit;
window</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>Q</keycap></keycombo>
</shortcut>
<guimenu><accel>F</accel>ile</guimenu>
<guimenuitem><accel>Q</accel>uit</guimenuitem>
</menuchoice></term>
<listitem><para>Close all &khexedit; windows</para></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="edit-menu">
<title><guimenu>Edit</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>Z</keycap></keycombo>
</shortcut>
<guimenu><accel>E</accel>dit</guimenu>
<guimenuitem>Und<accel>o</accel></guimenuitem>
</menuchoice></term>
<listitem><para><action>Undo the last action.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>Z</keycap></keycombo>
</shortcut>
<guimenu><accel>E</accel>dit</guimenu>
<guimenuitem>Re<accel>d</accel>o</guimenuitem>
</menuchoice></term>
<listitem><para><action>Redo the last undone action.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>X</keycap></keycombo>
</shortcut>
<guimenu><accel>E</accel>dit</guimenu>
<guimenuitem>C<accel>u</accel>t</guimenuitem>
</menuchoice></term>
<listitem><para><action>Delete the selected bytes and copy them to the
clipboard.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>C</keycap></keycombo>
</shortcut>
<guimenu><accel>E</accel>dit</guimenu>
<guimenuitem><accel>C</accel>opy</guimenuitem>
</menuchoice></term>
<listitem><para><action>Copy the selected bytes to the
clipboard.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>V</keycap></keycombo>
</shortcut>
<guimenu><accel>E</accel>dit</guimenu>
<guimenuitem><accel>P</accel>aste</guimenuitem>
</menuchoice></term>
<listitem><para><action>Insert the cut or copied bytes in the
clipboard.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>E</accel>dit</guimenu>
<guisubmenu>Spec<accel>i</accel>al</guisubmenu>
</menuchoice></term>
<listitem><para>Variations on <guimenuitem>Copy</guimenuitem> and
<guimenuitem>Paste</guimenuitem>:</para>
<itemizedlist>
<listitem><para><guimenuitem>Copy as <accel>t</accel>ext</guimenuitem>: Copies
the selected bytes as <acronym>ASCII</acronym> characters</para></listitem>
<listitem><para><guimenuitem>Paste into new
<accel>f</accel>ile</guimenuitem>.</para></listitem>
<listitem><para><guimenuitem>Paste into new
<accel>w</accel>indow.</guimenuitem></para></listitem>
</itemizedlist>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>A</keycap></keycombo>
</shortcut>
<guimenu><accel>E</accel>dit</guimenu>
<guimenuitem>Select <accel>A</accel>ll</guimenuitem>
</menuchoice></term>
<listitem><para><action>Select entire document.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>E</accel>dit</guimenu>
<guimenuitem><accel>U</accel>nselect</guimenuitem>
</menuchoice></term>
<listitem><para><action>Unselect entire document.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>F</keycap></keycombo>
</shortcut>
<guimenu><accel>E</accel>dit</guimenu>
<guimenuitem><accel>F</accel>ind...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Find a specified pattern in the document.</action>
Hexadecimal,decimal, octal, binary or text patterns can be searched for.</para>
<para>Options in the dialog box allow you to specify the starting point,
direction and range of the search.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>F3</keycap></keycombo>
</shortcut>
<guimenu><accel>E</accel>dit</guimenu>
<guimenuitem>Find <accel>N</accel>ext</guimenuitem>
</menuchoice></term>
<listitem><para><action>Find the next instance</action> of the
<guimenuitem>Find</guimenuitem> pattern.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Shift</keycap><keycap>F3</keycap></keycombo>
</shortcut>
<guimenu><accel>E</accel>dit</guimenu>
<guimenuitem>Find <accel>P</accel>revious</guimenuitem>
</menuchoice></term>
<listitem><para><action>Find the previous instance</action> of the
<guimenuitem>Find</guimenuitem> pattern.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>R</keycap></keycombo>
</shortcut>
<guimenu><accel>E</accel>dit</guimenu>
<guimenuitem><accel>R</accel>eplace...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Replace</action> the find pattern with a different
pattern.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>G</keycap></keycombo>
</shortcut>
<guimenu><accel>E</accel>dit</guimenu>
<guimenuitem><accel>G</accel>oto Offset...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Move the cursor to a specified
offset.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>Ins</keycap></keycombo>
</shortcut>
<guimenu><accel>E</accel>dit</guimenu>
<guimenuitem><accel>I</accel>nsert Pattern...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Insert a specified string of bytes.</action></para>
<para>Options in the dialog box allow you to specify the length of the pattern,
its format (hexadecimal, decimal, octal, binary or text) and the insertion
point.</para>
<para>If <guilabel>Repeat pattern</guilabel> is checked, the specified pattern
will be inserted repeatedly to reach the length set in
<guilabel>Size</guilabel>.</para></listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="view-menu">
<title><guimenu>View</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu><guimenuitem><accel>H</accel>exadecimal</guimenuitem>
<guimenu><accel>V</accel>iew</guimenu><guimenuitem><accel>D</accel>ecimal</guimenuitem>
<guimenu><accel>V</accel>iew</guimenu><guimenuitem><accel>O</accel>ctal</guimenuitem>
<guimenu><accel>V</accel>iew</guimenu><guimenuitem><accel>B</accel>inary</guimenuitem>
<guimenu><accel>V</accel>iew</guimenu><guimenuitem><accel>T</accel>ext</guimenuitem>
</menuchoice></term>
<listitem><para>The first five choices <action>select the format displayed in the data
editor window</action>: hexadecimal, decimal, octal, binary or text. When text
display is selected, the extra text field is not displayed.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem>Show of<accel>f</accel>set column</guimenuitem>
</menuchoice></term>
<listitem><para><action>Toggles display of offset column on and
off.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem>Show te<accel>x</accel>t field</guimenuitem>
</menuchoice></term>
<listitem><para><action>Toggles display of text field on and
off.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem>Off<accel>s</accel>et as decimal</guimenuitem>
</menuchoice></term>
<listitem><para>When set, <action>all offsets are displayed and interpreted as
decimal numbers</action> rather than as hexadecimals.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem><accel>U</accel>pper case (data)</guimenuitem>
</menuchoice></term>
<listitem><para>When set, <action>hexadecimal digits in the data are displayed
in upper case.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem>Upper <accel>c</accel>ase (offset)</guimenuitem>
</menuchoice></term>
<listitem><para>When set, <action>hexadecimal digits in the offset value are
displayed in upper case.</action></para></listitem>
</varlistentry>

<varlistentry id="view-encoding">
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guisubmenu>Document <accel>E</accel>ncoding</guisubmenu>
</menuchoice></term>
<listitem><para>Select the encoding used for display in the text field.
Alternative encodings like <acronym>EBCDIC</acronym> and 7-bit
<acronym>ASCII</acronym> can be used. Additional encodings can be added by the
user (not implemented yet.)</para></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="bookmarks">
<title><guimenu>Bookmarks</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>B</keycap></keycombo>
</shortcut>
<guimenu><accel>B</accel>ookmarks</guimenu>
<guimenuitem><accel>A</accel>dd Bookmark </guimenuitem>
</menuchoice></term>
<listitem><para>Bookmark a location within the document. </para>
<para>Multiple bookmarks can be set for a single document. Each document has its
own set of bookmarks and the appropriate set is displayed at the bottom of the
<guimenu>Bookmarks</guimenu> menu when a document is selected. Choose a bookmark
from the menu to go to it.</para></listitem> 
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>E</keycap></keycombo>
</shortcut>
<guimenu><accel>B</accel>ookmarks</guimenu>
<guimenuitem><accel>R</accel>eplace Bookmark </guimenuitem>
</menuchoice></term>
<listitem><para><action>Reset an existing bookmark to the current cursor
location.</action> A dialog will be opened with the list of available bookmarks;
select the one you wish to change.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>U</keycap></keycombo>
</shortcut>
<guimenu><accel>B</accel>ookmarks</guimenu>
<guimenuitem>R<accel>e</accel>move Bookmark </guimenuitem>
</menuchoice></term>
<listitem><para><action>Remove an existing bookmark.</action> A dialog will be
opened with a list  of available bookmarks; select the one you wish to
remove.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>B</accel>ookmarks</guimenu>
<guimenuitem>Re<accel>m</accel>ove All </guimenuitem>
</menuchoice></term>
<listitem><para><action>Clear the bookmark list.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Alt</keycap><keycap>Down</keycap></keycombo>
</shortcut>
<guimenu><accel>B</accel>ookmarks</guimenu>
<guimenuitem>Goto <accel>N</accel>ext Bookmark</guimenuitem>
</menuchoice></term>
<listitem><para><action>Move the cursor to the next
bookmark.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Alt</keycap><keycap>Up</keycap></keycombo>
</shortcut>
<guimenu><accel>B</accel>ookmarks</guimenu>
<guimenuitem>Goto <accel>P</accel>revious Bookmark</guimenuitem>
</menuchoice></term>
<listitem><para><action>Move the cursor to the previous
bookmark.</action></para></listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="tools-menu">
<title><guimenu>Tools</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu><accel>T</accel>ools</guimenu>
<guimenuitem><accel>E</accel>xtract Strings...</guimenuitem>
</menuchoice></term>
<listitem><para>Locate <acronym>ASCII</acronym> strings in the data. Minimum
string length, case sensitivity and a pattern to match can be
specified.</para></listitem> 
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>T</accel>ools</guimenu>
<guimenuitem><accel>B</accel>inary Filter...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Perform a binary operation on the data.</action> The
operation (AND, OR, ROTATE..) and an operand can be specified in the dialog
box. Checkboxes in the dialog allow the operation to be limited to selected
bytes or the region before or after the cursor.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>T</accel>ools</guimenu>
<guimenuitem><accel>C</accel>haracter Table...</guimenuitem>
</menuchoice></term>
<listitem><para>Open a list of values and their <acronym>ASCII</acronym>
equivalents and <action>insert the selected value at the
cursor.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>T</accel>ools</guimenu>
<guimenuitem>C<accel>o</accel>nverter...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Enter a value in any of the fields and see its
equivalent in hexadecimal, decimal, octal, binary or text</action>.  A check box
allows viewing of the value at the cursor, instead.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>T</accel>ools</guimenu>
<guimenuitem><accel>S</accel>tatistics...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Display the frequency of occurrence of values in the
document.</action></para></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="document-menu">
<title><guimenu>Documents</guimenu> Menu</title>

<para>Provides a list of the open documents. Selecting one makes it
active.</para>

</sect1>

<sect1 id="settings-menu">
<title><guimenu>Settings</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu>
<guimenuitem>Show <accel>T</accel>oolbar</guimenuitem>
</menuchoice></term>
<listitem><para><action>Toggle display of the toolbar below the
menubar.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu>
<guimenuitem>Show St<accel>a</accel>tusbar</guimenuitem>
</menuchoice></term>
<listitem><para><action>Toggle display of the statusbar</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu>
<guimenuitem>Show F<accel>u</accel>ll Path</guimenuitem>
</menuchoice></term>
<listitem><para><action>Toggle display of the full file path in the
titlebar</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu>
<guisubmenu><accel>D</accel>ocument Tabs</guisubmenu>
</menuchoice></term>
<listitem><para>Change display of tabs for all current documents. The tab can be
displayed above or below the editor window, or hidden. You may find the tabs
more convenient than the document menu for switching documents.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu>
<guisubmenu>Conversion <accel>F</accel>ield</guisubmenu>
</menuchoice></term>
<listitem><para><action>Change display of the value conversion field.</action>
It can be embedded in the main window, made a floating window or
hidden.</para></listitem> 
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu>
<guimenuitem>Searc<accel>h</accel>bar</guimenuitem>
</menuchoice></term>
<listitem><para><action>Change display of the value searchbar</action>. It can be
displayed above or below the editor window, or hidden.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings </guimenu>
<guimenuitem><accel>S</accel>ave Options</guimenuitem>
</menuchoice></term>
<listitem><para><action>Save the current state of the
options.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings </guimenu>
<guimenuitem><accel>P</accel>references...</guimenuitem>
</menuchoice></term>
<listitem><para>Change these settings:</para>
<variablelist>
<varlistentry>
<term><guilabel>Layout</guilabel></term>
<listitem><para>Line and column size (in bytes). These can be set separately for
different modes.  Fixed number of bytes per line. Lock column at end of
line. Gridlines between rows and columns. Width of field separators, spacing and
margins.</para></listitem> 
</varlistentry>
<varlistentry>
<term><guilabel>Cursor</guilabel></term>
<listitem><para>Blink rate and shape of the cursor. Behavior of the cursor when
the window loses focus.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Font</guilabel></term>
<listitem><para>Font name, style and size. Character used to display
nonprinting
characters in the text field.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Colors</guilabel></term>
<listitem><para> All colors in &khexedit; can be customized, including odd and
even lines and columns, bookmarks, separators and grid lines. The one exception
is the selection color, which uses the setting chosen in the KDE Control
Center.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Files</guilabel></term>
<listitem><para>Opening of the last, or all recent documents on
startup. Restoration of cursor position. Write protection enabled by
default. Make a backup upon saving files. Saving of <quote>Recent
Documents</quote> list on exit. The <quote>Recent Documents</quote> list can
also be cleared in this dialog.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Miscellaneous</guilabel></term>
<listitem><para>Automatic copy to clipboard upon selection. Startup in insert
mode, rather than overwrite. Confirmation required for wrapping to the beginning
or end during searches. Cursor jumps to nearest byte when moved in binary
mode. Sound on typing input or fatal failure. Display of bookmarks in the offset
column and editor fields. Warning when number of printable pages exceeds a
settable limit. Maximum number of undos.</para></listitem> 
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="help-menu">
<title><guimenu>Help</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>F1</keycap></keycombo>
</shortcut>
<guimenu><accel>H</accel>elp</guimenu>
<guimenuitem><accel>C</accel>ontents...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens this document.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Shift</keycap><keycap>F1</keycap></keycombo>
</shortcut>
<guimenu><accel>H</accel>elp</guimenu>
<guimenuitem>What's <accel>T</accel>his?</guimenuitem>
</menuchoice></term>
<listitem><para>Select this and click on items to learn more about
them.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>H</accel>elp</guimenu>
<guimenuitem><accel>R</accel>eport Bug...</guimenuitem>
</menuchoice></term>
<listitem><para>A convenient dialog for reporting bugs in
&khexedit;.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>H</accel>elp</guimenu>
<guimenuitem><accel>A</accel>bout KHexEdit</guimenuitem>
</menuchoice></term>
<listitem><para>Provides information about &khexedit;.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>H</accel>elp</guimenu>
<guimenuitem>About <accel>K</accel>DE</guimenuitem>
</menuchoice></term>
<listitem><para>Provides information about the KDE project.</para></listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="toolbar"><title>Toolbar</title>
<para>The toolbar contains icons for the following commands:</para>

<note><para>(Except for <guiicon>Drag document</guiicon> and
<guiicon>Toggle</guiicon> write protection, all behave identically to the menu
command.)</para></note>

<itemizedlist>
<listitem><para><guiicon>Drag document</guiicon> -- Click this button and drag
to a text editor or a new &khexedit; window.</para></listitem>
<listitem><para><guiicon>New</guiicon></para></listitem>
<listitem><para><guiicon>Open</guiicon></para></listitem>
<listitem><para><guiicon>Revert</guiicon></para></listitem>
<listitem><para><guiicon>Save</guiicon></para></listitem>
<listitem><para><guiicon>Print</guiicon></para></listitem>
<listitem><para><guiicon>Find</guiicon></para></listitem>
<listitem><para><guiicon>Find Next</guiicon></para></listitem>
<listitem><para><guiicon>Find Previous</guiicon></para></listitem>
<listitem><para><guiicon>Cut</guiicon></para></listitem>
<listitem><para><guiicon>Copy</guiicon></para></listitem>
<listitem><para><guiicon>Paste</guiicon></para></listitem>
<listitem><para><guiicon>Undo</guiicon></para></listitem>
<listitem><para><guiicon>Redo</guiicon></para></listitem>
<listitem><para><guiicon>Cancel Operation</guiicon></para></listitem>
<listitem><para><guiicon>Help</guiicon></para></listitem>
</itemizedlist>

<para>..and at the right of the toolbar..</para>
<para><guiicon>Toggle write protection</guiicon> - switch between read-only and
read/write modes.</para>

<sect2 id="searchbar">
<title>Searchbar</title>

<para>The searchbar is used to locate a specific value in the document. Enter a
value in the box, select the desired representation (hexadecimal, octal, binary,
decimal or text) and hit the <guibutton>Find</guibutton> button. Check the
<guilabel>Backwards</guilabel> box to search backwards from the cursor point or
check <guilabel>Ignore Case</guilabel> for a case-insensitive text search. Click
the button on the right of the bar (<guiicon>X</guiicon>) to hide the searchbar;
go to <guimenuitem>Searchbar</guimenuitem> in the <guimenu>Settings</guimenu>
menu to restore it.</para>

</sect2>

<sect2 id="conversion-field">
<title>Conversion field</title>

<para>The conversion field displays the values of various datatypes at the
selected byte. For 8 bit types, it displays the value of the byte under the
cursor; for larger types, it displays the value starting at that byte. The
rightmost column displays various encodings of the current byte. Options in the
conversion field are:</para>

<variablelist>
<varlistentry>
<term><guilabel>Show little endian decoding</guilabel></term>
<listitem><para>When checked, causes multibyte types to be calculated using the
little-endian method used by x86 and Alpha processors. In this scheme, the first
byte represents the least significant part of the value. (0a 4e = 0x4e0a =
19978) When unchecked, causes multibyte types to be calculated using the
big-endian method used by PowerPC and Sparc processors.  (0a 4e = 0x0a4e =
2638)</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Show unsigned as hexadecimal</guilabel></term>
<listitem><para>When checked, causes unsigned types to be displayed in
hexadecimal, rather than decimal format.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Stream length</guilabel></term>
<listitem><para>Determines the number of bits used to calculate the values in
the fields above it.</para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="status-bar">
<title>Status Bar</title>

<para>The status bar displays the following information:</para>

<variablelist>
<varlistentry>
<term>Encoding/Selection</term> <!-- fix this --> 
<listitem><para>When there is
no selection, this field shows the encoding option used. (See <link
linkend="view-encoding"><menuchoice> <guimenu>View</guimenu>
<guimenuitem>Document Encoding</guimenuitem> </menuchoice></link> for more
information on encoding.)  The start point and the length of the selection are
shown.</para> 
</listitem>
</varlistentry>

<varlistentry>
<term>File Modified</term>
<listitem><para>A <computeroutput>!</computeroutput> in this box indicates the
current file was modified.</para></listitem>
</varlistentry>

<varlistentry>
<term>Insert/Overwrite</term>
<listitem><para>Indicates whether values entered at the keyboard are
inserted at the cursor point (<guilabel>INS</guilabel>) or overwrite the
existing data starting at the cursor(<guilabel>OVR</guilabel>). Use the
<keycap>Insert</keycap> key to toggle betwen the two modes.</para></listitem>
</varlistentry>

<varlistentry>
<term>Size</term>
<listitem><para>Displays the total size of the current
document.</para></listitem>
</varlistentry>

<varlistentry>
<term>Offset</term>
<listitem><para>Indicates the position of the cursor within the
document.</para></listitem>
</varlistentry>

<varlistentry>
<term>Display mode</term>
<listitem><para>Indicates whether data editor window is diplaying values in
hexadecimal, octal, binary, decimal or text mode. Switch between modes with
the View menu.</para></listitem>
</varlistentry>

<varlistentry>
<term>Write Protection</term>
<listitem><para>Indicates whether the document can be edited
(<guilabel>RW</guilabel>) or is being viewed read-only
(<guilabel>R</guilabel>). Switch between modes with the button on the far-right
of the toolbar or the <guimenuitem>Permissions</guimenuitem> command in the
<guimenu>File</guimenu> menu.</para></listitem>
</varlistentry>
</variablelist>

</sect2>

</sect1>

</chapter>

<chapter id="credits">
<title>Credits and License</title>

<para>
&khexedit;
</para>

<para>Program copyright 1999-2000 Espen Sand
<email>espensa@online.no</email></para>

<para>Contributors:</para>

<itemizedlist>
<listitem><para>Leon Lessing <email>leon@irlabs.com</email></para></listitem>
<listitem><para>Craig Graham
<email>c_graham@hinge.mistral.co.uk</email></para></listitem>
<listitem><para>Dima Rogozin
<email>dima@mercury.co.il</email></para></listitem>
<listitem><para>Edward Livingstone-Blade
<email>sbcs@bigfoot.com</email></para></listitem>
</itemizedlist>

<para>Documentation copyright 2000 Jonathan Singer
<email>jsinger@leeta.net</email></para>

&underFDL;
&underGPL;

</chapter>


<appendix id="installation">
<title>Compilation and installation</title>
    
<para>&khexedit; is part of the kdeutils package and should be compiled and
installed as indicated in the package's main directory. New versions of
kdeutils
can be obtained at <ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde</ulink>. To build
&khexedit;:</para>

<screen width="40">
<prompt>%</prompt> <userinput><command>./configure</command></userinput>
<prompt>%</prompt> <userinput><command>cd</command> <filename>kdeutils/khexedit</filename></userinput>
<prompt>%</prompt> <userinput><command>make</command></userinput>
<prompt>%</prompt> <userinput><command>su</command></userinput>
<prompt>%</prompt> <userinput><command>make</command> <option>install</option></userinput>
</screen>

</appendix>


<![ %addindex; [ &kdedocindex; ]]>
</book>

<!--
Local Variables:
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
End:
-->
