/* asmdebug.h -- include file for microsoft 80x86 assembler
**
** microsoft (r) macro assembler
** copyright (c) microsoft corp 1986.  all rights reserved
**
** randy nevin
*/

/***    Output debugging information
 *      Ross Garmoe
 *      Copyright Microsoft Corporation, 1983
 *      September 27, 9 1983
 *
 *      This package was developed using concepts originally developed by
 *      Mark Zibokowski for the C version of the z editor.
 *
 *      The following set of macros output debugging information to the
 *      debugging file 'd_df'.  Output of debugging information is controlled
 *      by compile time conditionals and flags set by execution time switches.
 *      If the symbol DEBUG is defined at compile time, the macros are
 *      compiled to generate debugging information.  If DEBUG is not defined,
 *      then the macros are not compiled.  At execution time, the value of
 *      the variable 'd_debug' is compared with the value of the defined symbol
 *      DEBFLAG and if any bits match, debugging information is written.
 *      If debugging information is to be written, the information level
 *      specified in the macro is checked against the level specified at run
 *      time and information is written only if the compile level is less than
 *      the level specified at run time.
 *
 *      The macros are used as follows:
 *
 *      Define the global variables 'd_debug', 'd_dlevel', 'd_indent' and 'd_sindent'
 *      as integers and 'd_df' as a pointer to FILE.  In the argument processing
 *      routine set the value of 'd_debug' and 'd_dlevel' and open the trace output
 *      file and point to it with the variable 'd_df'.  'd_debug' , 'd_dlevel' and
 *      'd_indent' must be intialized to zero.
 *
 *      In any file of the program which is to produce debugging output,
 *      include this file 'debug.h' and define the selection symbol DEBFLAG.
 *
 *              #include debug.h
 *              #define DEBFLAG value
 *
 *      Then for any function which is to produce debug output include the
 *      following sets of macro calls.
 *
 *      At fuction entry:
 *
 *                      INDEBUG;
 *                      DEBOUT (level, ( fprintf argument string ));
 *
 *      At all function exits:
 *
 *                      DEBOUT (level, ( fprintf argument string ));
 *                      OUTDEBUG;
 *
 *      At other points of interest:
 *
 *                      DEBOUT (level, ( fprintf argument string ));
 *
 *      Note:   For the entry and exit points, the DEBOUT ((...)); string
 *              is optional.  The INDEBUG and OUTDEBUG macros control the
 *              indentation of the debug output to show the nesting levels of
 *              function calls
 *      Note:   The fprintf argument string is of the form:
 *                      d_df, "format", arg1, arg2,..., argn
 */

#ifdef DEBUG
# define INDEBUG      if(d_debug&DEBFLAG)d_indent++
# define DEBOUT(l,z)  if(d_debug&DEBFLAG&&l<=d_dlevel)\
                     {for(d_sindent=d_indent;d_sindent;d_sindent--)fprintf(d_df," ");\
                     fprintf z ;}else
# define OUTDEBUG     if(d_debug&DEBFLAG)d_indent--
  extern  long    d_debug, d_dlevel, d_indent;          /* debugging flags */
  extern  long    d_sindent;                /* indentation printing temporary */
  extern  FILE    *d_df;                    /* pointer to debug output file */
#else
# define INDEBUG
# define DEBOUT(l,z)
# define OUTDEBUG
#endif