1
Fork 0
mirror of https://git.savannah.gnu.org/git/guile.git synced 2025-04-30 11:50:28 +02:00
guile/libguile/options.c
Jim Blandy 3eeba8d4f5 * chars.c (scm_lowers, scm_uppers, scm_charnames, scm_charnums),
eval.c (s_expression, s_test, s_body, s_bindings, s_variable,
s_clauses, s_formals): Variables now const.
* eval.c (promsmob): Now const.
* macros.c (macrosmob): Now const.
* smob.c (scm_newsmob): Smobfuns argument now points to const.
(freecell, flob, bigob): Now const.
* dynl.c (scm_make_argv_from_stringlist, scm_coerce_rostring),
error.c (scm_error, scm_syserror, scm_syserror_msg,
scm_num_overflow, scm_out_of_range, scm_wrong_type_arg,
scm_memory_error, scm_misc_error, scm_wta), macros.c
(scm_make_synt), feature.c (scm_add_feature), filesys.c
(scm_input_waiting_p), gc.c (scm_gc_start, scm_igc,
scm_must_malloc, scm_must_realloc), gsubr.c (scm_make_gsubr),
numbers.c (scm_num2dbl, scm_two_doubles, scm_num2long,
scm_num2long_long, scm_num2ulong),
options.c (scm_options), posix.c (scm_convert_exec_args,
environ_list_to_c), procs.c (scm_make_subr_opt, scm_make_subr),
ramap.c (scm_ramapc), read.c (scm_flush_ws), socket.c
(scm_sock_fd_to_port, scm_fill_sockaddr, scm_addr_vector), stime.c
(setzone, restorezone, bdtime2c), strop.c (scm_i_index),
strports.c (scm_mkstrport), symbols.c (scm_intern_obarray_soft,
scm_intern_obarray, scm_intern, scm_intern0,
scm_sysintern0_no_module_lookup, scm_sysintern, scm_sysintern0,
scm_symbol_value0), unif.c (scm_aind, scm_shap2ra): Argument
indicating calling subr, error message text, reason for error,
symbol name or feature name are now pointer to const.
* snarf.h (SCM_PROC, SCM_PROC1): String variables are now const.
* procs.c (scm_init_iprocs): iproc argument now points to const.
* pairs.c (cxrs): Now const.
* chars.h, error.h, feature.h, filesys.h, gc.h, gsubr.h, macros.h,
numbers.h, options.h, procs.h, ramap.h, read.h, smob.h,
strports.h, symbols.h, unif.h: Update variable declarations and
function prototypes for above changes.
* dynl.c, dynl-dld.c, dynl-dl.c, dynl-shl.c (sysdep_dynl_link,
sysdep_dynl_unlink, sysdep_dynl_func): Arguments FNAME, SUBR, and
SYMB now point to const.
1999-02-06 12:31:04 +00:00

