home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / YILMAZ.ZIP / YD.DOC < prev    next >
Text File  |  1993-06-08  |  37KB  |  879 lines

  1.                         Yilmaz Disassembler Ver. 1.1 (TM)
  2.                    Copyright (c) 1992, 1993 by Yilmaz Towfeek
  3.  
  4.                                     CONTENTS
  5.  
  6.   1 INTRODUCTION
  7.   2 REQUIREMENTS & FEED BACK
  8.   3 HOW TO START
  9.   4 INTEGRATED ENVIRONMENT
  10.   5 FILE MENU
  11.       5.1 New
  12.       5.2 Disassemble
  13.       5.3 Save
  14.       5.4 Retrieve job
  15.       5.5 Save job
  16.       5.6 Print
  17.       5.7 Change Directory
  18.       5.8 DOS shell
  19.       5,9 Exit
  20.   6 EDIT MENU
  21.       6.1 Define code
  22.       6.2 Define data
  23.       6.3 Goto
  24.       6.4 Insert label
  25.       6.5 Delete label
  26.   7 OPTIONS MENU
  27.       7.1 Colors
  28.       7.2 Preferences
  29.       7.3 Load options
  30.       7.4 Save options
  31.   8 WINDOW MENU
  32.       8.1 Tile
  33.       8.2 Cascade
  34.       8.3 Close all
  35.       8.4 Resize/Move
  36.       8.5 Zoom
  37.       8.6 Next
  38.       8.7 Previous
  39.       8.8 Close
  40.   9 HELP
  41.       9.1 About
  42.   10 WINDOWS
  43.  
  44.     1 INTRODUCTION
  45.     ══════════════
  46.     Welcome to Yilmaz DisAssembler Version 1.1 (TM). Yilmaz DisAssembler
  47.     is an interactive and flexible disassembler which lets the user be a
  48.     part of the disassembling process.
  49.  
  50.     This software disassembles executable files of format COM. That is
  51.     not the only one, it can other file formats of one segment size, for
  52.     example, Borland's TPU files. The disassembled file is fully
  53.     compatible with Turbo Assembler and MASM. It needs additional work
  54.     to be assembled again with above mentioned assemblers.
  55.  
  56.     This version of Yilmaz DisAssembler has following limitations:
  57.  
  58.          ■ Maximum executable file size is 64 KB.
  59.          ■ Only 8086/8088 CPU instructions can be disassembled.
  60.          ■ 8087 Math Co-processor's instructions.
  61.  
  62.     This software uses multiple windows to view the disassembled file.
  63.     This will help the user to see different parts of the file
  64.     simultaneously. Once an executable file loaded and disassembled, the
  65.     user may open as many windows as he/she wishes to view the
  66.     disassembled file. The only one restriction may be for him/her to do
  67.     so is the available memory, which can be seen on the About dialog box.
  68.  
  69.     Yilmaz DisAssembler allows you to interact via dialog boxes to
  70.  
  71.          ■ load an executable file,
  72.          ■ save the disassembled file,
  73.          ■ change the default directory,
  74.          ■ print the disassembled file,
  75.          ■ convert a range of memory area between data and code areas,
  76.          ■ go to a specified address inside the disassembled file,
  77.          ■ insert and delete label at specified address inside the
  78.            disassembled file,
  79.          ■ customize the environment's colors,
  80.          ■ choose the preferences,
  81.          ■ and respond to occurred errors.
  82.  
  83.     This is a shareware program, i.e. you get a copy and try it. If you
  84.     like it, and you think it worth its price then you pay the asked sum
  85.     and you become a registered user.
  86.  
  87.     If you want the shareware principle works, and you want to see more
  88.     good quality shareware programs at low prices, you should register
  89.     this program. Send the author his fee. Read the license for more
  90.     information.
  91.  
  92.     NOTE
  93.     All suggestions about this software are welcome.
  94.  
  95.     2 REQUIREMENTS & FEED BACK
  96.     ══════════════════════════
  97.     Yilmaz DisAssembler requires
  98.  
  99.          ■ a compatible computer,
  100.          ■ a graphics card, does not matter which one,
  101.          ■ and at least 400 KB free memory at the start.
  102.  
  103.     A mouse device is optional but not required, that is to say: if you
  104.     have one then you can use it.
  105.  
  106.     This software is tested and verified to disassemble correctly. It is
  107.     free from known bugs as far as I know. Technical support is available
  108.     at no charge for all users.
  109.  
  110.     You can contact me either by electronic post at FidoNet:
  111.  
  112.          Yilmaz Towfeek@1:201/111
  113.  
  114.     or by mail post at following address:
  115.  
  116.          Yilmaz Towfeek
  117.          Box 10015
  118.          580 10 Linkoping
  119.          Sweden
  120.  
  121.     When reporting problems with this software, please include as
  122.     detailed description of the problem as possible.
  123.  
  124.     3 HOW TO START
  125.     ══════════════
  126.     The correct syntax to start the Yilmaz DisAssembler is:
  127.  
  128.       YD[.EXE] [[d:] [[Path] FileName [.Ext]]]
  129.  
  130.     Where the parameters between big parenthesis `[]' are optional. If
  131.     you skip the parameter at command line, then you just enter to the
  132.     program integrated environment. If you type in the parameter, the
  133.     executable file will be loaded and disassembled. The executable file
  134.     (file to be disassembled) can be any where in your system, provided
  135.     that its directory is DOS "PATH".
  136.  
  137.     To start this software, you do not need to be in the directory where
  138.     "YD.EXE" and all required accompanying files are. Be sure this
  139.     directory is in DOS "PATH".
  140.  
  141.     NOTE
  142.     If the configuration file "YD.CFG" does not exist either on a path
  143.     directory or default directory, the program will end immediately
  144.     without any message.
  145.  
  146.     4 INTEGRATED ENVIRONMENT
  147.     ════════════════════════
  148.     The integrated environment consists of the following 3 parts:
  149.  
  150.          ■ The menu bar at the top of the screen.
  151.          ■ The Desktop.
  152.          ■ The status line, a quick reference line at the bottom of
  153.            the screen.
  154.  
  155.     The menu bar for Yilmaz DisAssembler Version 1.1 contains these five
  156.     main options: File, Edit, Option, Window and Help. These options may
  157.     be accessed in three ways. First, press the F10 key to show the menu
  158.     bar and then use the <LEFT> and <RIGHT> arrow keys to highlight the
  159.     desired option. Select the right option by highlighting. Press the
  160.     <RETURN/ENTER> or <DOWN> arrow key to execute. You can also press the
  161.     first (highlighted) letter of the desired option name.
  162.  
  163.     A second way of accessing a menu bar item is by pressing the <ALT>
  164.     key and the first (highlighted) letter of the desired menu item's
  165.     title (name). For example, to pull down the "File" menu item you need
  166.     to press <Alt> and "F" key simultaneously.
  167.  
  168.     The third way of accessing a menu bar item is by clicking with the
  169.     mouse (if you have one) device on the desired menu item.
  170.  
  171.     Once a menu bar item is executed, a pull-down menu will be displayed
  172.     with the last selected menu command highlighted. You may execute a
  173.     menu command by using <UP> and <DOWN> arrow keys to highlight the
  174.     right command. Then press the <RETURN/ENTER> key. You may also execute
  175.     a menu command by pressing the highlighted letter of that command's
  176.     title (name).
  177.  
  178.     If a menu command is followed by an arrow (), the command leads you
  179.     to another menu. The menu commands show also the shortcuts (the quick
  180.     way) available to select the menu commands. These shortcuts are
  181.     almost function keys or a combination of <Ctrl/Alt> key and the
  182.     highlighted letter of that command's title (name). To close a
  183.     displayed menu item, just press <ESC> or click outside the displayed
  184.     menu area with the mouse pointer.
  185.  
  186.     Remember to watch the status line on the bottom of the screen. There
  187.     will be shown context sensitive one-line help information about the
  188.     selected menu item, pulled down menu and selected part of the active
  189.     dialog box.
  190.  
  191.     5 FILE MENU
  192.     ═══════════
  193.     The File menu includes commands for opening new windows, loading and
  194.     saving files, loading and saving a job, changing directories,
  195.     printing the disassembled file, DOS shell, and exiting the program.
  196.  
  197.     When looking at the file menu commands, you will see the available
  198.     shortcuts to the commands at the same line. These shortcuts list the
  199.     hot keys that can access that command without going through the file
  200.     menu.
  201.  
  202.     Following shortcuts are available on the file menu:
  203.  
  204.     ┌────────────┬──────────────────┐
  205.     │  Shortcut  │    Command       │
  206.     ├────────────┼──────────────────┤
  207.     │  F4        │ New              │
  208.     │  F2        │ Save             │
  209.     │  F3        │ Disassemble      │
  210.     │  F7        │ Print            │
  211.     │  F8        │ Change Directory │
  212.     │  F9        │ DOS shell        │
  213.     │  <ALT>+X   │ Exit             │
  214.     └────────────┴──────────────────┘
  215.  
  216.     5.1 New
  217.     ═══════
  218.     The command New opens another window to show the same already
  219.     disassembled file. Using multiple windows makes disassembling process
  220.     easier. You can see different parts of the disassembled file
  221.     simultaneously. For example, you can see instruction code which
  222.     writes some text on the screen as well as the text itself.
  223.  
  224.     Theoretically, you may open as many windows as you wish, but
  225.     practically the available memory may restrict you to do so. Another
  226.     restrict may be the size of your screen, but having a monitor with
  227.     EGA/VGA card will be more helpful. You can choose high resolution
  228.     mode to show 43/50 lines with 80 columns width.
  229.  
  230.     For more information refer to File│Disassemble.
  231.  
  232.     5.2 Disassemble
  233.     ═══════════════
  234.     The Disassemble command allows you to select an executable file you
  235.     want to disassemble from any drive/directory in your system. This
  236.     command will display a dialog box in which you can select the
  237.     executable file you wish to disassemble. The open file dialog box
  238.     contains a Name input line editor, a file list, a file information
  239.     panel, the standard button Cancel, another action button Open, plus a
  240.     history list attached to the Name input line editor.
  241.  
  242.     The Name input line editor is to type in the desired file's name with
  243.     the correct path name which is optional. You can also type a drive/
  244.     directory name to show its contents with given file mask. If you type
  245.     in a specific drive name then you should also type in `:' directly
  246.     after that name.
  247.  
  248.     The file list box shows all files with the given file mask in the
  249.     default (or selected) directory, plus the parent directory and all
  250.     sub directories. Here you may type file's name to select
  251.     incrementally. Use lower case characters to type the file names and
  252.     upper case letters to type the directory names.
  253.  
  254.     The File information panel describes the selected file. It shows the
  255.     path name, file name, date, time, and size of the selected file. This
  256.     is useful especially when you need to see the size of the file or
  257.     date/time of the last updating.
  258.  
  259.     NOTE: None of the items on this information panel selectable.
  260.  
  261.     The dialog box has many standard buttons to perform a desired action.
  262.     Standard buttons, Open and Ok, are available to load and disassemble
  263.     the selected file. Use the standard Cancel button to close the dialog
  264.     box without loading the file. You can close the dialog box by
  265.     pressing the <ESC> key, or clicking on the frame icon at the left top
  266.     of the box with the mouse.
  267.  
  268.     Choosing the Open or Ok button will load and disassemble the selected
  269.     file. The disassembling time depends on the size of file. After the
  270.     executable file is analyzed and disassembled, a new window will be
  271.     opened to view the disassembled file. Later, you can use the command
  272.     "New" to open extra windows to view the same disassembled file.
  273.     Different windows view the same file independently of each other so
  274.     you can see different parts of the file simultaneously.
  275.  
  276.     5.3 Save
  277.     ═════════
  278.     The Save command allows you to save the current disassembled file to
  279.     a disk text file. If you have chosen to save automatically via Auto
  280.     Save in the preferences dialog box, this command will use the
  281.     disassembled file's name to build the text file's name, i.e. same
  282.     name with extension "ASM". Otherwise this command will cause a dialog
  283.     box (like the one with Disassemble command) to appear.
  284.  
  285.     NOTE:
  286.     A warning of existing files will be prompted to you. Your response
  287.     will be performed.
  288.  
  289.     The dialog box shows all files with extension "ASM" to help you to
  290.     avoid overwriting of the existing files. If you want to save under
  291.     the same name, then nothing can stop you.
  292.  
  293.     For more information refer to File│Disassemble.
  294.  
  295.     5.4 Retrieve job
  296.     ════════════════
  297.     This command will restore a previously-saved job from a file saved
  298.     via the File│Save Job menu command. This is useful when you have
  299.     disassembled a file and for some reasons you could not finish the
  300.     job.
  301.  
  302.     You do not need to start the job from the scratch. Everything you
  303.     have done earlier is now available on the disk file, except the then
  304.     opened windows. You get the job back with only one window. You can
  305.     open as many windows as you wish without any big efforts, you only
  306.     press the key F4.
  307.  
  308.     It is worthwhile to have this command in Yilmaz DisAssembler.
  309.     Otherwise you have to do the same job repeatedly if you have to
  310.     finish the program before the disassembling process ends.
  311.  
  312.     5.5 Save Job
  313.     ════════════
  314.     This command will save a whole job into a disk file. Next time when
  315.     you start the job, you do not need to start it from the scratch.
  316.     Everything is saved to the disk file except the present open windows.
  317.     Every time you have a file disassembled in the integrated
  318.     environment, you can open as many windows as you wish without any big
  319.     efforts. The F4 key opens windows.
  320.  
  321.     This command is useful when you have disassembled a file and for some
  322.     reasons you must finish the job before it is finished. This is why
  323.     this command is available in Yilmaz DisAssembler.
  324.  
  325.     5.6 Change Directory
  326.     ════════════════════
  327.     The Change Directory command allows you to change the default
  328.     directory you are working. You do this via the Change Directory
  329.     dialog box. The dialog box includes an input line editor, a list box,
  330.     the standard OK and Cancel buttons, and two other buttons (Chdir and
  331.     Revert).
  332.  
  333.     The Directory Name Input Line Editor is where you specify the desired
  334.     directory path. All accepted directory paths will be saved on the
  335.     history list for later direct accessing.
  336.  
  337.     The Directory Tree list box enables you to navigate directories by
  338.     using the selecting bar and pressing <RETURN/ENTER>.
  339.  
  340.     If you are using the keyboard, press <RETURN/ENTER> to make the
  341.     selected directory be the current directory, then choose OK or press
  342.     <ESC> to exit the dialog box.
  343.  
  344.     The ChDir button changes the current directory once you have selected
  345.     or typed in a directory name.
  346.  
  347.     The Revert button goes back to the previous directory, as long as you
  348.     have not left the dialog box.
  349.  
  350.     5.7 Print
  351.     ═════════
  352.     The Print command allows you to print the current disassembled file
  353.     on the installed printer. This software uses the standard device LPT1
  354.     for printing. It does not do any checking of printer types. This
  355.     command will bring up a dialog box to read your printing options.
  356.  
  357.     The Print dialog box has an input line editor "Header" to type in one
  358.     line text of max length 80 characters as header to print at the top
  359.     of each sheet. You may type in file's name as header.
  360.  
  361.     The Print dialog box has also two one-digit input (editors) fields to
  362.     type in vertical and horizontal margins of the printing paper. The
  363.     Radio button, "Paper", in this dialog box allow you to choose type of
  364.     paper, make a pause after printing each sheet and choose the paper
  365.     size. This software assumes length of the paper as 62 lines for
  366.     single paper and 65 lines for the fanfold paper. Both have 80
  367.     characters on a line.
  368.  
  369.     If any input/output error occurs, then an error message will be on
  370.     the status line. The user can correct the error and continue, or
  371.     abort the printing.
  372.  
  373.     5.8 DOS Shell
  374.     ═════════════
  375.     With the DOS Shell command, you can leave the Yilmaz DisAssembler
  376.     temporarily to perform a DOS command or run another program. When
  377.     selected, the screen will be cleared. You will be in DOS. To return
  378.     to the Yilmaz DisAssembler, type "EXIT" at the DOS prompt.
  379.  
  380.     5.9 Exit
  381.     ════════
  382.     The Exit command ends the Yilmaz DisAssembler to DOS. Another way to
  383.     execute this command is pressing the hot key Alt-X. It will prompt
  384.     you to save the disassembled file before exiting, if it was changed
  385.     since the last save.
  386.  
  387.     6 EDIT MENU
  388.     ═══════════
  389.     The Edit Menu includes commands for defining code area, data area, go
  390.     to, insert label and delete label at specified address within the
  391.     disassembled file. The addresses entered should be in hex-numbers and
  392.     of length max 4 digits. The digits in the hex-numbers do not have to
  393.     be upper case. You can use lower or upper case to enter a memory
  394.     address.
  395.  
  396.     The following shortcuts are available on the Edit Menu:
  397.  
  398.     ┌────────────┬───────────────┐
  399.     │  Shortcut  │    Command    │
  400.     ├────────────┼───────────────┤
  401.     │  <ALT>+C   │ Code area     │
  402.     │  <ALT>+D   │ Data area     │
  403.     │  <ALT>+G   │ Goto          │
  404.     │  <ALT>+I   │ Insert label  │
  405.     │  <ALT>+L   │ Delete label  │
  406.     └────────────┴───────────────┘
  407.  
  408.     6.1 Code area
  409.     ═════════════
  410.     The Code area command allows you to define a range of the
  411.     disassembled file as code area. This command will bring up a dialog
  412.     box at the middle of the screen to read your input.
  413.  
  414.     The dialog box has two identical input line editors to read the
  415.     starting and ending addresses of the code area. Each can accept input
  416.     of max length 4 characters. These characters must be digits, `a'..`f'
  417.     or `A'..`Z'.
  418.  
  419.     Two standard buttons, OK and Cancel, are also available to accept or
  420.     abort the settings in this dialog box.
  421.  
  422.     When you are sure that a part of the disassembled file is a code area
  423.     (that is to say: contains code instructions and temporarily a data
  424.     area) use this command to convert it into code area.
  425.  
  426.     You only specify the starting and ending addresses. The addresses are
  427.     inside the range (the code area starts at the given starting address and
  428.     ends at the given end address). For example, to define a code area at
  429.     the address 202H of the length 1 byte, you enter 202H as starting and
  430.     ending addresses.
  431.  
  432.     6.2 Data area
  433.     ═════════════
  434.     The Data area command allows you to define a range of the
  435.     disassembled file as data area. This command will bring up a dialog
  436.     box in the middle of the screen to read your input.
  437.  
  438.     The dialog box has two identical input line editors to read the
  439.     starting and ending addresses of the code area. Each can accept input
  440.     of max length 4 characters. These characters must be digits, `a'..`f'
  441.     or `A'..`Z'.
  442.  
  443.     Two standard buttons, OK and Cancel, are also available to accept or
  444.     abort the settings in this dialog box. There are also two clusters of
  445.     radio buttons to specify the type and frequency of the declared data.
  446.  
  447.     When you know that a part of the disassembled file is data area of a
  448.     specified type, i.e. it contains only data that are used in the
  449.     executable file, use this command to specify it as data area. It is
  450.     not necessary the specified area must be a code area. You can split
  451.     an existed data area into two or three different parts of the same/
  452.     different data types.
  453.  
  454.     You need to specify the starting address, ending address, type of
  455.     data and the frequency of the data area. The addresses are inside the
  456.     range (the Data area starts at the given starting address and ends at
  457.     the given end address). For example, to define a data area at the
  458.     address 202H of the length 1 byte, you enter 202H as starting and
  459.     ending addresses.
  460.  
  461.     The type together with the frequency of the data area defines the
  462.     length of the data area. The following three data types are
  463.     available:
  464.  
  465.          ■ Byte is one byte length
  466.          ■ Word is two bytes length
  467.          ■ String of variable length.
  468.  
  469.     There are three alternatives in the frequency:
  470.  
  471.          ■ Repeated
  472.          ■ Table
  473.          ■ Duplicate
  474.  
  475.     Frequency means the same data of a given type is repeated within the
  476.     given area, or it is only a table format. For example in assembly
  477.     language you can either define the variable FileName as
  478.  
  479.        FileName   DB  12 DUP (0)
  480.                    or
  481.        FileName   DB  'filename.exe'
  482.  
  483.     The first one corresponds to the Duplicate with Byte type in Yilmaz
  484.     Disassembler's data declaration. The second one corresponds to the
  485.     String data declaration.
  486.  
  487.     With the string declaration, it does not matter whether you choose
  488.     the frequency of Repeated or Table, the result is the same. Choosing
  489.     the Duplicate alternative will result in data declaration of the
  490.     following format:
  491.  
  492.        Address/DByteX DB YY DUP ('string')
  493.  
  494.     Where
  495.       Address  is data area's address in hex-integer (when labels are
  496.                not enabled).
  497.  
  498.       DByteX   is data area's label (when labels are enabled).
  499.       YY       is the number of repeating of a `string' within the given
  500.                data length.
  501.       `string' is the string from first letter inside the data area until
  502.                next occurrence of the same letter within the given data
  503.                length.
  504.  
  505.     If you choose the frequency of Repeated with any other data type than
  506.     string, the same data type will be repeatedly declared from the
  507.     starting to the ending address. For example, choosing the frequency
  508.     of Repeated with byte data type in range 120H..13FH, will result in
  509.     data declaration of
  510.  
  511.       0120H DB 00H
  512.       0121H DB 00H
  513.         .
  514.         .
  515.         .
  516.       013FH DB 00H
  517.  
  518.     The conventions used in naming of the data areas when the labels are
  519.     enabled, are as following:
  520.  
  521.      ■ DByteX for data declarations of size 1 byte.
  522.      ■ DWordX for data declarations of size 2 bytes.
  523.      ■ DStrX for string declarations.
  524.  
  525.     Where X stands for a number (can be of multiple digits) which is
  526.     added to the data name to make difference between data declarations
  527.     of the same type.
  528.  
  529.     6.3 Goto
  530.     ════════
  531.     The command Goto lets the active window to view the disassembled file
  532.     from the given address. This command will bring up a dialog box at
  533.     the middle of the screen to read your input.
  534.  
  535.     The dialog box has an input line editor to read the address you wish
  536.     to go to. This editor line will take input of max length 4
  537.     characters. These characters must be digits, `a'..`f' or `A'..`Z'.
  538.  
  539.     Two standard buttons, OK and Cancel, are also available to accept or
  540.     abort the settings in this dialog box.
  541.  
  542.     You need only to specify the address of area you wish to move. Of
  543.     course, you enter the address in hex-numbers of length max 4 digits.
  544.  
  545.     If the given address lies inside a data area which is viewed in one
  546.     line. This command will view the next following line's address at the
  547.     top of the window.
  548.  
  549.     If the given address lies inside a code instruction which is viewed
  550.     in one line. This command will view the next following instruction at
  551.     the top of the window.
  552.  
  553.     6.4 Insert label
  554.     ════════════════
  555.     This command enables you to insert the missing labels manually at
  556.     specific address within the disassembled file. Executing this command
  557.     brings up a dialog box in the middle of the screen to read your input.
  558.  
  559.     For detailed information about this dialog box refer to Edit│Goto.
  560.  
  561.     6.5 Delete label
  562.     ════════════════
  563.     This command enables you to delete undesired extra labels manually at
  564.     specific address within the disassembled file. Executing this command
  565.     will bring up a dialog box at the middle of the screen to read your
  566.     input.
  567.  
  568.     For detailed information about this dialog box refer to Edit│Goto.
  569.  
  570.     7 OPTIONS MENU
  571.     ══════════════
  572.     The Options menu provides the commands that let you customize
  573.     integrated environment's colors, your work preferences, load and save
  574.     the options.
  575.  
  576.     All the commands in this menu are missing shortcuts to evaluate them.
  577.     The only one way to access them is through the options menu.
  578.  
  579.     7.1 Colors
  580.     ══════════
  581.     The Colors command allows you to customize the colors of the elements
  582.     of the environment. This command will bring up a dialog box named
  583.     Colors at the middle of the screen.
  584.  
  585.     The Colors dialog box consists of two list boxes, a text display
  586.     area, the standard OK, Cancel, and Help buttons, and one of the
  587.     following:
  588.  
  589.          ■ On color and black & white systems, it also contains two color
  590.            palettes.
  591.          ■ On monochrome systems, it contains a set of radio buttons
  592.            instead of the palettes.
  593.  
  594.     This dialog box is where you can change the colors of different parts
  595.     of this program.
  596.  
  597.     The Group list box contains the names of the different regions of the
  598.     program that you can customize.
  599.  
  600.     When you select a group from the Group list, the Item list box
  601.     displays the names of the different views in that region.
  602.  
  603.     On color and black-and-white systems, you use the Foreground and
  604.     Background palettes to change colors.
  605.  
  606.     On monochrome systems, you use the Colors set of radio buttons
  607.     systems to change the character attributes.
  608.  
  609.     On all systems, the display text (above the Help button) shows the
  610.     current color or attribute settings.
  611.  
  612.     Changes do not take effect on the desktop until you close the Colors
  613.     dialog box by choosing OK.
  614.  
  615.     7.2 Preferences
  616.     ═══════════════
  617.     This command allows you to choose your preferences in disassembling
  618.     process. You can do so via a dialog box with several clusters of
  619.     check boxes and radio buttons for screen size/mode, program's label
  620.     displaying and auto saving files.
  621.  
  622.     The standard OK and Cancel buttons are also available to accept or
  623.     not accept the settings of the dialog box.
  624.  
  625.     If you do not have a mouse device to click on desired alternative,
  626.     you can use keystrokes. Pressing the highlighted letter on the
  627.     desired alternative will select it. You can also use the arrow keys
  628.     to move between items within a cluster and then press <SPACE> to
  629.     select the item. Finally, press the <RETURN/ENTER> when you are
  630.     satisfied with the settings in the dialog box.
  631.  
  632.     Under screen size/mode you can choose one of two alternatives to
  633.     display the information on the screen:
  634.  
  635.          ■ 25 lines x 80 columns screen display.
  636.          ■ 43/50 lines x 80 columns screen display.
  637.  
  638.     If you have EGA/VGA card then you can choose the high resolution
  639.     mode. If you do not have EGA/VGA card, choosing this mode will make
  640.     any changes in your screen display.
  641.  
  642.     The cluster named Disassembling offers you the ability to display the
  643.     labels instead of memory addresses. In this version, there are only
  644.     two alternatives of labels to display and you can choose both at the
  645.     same time, if you wish so.
  646.  
  647.     Displaying these labels will also help you to detect wrong code/data
  648.     areas via the comments displayed at the end of the disassembled line.
  649.     If a jump or routine call's label is missing, or points to wrong
  650.     memory address, a message will tell you the label is missing, will be
  651.     shown. The same thing with incorrect data area declaration.
  652.  
  653.     Selecting JMP/CALL labels means that the memory addresses and object
  654.     codes will disappear from the disassembled text. Selecting both
  655.     labels means the disassembled file will require minimum work to be
  656.     assembled again by any assembler, for example, Turbo Assembler or
  657.     MASM.
  658.  
  659.     The next cluster AutoSave enables you to save the disassembled file
  660.     and/or the whole job automatically. If you select any of these two
  661.     alternatives, the program will save the disassembled file and/or the
  662.     job on the same directory where the executable file is. The program
  663.     uses the conventional file extension "ASM" with the disassembled
  664.     files and "APP" with the job files.
  665.  
  666.     7.3 Load Options
  667.     ════════════════
  668.     This command will load the options you saved in the configuration
  669.     file "YD.CFG" last time via the command Options│Save options. The
  670.     loaded options are, your customized colors and your elections to do
  671.     your job.
  672.  
  673.     7.4 Save Options
  674.     ════════════════
  675.     This command will save your prevailingly chosen options into the
  676.     configuration file "YD.CFG". These saved options are your customized
  677.     colors and your preferences to do your job. You can use the command
  678.     Options│Load options to retrieve these options later.
  679.  
  680.     8 WINDOW MENU
  681.     ═════════════
  682.     The Window menu contains commands to tile/cascade desktop windows,
  683.     close all windows, resize/move, zoom, close currently active window,
  684.     and cycle forwards/backwards through the windows on the desktop.
  685.  
  686.     All the windows in this program have all the standard window
  687.     elements, including scroll bars, a close box, and zoom icons.
  688.  
  689.     Following shortcuts are available on the Window menu:
  690.  
  691.     ┌────────────┬────────────────┐
  692.     │  Shortcut  │  Command       │
  693.     ├────────────┼────────────────┤
  694.     │ <CTRL>+F5  │  Resize/Move   │
  695.     │ F5         │  Zoom          │
  696.     │ F6         │  Next          │
  697.     │ <SHIFT>+F6 │  Previous      │
  698.     │ <ALT>+F3   │  Close         │
  699.     └────────────┴────────────────┘
  700.  
  701.     8.1 Tile
  702.     ════════
  703.     Choose Window│Tile to tile all file viewers on the desktop, i.e. to
  704.     arrange them to be seen all on the desktop side by side.
  705.  
  706.     8.2 Cascade
  707.     ═══════════
  708.     Choose Window│Cascade to stack all file viewers on the desktop, i.e.
  709.     to arrange them to be seen all on the desktop one over another.
  710.  
  711.     8.3 Close All
  712.     ═════════════
  713.     Choose Close all to put away all windows from the desktop. Closing
  714.     all windows does not mean that the disassembled file is closed or
  715.     resulted in losing of the current work. You can use the command
  716.     File│New to open new window later on to view the currently
  717.     disassembled file again.
  718.  
  719.     8.4 Resize/Move
  720.     ═══════════════
  721.     Choose this command to change the size or position of the active
  722.     window. If you press <SHIFT> while you use the arrow keys, you can
  723.     change the size of the active window. Once you've adjusted its size
  724.     or position, press <RETURN/ENTER>.
  725.  
  726.     If a window has a Resize corner, you can drag that corner to resize
  727.     the window.
  728.  
  729.     When you choose Window│Resize/Move, the active window moves in
  730.     response to the arrow keys. Once you've moved the window to where you
  731.     want it, press <RETURN/ENTER>.
  732.  
  733.     You can also move a window by dragging its title bar with the mouse.
  734.  
  735.     8.5 Zoom
  736.     ════════
  737.     Choose Zoom to resize the active window to the maximum size. If the
  738.     window is already zoomed, you can choose this command to restore it
  739.     to its previous size.
  740.  
  741.     You can also double-click anywhere on the window's title bar (except
  742.     where an icon appears) to zoom in or out in the window.
  743.  
  744.     8.6 Next
  745.     ════════
  746.     Choose Next to cycle forwards through the windows on the desktop.
  747.  
  748.     8.7 Previous
  749.     ════════════
  750.     Choose Previous to cycle backwards through the windows on the desktop.
  751.  
  752.     8.8 Close
  753.     ═════════
  754.     Choose Close to close the active window. This does not mean that the
  755.     disassembled file is closed or resulted in losing of the current work.
  756.     You can use the command File│New to open new window later to view the
  757.     currently disassembled file again.
  758.  
  759.     You can also click the Close box in the upper left corner to close a
  760.     window.
  761.  
  762.     9 HELP
  763.     ══════
  764.     The Help menu contains only one command to view information about
  765.     this software. There is no shortcut to execute this command.
  766.  
  767.     9.1 About
  768.     ═════════
  769.     Via this command you receive a little useful information about this
  770.     software. When you choose the About command from the Help menu, a
  771.     dialog box appears, showing copyright, version number, disassembled
  772.     file's name and the available memory information.
  773.  
  774.     This dialog box hasonly one OK button which can react to your mouse
  775.     clicks or keystrokes.
  776.  
  777.     When it is time to close this dialog box, press <ESC>, <SPACE>, or
  778.     <RETURN/ENTER>, or click the OK button.
  779.  
  780.     For more information search via Help indexes: NoContext
  781.  
  782.     10 WINDOWS
  783.     ══════════
  784.     Yilmaz DisAssembler Version 1.1 (TM) uses the windows to present the
  785.     disassembled file's contents and on-line help about this software on
  786.     the screen. Many windows can be on the screen when they can overlap
  787.     each other. Each window in this software has following parts:
  788.  
  789.          ■ Shadowed frame around the window.
  790.          ■ Title at the middle of upper frame side.
  791.          ■ Frame icons around the title.
  792.          ■ Two scroll bars.
  793.          ■ Application surface where the information is displayed.
  794.  
  795.     All the windows in this software can be moved or resized by mouse
  796.     clicks/drags or arrow keys. They also can be zoomed and closed by
  797.     mouse clicks or keystrokes. You can use the arrow keys to scroll up/
  798.     down the displayed information. They use different text attributes
  799.     (colors) to view the information on the screen. For example, the
  800.     disassembled file is viewed in two different colors, Yellow
  801.     (foreground) on Blue (background) for code instructions area and
  802.     Yellow (foreground) on Cyan (background) for data area.
  803.  
  804.     All window colors can be customized via the command Options│Colors.
  805.     The following commands (or reacts to keystrokes) are available in
  806.     each window:
  807.  
  808.     ┌─────────────┬────────────────────────┐
  809.     │ Keystroke   │ Action                 │
  810.     ├─────────────┼────────────────────────┤
  811.     │ <UP>        │ Move up one line       │
  812.     │ <CTRL>+E    │ Move up one line       │
  813.     │ <DOWN>      │ Move down one line     │
  814.     │ <CTRL>+X    │ Move up one line       │
  815.     │ <RIGHT>     │ Move right one column  │
  816.     │ <CTRL>+D    │ Move right one column  │
  817.     │ <LEFT>      │ Move left one column   │
  818.     │ <CTRL>+S    │ Move left one column   │
  819.     │ <PGUP>      │ Move one page up       │
  820.     │ <CTRL>+R    │ Move one page up       │
  821.     │ <PGDN>      │ Move one page down     │
  822.     │ <CTRL>+C    │ Move one page down     │
  823.     │ <CTRL>+PgUp │ View top of file       │
  824.     │ <CTRL>+PgDn │ View bottom of file    │
  825.     │ <HOME>      │ Show from first column │
  826.     │ <END>       │ Show until last column │
  827.     └─────────────┴────────────────────────┘
  828.  
  829.     All windows can be controlled, e.g., resized, moved and closed by
  830.     using the commands on the Window menu.
  831.  
  832. End of documentation
  833.  
  834.  
  835.          ----------------end-of-author's-documentation---------------
  836.  
  837.                          Software Library Information:
  838.  
  839.                     This disk copy provided as a service of
  840.  
  841.                            Public (software) Library
  842.  
  843.          We are not the authors of this program, nor are we associated
  844.          with the author in any way other than as a distributor of the
  845.          program in accordance with the author's terms of distribution.
  846.  
  847.          Please direct shareware payments and specific questions about
  848.          this program to the author of the program, whose name appears
  849.          elsewhere in  this documentation. If you have trouble getting
  850.          in touch with the author,  we will do whatever we can to help
  851.          you with your questions. All programs have been tested and do
  852.          run.  To report problems,  please use the form that is in the
  853.          file PROBLEM.DOC on many of our disks or in other written for-
  854.          mat with screen printouts, if possible.  PsL cannot debug pro-
  855.          programs over the telephone, though we can answer questions.
  856.  
  857.          Disks in the PsL are updated  monthly,  so if you did not get
  858.          this disk directly from the PsL, you should be aware that the
  859.          files in this set may no longer be the current versions. Also,
  860.          if you got this disk from another vendor and are having prob-
  861.          lems,  be aware that  some files may have become corrupted or
  862.          lost by that vendor. Get a current, working disk from PsL.
  863.  
  864.          For a copy of the latest monthly software library newsletter
  865.          and a list of the 4,000+ disks in the library, call or write
  866.  
  867.                            Public (software) Library
  868.                                P.O.Box 35705 - F
  869.                             Houston, TX 77235-5705
  870.  
  871.                                 1-800-2424-PSL
  872.                              MC/Visa/AmEx/Discover
  873.  
  874.                           Outside of U.S. or in Texas
  875.                           or for general information,
  876.                               Call 1-713-524-6394
  877.  
  878.  
  879.