home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / hexedit2.zip / README.TXT < prev    next >
Text File  |  1996-01-08  |  8KB  |  237 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                                H E X E D I T / 2
  11.  
  12.                                =================
  13.  
  14.                                   Version 1.04
  15.  
  16.  
  17.  
  18.                 An OS/2 Presentation Manager binary file editor.
  19.  
  20.  
  21.  
  22.  
  23.  
  24.             Copyright (c) 1994 - 1996 Bennett C. Baker and B::Ware.
  25.  
  26.                               All rights reserved.
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.                                     B::Ware
  43.                               75 Greenlodge Street
  44.                                Dedham, MA  02026
  45.                                   617-326-4719
  46.  
  47.                          Compuserve     70274,3147
  48.                          Internet       bcb@bware.com
  49.  
  50.  
  51.      INTRODUCTION
  52.  
  53.      Thank you for evaluating HexEdit/2, a shareware OS/2 Presentation
  54.      Manager binary file editor from B::Ware.  With HexEdit/2, you can view
  55.      and edit files in single or multibyte octal, decimal, or hexadecimal
  56.      binary representation.  You can resize an existing file or allocate a
  57.      new file from scratch, and perform search and replace functions
  58.      forward or backward through the file.  HexEdit/2 provides a full help
  59.      system as well as on-line documentation in the VIEW-compatible (.INF)
  60.      format.
  61.  
  62.      LICENSE AGREEMENT
  63.  
  64.      HexEdit/2 is shareware.  You are free to use the program for a period
  65.      of 21 days for the purpose of evaluation.  If you decide to continue
  66.      using the program after the 30 day evaluation period, you must
  67.      register it.  To register, send $20 (US funds, please) to:
  68.  
  69.           B::Ware
  70.           75 Greenlodge Street
  71.           Dedham, MA  02026
  72.           USA
  73.  
  74.      You may make copies of this program and distribute them freely, as
  75.      long as you include all of the files that you originally received with
  76.      your shareware copy.  When you give a shareware copy of this program
  77.      to another person, you agree to inform them that their copy is to be
  78.      used for a time limited evaluation period, and that they must register
  79.      their copy if they continue to use the program after the end of the
  80.      evaluation period.  You may not sell or distribute this program for a
  81.      fee in excess of media costs and/or shipping charges actually incurred
  82.      in copying and distributing this program.
  83.  
  84.      DISCLAIMER
  85.  
  86.      IF USED IMPROPERLY, THIS PROGRAM IS CAPABLE OF DESTROYING ALL DATA ON
  87.      YOUR COMPUTER SYSTEM.  THIS PROGRAM IS PROVIDED "AS-IS", WITH NO
  88.      WARRANTY OF MERCHANTABILITY OR FITNESS OF PURPOSE.   IN NO EVENT SHALL
  89.      B::WARE OR BENNETT C. BAKER BE LIABLE FOR ANY DAMAGES WHATSOEVER
  90.      ARISING OUT OF USE OF THIS PROGRAM.
  91.  
  92.      INSTALLATION
  93.  
  94.      There are 7 files comprising the HexEdit/2 installation:
  95.  
  96.           HEXEDIT2.EXE   - the executable
  97.           HEXEDIT2.HLP   - the on-line help file
  98.           HEXEDIT2.INF   - the VIEWable primary documentation file
  99.           README.TXT     - the README file (this file)
  100.           REGISTER.TXT   - the registration form
  101.           HISTORY.TXT    - the program's revision history
  102.           FILE_ID.DIZ    - information for BBS systems
  103.  
  104.      These files can go just about anywhere, with the caveat that the
  105.      HEXEDIT2.HLP file should be in either the HEXEDIT2.EXE directory or
  106.      one of the directories listed in the HELP environment variable.
  107.  
  108.  
  109.  
  110.      ----------------------------------------------------------------------
  111.      HexEdit/2 ver. 1.04           README.TXT                        Page 1
  112.  
  113.  
  114.      GETTING STARTED
  115.  
  116.      The primary documentation file is HEXEDIT2.INF, readable with the OS/2
  117.      VIEW command.
  118.  
  119.      HexEdit/2 can be opened from either the command line or as a WPS
  120.      Program Object.  From the command line, it will accept a single
  121.      argument indicating the file to display for edit (additional command
  122.      line entries are ignored).  As a WPS Program Object, you can open it
  123.      either by double-clicking on the Program Object icon or by dragging a
  124.      Data File Object onto the icon (rudimentary drag-n-drop).
  125.  
  126.      If you don't want to edit an existing file, you can use the File
  127.      Allocate and File Resize menus to create a new buffer, which can then
  128.      be saved with the File Save As command.
  129.  
  130.      Buffer display has 3 fields: File Offset, Binary Data, and ASCII data.
  131.      You can change the format of the File Offset field to octal, decimal,
  132.      or hexadecimal.  You can use those same formats for the Binary Data
  133.      field, and you can also specify how many bytes (1, 2, or 4) are
  134.      contained in each entity of that field.  Multi-byte displays use
  135.      little-endian format (like Intel and VAX processors).
  136.  
  137.      A buffer is normally displayed in Read-Only mode, meaning that you
  138.      cannot edit it.  To edit a buffer, select Options/ReadOnly to toggle
  139.      the Read-Only mode flag.
  140.  
  141.      You can edit a file in either its Binary or ASCII fields.  In the
  142.      Binary field, you use the 0-9 and A-F characters appropriate to the
  143.      selected display mode (for instance, you can't use the hexadecimal A-F
  144.      characters if the display mode is octal or decimal).  In the ASCII
  145.      field, any typeable character is an editing character.
  146.  
  147.      You can switch between Binary and ASCII fields with the TAB key, or by
  148.      positioning the mouse cursor on any character and clicking button 1.
  149.  
  150.      You can perform Search or Search and Replace operations on data within
  151.      the buffer.  Both Search and Replace strings can be ASCII strings or
  152.      sequences of octal, decimal, or hex digits.
  153.  
  154.      You can also go to a specific file offset (specified in octal,
  155.      decimal, or hex) within the editing buffer.
  156.  
  157.      HexEdit/2 allows you to use any of the fixed-pitch fonts available on
  158.      your OS/2 system, and will save your font selection for subsequent
  159.      use.
  160.  
  161.      SUPPORT
  162.  
  163.      Support for HexEdit/2 is provided on CompuServe in the OS2SHARE forum
  164.      (section 1 of the OS2BVEN forum).  Address messages to Bennett C.
  165.      Baker, 70274,3147.
  166.  
  167.      Internet users can send E-mail to 70274.3147@compuserve.com or
  168.      bcb@bware.com.
  169.  
  170.  
  171.  
  172.  
  173.      ----------------------------------------------------------------------
  174.      HexEdit/2 ver. 1.04           README.TXT                        Page 2
  175.  
  176.  
  177.      ACKNOWLEDGMENTS
  178.  
  179.      Thanks to:
  180.  
  181.      Larry Waibel, who first got me interested in writing a PM binary
  182.      editor.
  183.  
  184.      Dave Levitt, who published an extensive feature set wish list (I'm
  185.      getting there...).
  186.  
  187.      Guy Scharf, who answered my questions about becoming a vendor on
  188.      OS2SHARE.
  189.  
  190.      Special thanks to Rhonda, who put up with me while I was wrestling
  191.      with the innards of P.M. and the voluminous IBM documentation.
  192.  
  193.      ABOUT B::WARE
  194.  
  195.      B::Ware is a consulting firm with over 16 years experience in MS-DOS
  196.      and OS/2 applications and system development, Novell NetWare NLM and
  197.      driver development, real-time embedded systems hardware and software
  198.      development, and general telecomm and ISDN protocols and
  199.      implementations.  If you think we can help you solve a problem, please
  200.      contact us at:
  201.  
  202.           B::Ware
  203.           75 Greenlodge Street
  204.           Dedham, MA  02026
  205.           Voice/FAX  (617)-326-4719
  206.           CompuServe 70274,3147
  207.           Internet   bcb@bware.ultranet.com
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.      ----------------------------------------------------------------------
  237.      HexEdit/2 ver. 1.04           README.TXT                        Page 3