mirror of
https://git.savannah.gnu.org/git/guile.git
synced 2025-04-30 11:50:28 +02:00
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.
241 lines
7.6 KiB
C
241 lines
7.6 KiB
C
/* 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"
|
||
}
|