34 |
@subheading Low level |
@subheading Low level |
35 |
|
|
36 |
@c NJFIXME |
@c NJFIXME |
37 |
@deffn primitive <group>-options-interface |
@deffn {Scheme Procedure} <group>-options-interface |
38 |
@deffnx primitive read-options-interface [SOME-INT] |
@deffnx {Scheme Procedure} read-options-interface [SOME-INT] |
39 |
@deffnx primitive print-options-interface [SOME-INT] |
@deffnx {Scheme Procedure} print-options-interface [SOME-INT] |
40 |
@deffnx primitive evaluator-traps-interface [SOME-INT] |
@deffnx {Scheme Procedure} evaluator-traps-interface [SOME-INT] |
41 |
@deffnx primitive read-options-interface [SOME-INT] |
@deffnx {Scheme Procedure} read-options-interface [SOME-INT] |
42 |
[FIXME: I have just taken the comments for C routine scm_options that |
[FIXME: I have just taken the comments for C routine scm_options that |
43 |
implements all of these. It needs to be presented better.] |
implements all of these. It needs to be presented better.] |
44 |
|
|
59 |
@c @end deftp |
@c @end deftp |
60 |
|
|
61 |
@c NJFIXME |
@c NJFIXME |
62 |
@deffn procedure <group>-options [arg] |
@deffn {Scheme Procedure} <group>-options [arg] |
63 |
@deffnx procedure read-options [arg] |
@deffnx {Scheme Procedure} read-options [arg] |
64 |
@deffnx procedure print-options [arg] |
@deffnx {Scheme Procedure} print-options [arg] |
65 |
@deffnx procedure debug-options [arg] |
@deffnx {Scheme Procedure} debug-options [arg] |
66 |
@deffnx procedure traps [arg] |
@deffnx {Scheme Procedure} traps [arg] |
67 |
These functions list the options in their group. The optional argument |
These functions list the options in their group. The optional argument |
68 |
@var{arg} is a symbol which modifies the form in which the options are |
@var{arg} is a symbol which modifies the form in which the options are |
69 |
presented. |
presented. |
81 |
up?] |
up?] |
82 |
|
|
83 |
@c NJFIXME |
@c NJFIXME |
84 |
@deffn procedure <group>-enable option-symbol |
@deffn {Scheme Procedure} <group>-enable option-symbol |
85 |
@deffnx procedure read-enable option-symbol |
@deffnx {Scheme Procedure} read-enable option-symbol |
86 |
@deffnx procedure print-enable option-symbol |
@deffnx {Scheme Procedure} print-enable option-symbol |
87 |
@deffnx procedure debug-enable option-symbol |
@deffnx {Scheme Procedure} debug-enable option-symbol |
88 |
@deffnx procedure trap-enable option-symbol |
@deffnx {Scheme Procedure} trap-enable option-symbol |
89 |
These functions set the specified @var{option-symbol} in their options |
These functions set the specified @var{option-symbol} in their options |
90 |
group. They only work if the option is boolean, and throw an error |
group. They only work if the option is boolean, and throw an error |
91 |
otherwise. |
otherwise. |
92 |
@end deffn |
@end deffn |
93 |
|
|
94 |
@c NJFIXME |
@c NJFIXME |
95 |
@deffn procedure <group>-disable option-symbol |
@deffn {Scheme Procedure} <group>-disable option-symbol |
96 |
@deffnx procedure read-disable option-symbol |
@deffnx {Scheme Procedure} read-disable option-symbol |
97 |
@deffnx procedure print-disable option-symbol |
@deffnx {Scheme Procedure} print-disable option-symbol |
98 |
@deffnx procedure debug-disable option-symbol |
@deffnx {Scheme Procedure} debug-disable option-symbol |
99 |
@deffnx procedure trap-disable option-symbol |
@deffnx {Scheme Procedure} trap-disable option-symbol |
100 |
These functions turn off the specified @var{option-symbol} in their |
These functions turn off the specified @var{option-symbol} in their |
101 |
options group. They only work if the option is boolean, and throw an |
options group. They only work if the option is boolean, and throw an |
102 |
error otherwise. |
error otherwise. |
332 |
Guile installation. This chapter describes how to find out about |
Guile installation. This chapter describes how to find out about |
333 |
Guile's configuration at run time. |
Guile's configuration at run time. |
334 |
|
|
335 |
@deffn primitive version |
@deffn {Scheme Procedure} version |
336 |
@deffnx primitive major-version |
@deffnx {Scheme Procedure} major-version |
337 |
@deffnx primitive minor-version |
@deffnx {Scheme Procedure} minor-version |
338 |
@deffnx primitive micro-version |
@deffnx {Scheme Procedure} micro-version |
339 |
|
@deffnx {C Function} scm_version () |
340 |
|
@deffnx {C Function} scm_major_version () |
341 |
|
@deffnx {C Function} scm_minor_version () |
342 |
|
@deffnx {C Function} scm_micro_version () |
343 |
Return a string describing Guile's version number, or its major, minor |
Return a string describing Guile's version number, or its major, minor |
344 |
or micro version number, respectively. |
or micro version number, respectively. |
345 |
|
|
352 |
@end deffn |
@end deffn |
353 |
|
|
354 |
@c NJFIXME not in libguile! |
@c NJFIXME not in libguile! |
355 |
@deffn primitive libguile-config-stamp |
@deffn {Scheme Procedure} libguile-config-stamp |
356 |
Return a string describing the date on which @code{libguile} was |
Return a string describing the date on which @code{libguile} was |
357 |
configured. This is used to determine whether the Guile core |
configured. This is used to determine whether the Guile core |
358 |
interpreter and the ice-9 runtime have grown out of date with one |
interpreter and the ice-9 runtime have grown out of date with one |
359 |
another. |
another. |
360 |
@end deffn |
@end deffn |
361 |
|
|
362 |
@deffn primitive %package-data-dir |
@deffn {Scheme Procedure} %package-data-dir |
363 |
|
@deffnx {C Function} scm_sys_package_data_dir () |
364 |
Return the name of the directory where Scheme packages, modules and |
Return the name of the directory where Scheme packages, modules and |
365 |
libraries are kept. On most Unix systems, this will be |
libraries are kept. On most Unix systems, this will be |
366 |
@samp{/usr/local/share/guile}. |
@samp{/usr/local/share/guile}. |
367 |
@end deffn |
@end deffn |
368 |
|
|
369 |
@deffn primitive %library-dir |
@deffn {Scheme Procedure} %library-dir |
370 |
|
@deffnx {C Function} scm_sys_library_dir () |
371 |
Return the directory where the Guile Scheme library files are installed. |
Return the directory where the Guile Scheme library files are installed. |
372 |
E.g., may return "/usr/share/guile/1.3.5". |
E.g., may return "/usr/share/guile/1.3.5". |
373 |
@end deffn |
@end deffn |
374 |
|
|
375 |
@deffn primitive %site-dir |
@deffn {Scheme Procedure} %site-dir |
376 |
|
@deffnx {C Function} scm_sys_site_dir () |
377 |
Return the directory where the Guile site files are installed. |
Return the directory where the Guile site files are installed. |
378 |
E.g., may return "/usr/share/guile/site". |
E.g., may return "/usr/share/guile/site". |
379 |
@end deffn |
@end deffn |
380 |
|
|
381 |
@deffn primitive parse-path path [tail] |
@deffn {Scheme Procedure} parse-path path [tail] |
382 |
|
@deffnx {C Function} scm_parse_path (path, tail) |
383 |
Parse @var{path}, which is expected to be a colon-separated |
Parse @var{path}, which is expected to be a colon-separated |
384 |
string, into a list and return the resulting list with |
string, into a list and return the resulting list with |
385 |
@var{tail} appended. If @var{path} is @code{#f}, @var{tail} |
@var{tail} appended. If @var{path} is @code{#f}, @var{tail} |
386 |
is returned. |
is returned. |
387 |
@end deffn |
@end deffn |
388 |
|
|
389 |
@deffn primitive search-path path filename [extensions] |
@deffn {Scheme Procedure} search-path path filename [extensions] |
390 |
|
@deffnx {C Function} scm_search_path (path, filename, extensions) |
391 |
Search @var{path} for a directory containing a file named |
Search @var{path} for a directory containing a file named |
392 |
@var{filename}. The file must be readable, and not a directory. |
@var{filename}. The file must be readable, and not a directory. |
393 |
If we find one, return its full filename; otherwise, return |
If we find one, return its full filename; otherwise, return |