H E X E D I T / 2 ================= Version 1.01 An OS/2 Presentation Manager binary file editor. Copyright (c) 1994 Bennett C. Baker and B::Ware. All rights reserved. B::Ware 7 Rosen Road Dedham, MA 02026 617-326-4719 CIS 70274,3147 INTRODUCTION Thank you for evaluating HexEdit/2, a shareware OS/2 Presentation Manager binary file editor from B::Ware. With HexEdit/2, you can view and edit files in single or multibyte octal, decimal, or hexadecimal binary representation. You can resize an existing file or allocate a new file from scratch, and perform search and replace functions forward or backward through the file. HexEdit/2 provides a full help system as well as on-line documentation in the VIEW-compatible (.INF) format. LICENSE AGREEMENT HexEdit/2 is shareware. You are free to use the program for a period of 21 days for the purpose of evaluation. If you decide to continue using the program after the 21 day evaluation period, you must register it. To register, send $15 (US funds, please) to: B::Ware 7 Rosen Road Dedham, MA 02026 USA You may make copies of this program and distribute them freely, as long as you include all of the files that you originally received with your shareware copy. When you give a shareware copy of this program to another person, you agree to inform them that their copy is to be used for a time limited evaluation period, and that they must register their copy if they continue to use the program after the end of the evaluation period. You may not sell or distribute this program for a fee in excess of media costs and/or shipping charges actually incurred in copying and distributing this program. DISCLAIMER IF USED IMPROPERLY, THIS PROGRAM IS CAPABLE OF DESTROYING ALL DATA ON YOUR COMPUTER SYSTEM. THIS PROGRAM IS PROVIDED "AS-IS", WITH NO WARRANTY OF MERCHANTABILITY OR FITNESS OF PURPOSE. IN NO EVENT SHALL B::WARE OR BENNETT C. BAKER BE LIABLE FOR ANY DAMAGES WHATSOEVER ARISING OUT OF USE OF THIS PROGRAM. INSTALLATION There are 7 files comprising the HexEdit/2 installation: HEXEDIT2.EXE - the executable HEXEDIT2.HLP - the on-line help file HEXEDIT2.INF - the VIEWable primary documentation file README.TXT - the README file (this file) REGISTER.TXT - the (optional!) registration form HISTORY.TXT - the program's revision history FILE_ID.DIZ - information for BBS systems These files can go just about anywhere, with the caveat that the HEXEDIT2.HLP file should be in either the HEXEDIT2.EXE directory or one of the directories listed in the HELP environment variable. ---------------------------------------------------------------------- HexEdit/2 ver. 1.01 README.TXT Page 1 An eighth file, INICLEAR.EXE, is intended for one-time use in cleaning HexEdit/2 information out of the OS2.INI profile file. USING INICLEAR.EXE The INICLEAR.EXE utility is provided for those users who are upgrading from HexEdit/2 version 1.00. Version 1.00 used the OS2.INI file to save window position and font information; version 1.01 and future versions use a private INI file (HEXEDIT2.INI, located in the same directory as HEXEDIT2.EXE), for that purpose. Users who wish to remove the HexEdit/2 information from OS2.INI need simply run INICLEAR from either the WPS or an OS/2 Command Interpreter (CMD or 4OS2) session. GETTING STARTED The primary documentation file is HEXEDIT2.INF, readable with the OS/2 VIEW command. HexEdit/2 can be opened from either the command line or as a WPS Program Object. From the command line, it will accept a single argument indicating the file to display for edit (additional command line entries are ignored). As a WPS Program Object, you can open it either by double-clicking on the Program Object icon or by dragging a Data File Object onto the icon (rudimentary drag-n-drop). If you don't want to edit an existing file, you can use the File Allocate and File Resize menus to create a new buffer, which can then be saved with the File Save As command. Buffer display has 3 fields: Line Numbers, Binary Data, and ASCII data. You can change the format of the Line Number field to octal, decimal, or hexadecimal. You can use those same formats for the Binary Data field, and you can also specify how many bytes (1, 2, or 4) are contained in each entity of that field. Multi-byte displays use little-endian format (like Intel and VAX processors). A buffer is normally displayed in Read-Only mode, meaning that you cannot edit it. To edit a buffer, select Options/ReadOnly to toggle the Read-Only mode flag. You can edit a file in either its Binary or ASCII fields. In the Binary field, you use the 0-9 and A-F characters appropriate to the selected display mode (for instance, you can't use the hexadecimal A-F characters if the display mode is octal or decimal). In the ASCII field, any typeable character is an editing character. You can switch between Binary and ASCII fields with the TAB key, or by positioning the mouse cursor on any character and clicking button 1. You can perform Search or Search and Replace operations on data within the buffer. Both Search and Replace strings can be ASCII strings or sequences of octal, decimal, or hex digits. You can also go to a specific offset (specified in octal, decimal, or hex) within the editing buffer. ---------------------------------------------------------------------- HexEdit/2 ver. 1.01 README.TXT Page 2 HexEdit/2 allows you to use any of the fixed-pitch fonts available on your OS/2 system, and will save your font selection for subsequent use. SUPPORT Support for HexEdit/2 will be provided on CompuServe in the OS2SHARE forum (section 1 of the OS2BVEN forum). Address messages to Bennett C. Baker, 70274,3147. Internet users can send E-mail to 70274.3147@compuserve.com. ACKNOWLEDGMENTS Thanks to: Larry Waibel, who first got me interested in writing a PM binary editor. Dave Levitt, who published an extensive feature set wish list (I'm getting there...). Guy Scharf, who answered my questions about becoming a vendor on OS2SHARE. Special thanks to Rhonda, who put up with me while I was wrestling with the innards of P.M. and the voluminous IBM documentation. ABOUT B::WARE B::Ware is a consulting firm with over 14 years experience in MS-DOS and OS/2 applications and system development, Novell NetWare NLM and driver development, real-time embedded systems hardware and software development, and general telecomm and ISDN protocols and implementations. If you think we can help you solve a problem, please contact us at: B::Ware 7 Rosen Road Dedham, MA 02026 (617)-326-4719 CIS 70274,3147 ---------------------------------------------------------------------- HexEdit/2 ver. 1.01 README.TXT Page 3