• If you type "monprog", the program runs without saying where an eventual exception occurs.
• If you type "ad monprog", you will see the call stack in case of exception; with "ad /s myprog" you'll see also the Ada source code involved; the "/p" switch is for subunit names and parameters.

• If you want to see the source code (/S switch), it must be in a directory reachable by the GNAT compiler: the current directory, or one of the directories stored in the ADA_INCLUDE_PATH environment variable.
• The source code indicated by GBD for a generic unit is the one that is instanciated. Remedy: if you suspect a bug in a generic unit, instanciate it as an independant unit:
  

              truc.ads:     package Truc is new Machin(...);
  

  AD will then find the original generic unit.
• The file GDB.INI is ignored by AD and thus remains unchanged.
• If the program seems blocked, try to type "q" and [return].
• The /V option restores the correct text mode before the display of the results - useful for exceptions during graphics... (20.I.1998)
• Meaning of the log files:
  - AD.LOG is the output screen of AD (useful in graphic mode without /V option);
  - AD_GDB.LOG is the output of GDB;
  - AD_FILES.LOG is a list with lines numbers and complete file names.
  This file is concieved for an integrated environment like AdaCAPS (in a future version) or EDIT, a tiny editor made by the author, where AD results and compilation errors analysis is built-in - [informations here]; EDIT.EXE can be found in directory UTILITY in the AD.ZIP archive or downloaded from here.
  N.B.: format of AD_FILES.LOG changed since 17.IX.1997 version.
• Tested with GNAT 3.07 and 3.10p for DOS, under DR-DOS ¹ 7.02, MS-DOS 6.22 and MS-DOS 7.10 + Win 4.0 (Win 95 OSR 2).
• Under Norton Commander ² you can associate the extensionless executables with the AD command; add in the extension file a line like:
  

     : ad /S /P /L /WH:\ !

  (in this example, H: is a RAM disk drive)

Usage: AD [language] {/option} progname [prog. parameters]
Options:
           /P        show subunit names and parameters
           /S        show source code
           /L        make log files (AD.LOG, AD_FILES.LOG, AD_GDB.LOG)
           /Wa_dir   work directory:= `a_dir' (e.g. a ramdisk)
           /V        restore video mode
Language: one of the following:
  ENGLISH  FRANCAIS