texinfo/info/variables.h

   1 /* variables.h -- Description of user visible variables in Info. */
   2
   3 /* This file is part of GNU Info, a program for reading online documentation
   4    stored in Info format.
   5
   6    Copyright (C) 1993 Free Software Foundation, Inc.
   7
   8    This program is free software; you can redistribute it and/or modify
   9    it under the terms of the GNU General Public License as published by
  10    the Free Software Foundation; either version 2, or (at your option)
  11    any later version.
  12
  13    This program is distributed in the hope that it will be useful,
  14    but WITHOUT ANY WARRANTY; without even the implied warranty of
  15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16    GNU General Public License for more details.
  17
  18    You should have received a copy of the GNU General Public License
  19    along with this program; if not, write to the Free Software
  20    Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  21
  22    Written by Brian Fox (bfox@ai.mit.edu). */
  23
  24 #if !defined (_VARIABLES_H_)
  25 #define _VARIABLES_H_
  26
  27 /* A variable (in the Info sense) is an integer value with a user-visible
  28    name.  You may supply an array of strings to complete over when the
  29    variable is set; in that case, the variable is set to the index of the
  30    string that the user chose.  If you supply a null list, the user can
  31    set the variable to a numeric value. */
  32
  33 /* Structure describing a user visible variable. */
  34 typedef struct {
  35   char *name;                   /* Polite name. */
  36   char *doc;                    /* Documentation string. */
  37   int *value;                   /* Address of value. */
  38   char **choices;               /* Array of strings or NULL if numeric only. */
  39 } VARIABLE_ALIST;
  40
  41 /* Read the name of an Info variable in the echo area and return the
  42    address of a VARIABLE_ALIST member.  A return value of NULL indicates
  43    that no variable could be read. */
  44 extern VARIABLE_ALIST *read_variable_name ();
  45
  46 /* Make an array of REFERENCE which actually contains the names of the
  47    variables available in Info. */
  48 extern REFERENCE **make_variable_completions_array ();
  49
  50 /* Set the value of an info variable. */
  51 extern void set_variable ();
  52
  53 /* The list of user-visible variables. */
  54 extern int auto_footnotes_p;
  55 extern int auto_tiling_p;
  56 extern int terminal_use_visible_bell_p;
  57 extern int info_error_rings_bell_p;
  58 extern int gc_compressed_files;
  59 extern int show_index_match;
  60 extern int info_scroll_behaviour;
  61 extern int window_scroll_step;
  62 extern int ISO_Latin_p;
  63
  64 #endif /* _VARIABLES_H_ */