241 lines
7.6 KiB
C
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/* Copyright (C) 1995, 1996, 1998 Free Software Foundation
*
* This program 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.
*
* This program 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 this software; see the file COPYING. If not, write to
* the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
* Boston, MA 02111-1307 USA
*
* As a special exception, the Free Software Foundation gives permission
* for additional uses of the text contained in its release of GUILE.
*
* The exception is that, if you link the GUILE library with other files
* to produce an executable, this does not by itself cause the
* resulting executable to be covered by the GNU General Public License.
* Your use of that executable is in no way restricted on account of
* linking the GUILE library code into it.
*
* This exception does not however invalidate any other reasons why
* the executable file might be covered by the GNU General Public License.
*
* This exception applies only to the code released by the
* Free Software Foundation under the name GUILE. If you copy
* code from other Free Software Foundation releases into a copy of
* GUILE, as the General Public License permits, the exception does
* not apply to the code that you add in this way. To avoid misleading
* anyone as to the status of such modified files, you must delete
* this exception notice from them.
*
* If you write modifications of your own for GUILE, it is your choice
* whether to permit this exception to apply to your modifications.
* If you do not wish that, delete this exception notice.
*
* The author can be reached at djurfeldt@nada.kth.se
* Mikael Djurfeldt, SANS/NADA KTH, 10044 STOCKHOLM, SWEDEN */
#include <stdio.h>
#include "_scm.h"
#include "options.h"
/* {Run-time options}
*
* This is the basic interface for low-level configuration of the
* Guile library. It is used for configuring the reader, evaluator,
* printer and debugger.
*
* Motivation:
*
* 1. Altering option settings can have side effects.
* 2. Option values can be stored in native format.
* (Important for efficiency in, e. g., the evaluator.)
* 3. Doesn't use up name space.
* 4. Options can be naturally grouped => ease of use.
*/
/* scm_options is the core of all options interface procedures.
*
* Some definitions:
*
* Run time options in Guile are arranged in groups. Each group
* affects a certain aspect of the behaviour of the library.
*
* An "options interface procedure" manages one group of options. It
* can be used to check or set options, or to get documentation for
* all options of a group. The options interface procedure is not
* intended to be called directly by the user. The user should
* instead call
*
* (<group>-options)
* (<group>-options 'help)
* (<group>-options 'full)
*
* to display current option settings (The second version also
* displays documentation. The third version also displays
* information about programmer's options.), and
*
* (<group>-enable '<option-symbol>)
* (<group>-disable '<option-symbol>)
* (<group>-set! <option-symbol> <value>)
* (<group>-options <option setting>)
*
* to alter the state of an option (The last version sets all
* options according to <option setting>.) where <group> is the name
* of the option group.
*
* An "option setting" represents the state of all low-level options
* managed by one options interface procedure. It is a list of
* single symbols and symbols followed by a value.
*
* For boolean options, the presence of the symbol of that option in
* the option setting indicates a true value. If the symbol isn't a
* member of the option setting this represents a false value.
*
* Other options are represented by a symbol followed by the value.
*
* If scm_options is called without arguments, the current option
* setting is returned. If the argument is an option setting, options
* are altered and the old setting is returned. If the argument isn't
* a list, a list of sublists is returned, where each sublist contains
* option name, value and documentation string.
*/
SCM_SYMBOL (scm_yes_sym, "yes");
SCM_SYMBOL (scm_no_sym, "no");
static SCM protected_objects;
SCM
scm_options (arg, options, n, s)
SCM arg;
scm_option options[];
int n;
const char *s;
{
int i, docp = (!SCM_UNBNDP (arg)
&& !SCM_NULLP (arg)
&& (SCM_IMP (arg) || SCM_NCONSP (arg)));
/* Let `arg' GC protect the arguments */
SCM new_mode = arg, ans = SCM_EOL, ls;
for (i = 0; i < n; ++i)
{
ls = docp ? scm_cons ((SCM) options[i].doc, SCM_EOL) : ans;
switch (options[i].type)
{
case SCM_OPTION_BOOLEAN:
if (docp)
ls = scm_cons ((int) options[i].val
? scm_yes_sym
: scm_no_sym,
ls);
break;
case SCM_OPTION_INTEGER:
ls = scm_cons (SCM_MAKINUM ((int) options[i].val), ls);
break;
case SCM_OPTION_SCM:
ls = scm_cons ((SCM) options[i].val, ls);
}
if (!((options[i].type == SCM_OPTION_BOOLEAN)
&& !docp
&& ! (int) options[i].val))
ls = scm_cons ((SCM) options[i].name, ls);
ans = docp ? scm_cons (ls, ans) : ls;
}
if (!(SCM_UNBNDP (new_mode) || docp))
{
unsigned long *flags;
flags = (unsigned long *) scm_must_malloc (n * sizeof (unsigned long),
"mode buffer");
for (i = 0; i < n; ++i)
if (options[i].type == SCM_OPTION_BOOLEAN)
flags[i] = 0;
else
flags[i] = (unsigned long) options[i].val;
while (SCM_NNULLP (new_mode))
{
SCM_ASSERT (SCM_NIMP (new_mode) && SCM_CONSP (new_mode),
new_mode,
SCM_ARG1,
s);
for (i = 0; i < n; ++i)
if (SCM_CAR (new_mode) == (SCM) options[i].name)
switch (options[i].type)
{
case SCM_OPTION_BOOLEAN:
flags[i] = 1;
goto cont;
case SCM_OPTION_INTEGER:
new_mode = SCM_CDR (new_mode);
SCM_ASSERT (SCM_NIMP (new_mode)
&& SCM_CONSP (new_mode)
&& SCM_INUMP (SCM_CAR (new_mode)),
new_mode,
SCM_ARG1,
s);
flags[i] = (unsigned long) SCM_INUM (SCM_CAR (new_mode));
goto cont;
case SCM_OPTION_SCM:
new_mode = SCM_CDR (new_mode);
flags[i] = SCM_CAR (new_mode);
goto cont;
}
#ifndef SCM_RECKLESS
scm_must_free ((char *) flags);
scm_wta (SCM_CAR (new_mode), "Unknown mode flag", s);
#endif
cont:
new_mode = SCM_CDR (new_mode);
}
for (i = 0; i < n; ++i)
{
if (options[i].type == SCM_OPTION_SCM)
SCM_SETCDR (protected_objects,
scm_cons (flags[i],
scm_delq1_x (options[i].val,
SCM_CDR (protected_objects))));
options[i].val = flags[i];
}
scm_must_free ((char *) flags);
}
return ans;
}
void
scm_init_opts (func, options, n)
SCM (*func) (SCM);
scm_option options[];
int n;
{
int i;
for (i = 0; i < n; ++i)
{
options[i].name = (char *) SCM_CAR (scm_sysintern0 (options[i].name));
options[i].doc = (char *) scm_permanent_object (scm_take0str
(options[i].doc));
if (options[i].type == SCM_OPTION_SCM)
SCM_SETCDR (protected_objects,
scm_cons (options[i].val, SCM_CDR (protected_objects)));
}
func (SCM_UNDEFINED);
}
void
scm_init_options ()
{
protected_objects = scm_permanent_object (scm_cons (SCM_UNDEFINED, SCM_EOL));
#include "options.x"
}