Source

XEmacs / src / debug.c

/* Debugging aids -- togglable assertions.
   Copyright (C) 1994 Free Software Foundation, Inc.

This file is part of XEmacs.

XEmacs is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2, or (at your option) any
later version.

XEmacs is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
for more details.

You should have received a copy of the GNU General Public License
along with XEmacs; see the file COPYING.  If not, write to
the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.  */

/* Synched up with: Not in FSF. */

/* This file has been Mule-ized. */

/* Written by Chuck Thompson */

#include <config.h>
#include "lisp.h"
#include "debug.h"
#include "bytecode.h"

/*
 * To add a new debug class:
 * 1.  Add a symbol definition for it here, if one doesn't exist
 *     elsewhere.  If you add it here, make sure to add a defsymbol
 *     line for it in syms_of_debug.
 * 2.  Add an extern definition for the symbol to debug.h.
 * 3.  Add entries for the class to struct debug_classes in debug.h.
 * 4.  Add a FROB line for it in xemacs_debug_loop.
 */

Lisp_Object Qredisplay, Qbuffers, Qfaces;
Lisp_Object Qwindows, Qframes, Qdevices;

struct debug_classes active_debug_classes;

enum debug_loop
{
  ADD,
  DELETE,
  LIST,
  ACTIVE,
  INIT,
  VALIDATE,
  TYPE,
  SETTYPE
};

static Lisp_Object
xemacs_debug_loop (enum debug_loop op, Lisp_Object class, Lisp_Object type)
{
  int flag = ((op == ADD) ? 1 : 0);
  Lisp_Object retval = Qnil;

#define FROB(item)\
  if (op == LIST || op == ACTIVE || op == INIT || EQ (class, Q##item))	\
    {									\
      if (op == ADD || op == DELETE || op == INIT)			\
	active_debug_classes.item = flag;				\
      else if (op == LIST						\
	       || (op == ACTIVE && active_debug_classes.item))		\
	retval = Fcons (Q##item, retval);				\
      else if (op == VALIDATE)						\
	return Qt;							\
      else if (op == SETTYPE)						\
        active_debug_classes.types_of_##item = XINT (type);		\
      else if (op == TYPE)						\
        retval = make_int (active_debug_classes.types_of_##item), Qnil; \
      if (op == INIT) active_debug_classes.types_of_##item = VALBITS;	\
    }

  FROB (redisplay);
  FROB (buffers);
  FROB (extents);
  FROB (faces);
  FROB (windows);
  FROB (frames);
  FROB (devices);
  FROB (byte_code);

  return retval;
#undef FROB
}

DEFUN ("add-debug-class-to-check", Fadd_debug_class_to_check, 1, 1, 0, /*
Add a debug class to the list of active classes.
*/
       (class))
{
  if (NILP (xemacs_debug_loop (VALIDATE, class, Qnil)))
    error ("No such debug class exists");
  else
    xemacs_debug_loop (ADD, class, Qnil);

  return (xemacs_debug_loop (ACTIVE, Qnil, Qnil));
}

DEFUN ("delete-debug-class-to-check", Fdelete_debug_class_to_check, 1, 1, 0, /*
Delete a debug class from the list of active classes.
*/
       (class))
{
  if (NILP (xemacs_debug_loop (VALIDATE, class, Qnil)))
    error ("No such debug class exists");
  else
    xemacs_debug_loop (DELETE, class, Qnil);

  return (xemacs_debug_loop (ACTIVE, Qnil, Qnil));
}

DEFUN ("debug-classes-being-checked", Fdebug_classes_being_checked, 0, 0, 0, /*
Return a list of active debug classes.
*/
       ())
{
  return (xemacs_debug_loop (ACTIVE, Qnil, Qnil));
}

DEFUN ("debug-classes-list", Fdebug_classes_list, 0, 0, 0, /*
Return a list of all defined debug classes.
*/
       ())
{
  return (xemacs_debug_loop (LIST, Qnil, Qnil));
}

DEFUN ("set-debug-classes-to-check", Fset_debug_classes_to_check, 1, 1, 0, /*
Set which classes of debug statements should be active.
CLASSES should be a list of debug classes.
*/
       (classes))
{
  Lisp_Object rest;

  CHECK_LIST (classes);

  /* Make sure all objects in the list are valid.  If anyone is not
     valid, reject the entire list without doing anything. */
  LIST_LOOP (rest, classes )
    {
      if (NILP (xemacs_debug_loop (VALIDATE, XCAR (rest), Qnil)))
	error ("Invalid object in class list");
    }

  LIST_LOOP (rest, classes)
    Fadd_debug_class_to_check (XCAR (rest));

  return (xemacs_debug_loop (ACTIVE, Qnil, Qnil));
}

DEFUN ("set-debug-class-types-to-check", Fset_debug_class_types_to_check, 2, 2, 0, /*
For the given debug CLASS, set which TYPES are actually interesting.
TYPES should be an integer representing the or'd value of all desired types.
Lists of defined types and their values are located in the source code.
*/
       (class, type))
{
  CHECK_INT (type);
  if (NILP (xemacs_debug_loop (VALIDATE, class, Qnil)))
    error ("Invalid debug class");

  xemacs_debug_loop (SETTYPE, class, type);

  return (xemacs_debug_loop (TYPE, class, Qnil));
}

DEFUN ("debug-types-being-checked", Fdebug_types_being_checked, 1, 1, 0, /*
For the given CLASS, return the associated type value.
*/
       (class))
{
  if (NILP (xemacs_debug_loop (VALIDATE, class, Qnil)))
    error ("Invalid debug class");

  return (xemacs_debug_loop (TYPE, class, Qnil));
}

void
syms_of_debug (void)
{
  defsymbol (&Qredisplay, "redisplay");
  defsymbol (&Qbuffers, "buffers");
  defsymbol (&Qfaces, "faces");
  defsymbol (&Qwindows, "windows");
  defsymbol (&Qframes, "frames");
  defsymbol (&Qdevices, "devices");
  /* defsymbol (&Qbyte_code, "byte-code"); in bytecode.c */

  DEFSUBR (Fadd_debug_class_to_check);
  DEFSUBR (Fdelete_debug_class_to_check);
  DEFSUBR (Fdebug_classes_being_checked);
  DEFSUBR (Fdebug_classes_list);
  DEFSUBR (Fset_debug_classes_to_check);
  DEFSUBR (Fset_debug_class_types_to_check);
  DEFSUBR (Fdebug_types_being_checked);
}

void
vars_of_debug (void)
{
  /* If you need to have any classes active early on in startup, then
     the flags should be set here.
     All functions called by this function are "allowed" according
     to emacs.c. */
  xemacs_debug_loop (INIT, Qnil, Qnil);
}
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.