undocumented function repl

undocumented function repl

[Jon Wilson]

Hi y'all,
I just ran across the function 'repl' ( #<procedure repl (read evaler 
print)>), which doesn't have a docstring, and doesn't appear in the manual 
(well, ok fine, the procedure index of the manual).  I'm using 1.8.

I tried calling it as:
(repl read primitive-eval display)
but that didn't seem to give very meaningful results.  It certainly didn't 
act like the normal guile repl.  Perhaps I just gave it the wrong 
arguments, though.

Does this function produce a normal repl?  If so, how?  If not, then what 
does it do?  Also, perhaps we should either not export it, or else document 
it in the manual.  I would volunteer to document it, but clearly, I don't 
understand it.
Regards,
Jon


_______________________________________________
Guile-user mailing list
Guile-user@gnu.org
http://lists.gnu.org/mailman/listinfo/guile-user

Re: undocumented function repl

[Neil Jerram]

Jon Wilson <j85wilson@fastmail.fm> writes:

> Hi y'all,
> I just ran across the function 'repl' ( #<procedure repl (read evaler
> print)>), which doesn't have a docstring, and doesn't appear in the
> manual (well, ok fine, the procedure index of the manual).  I'm using
> 1.8.
>

> Does this function produce a normal repl?  If so, how?  If not, then
> what does it do?  Also, perhaps we should either not export it, or
> else document it in the manual.  I would volunteer to document it, but
> clearly, I don't understand it.

I would say that it shouldn't be exported.  It's just a part of the
implementation of top-repl.

-- 
Regards,
     Neil



_______________________________________________
Guile-user mailing list
Guile-user@gnu.org
http://lists.gnu.org/mailman/listinfo/guile-user

Re: undocumented function repl

[Jon Wilson]

Hi Neil,

Neil Jerram wrote:
> Jon Wilson <j85wilson@fastmail.fm> writes:
> 
> 
>>Hi y'all,
>>I just ran across the function 'repl' ( #<procedure repl (read evaler
>>print)>), which doesn't have a docstring, and doesn't appear in the
>>manual (well, ok fine, the procedure index of the manual).  I'm using
>>1.8.
>>
> 
> 
>>Does this function produce a normal repl?  If so, how?  If not, then
>>what does it do?  Also, perhaps we should either not export it, or
>>else document it in the manual.  I would volunteer to document it, but
>>clearly, I don't understand it.
> 
> 
> I would say that it shouldn't be exported.  It's just a part of the
> implementation of top-repl.
> 

Sounds good.  Should top-repl be documented in the manual and/or with a 
docstring?  It is not in the procedure index, which I presume to mean it is 
not in the manual.  I've read the entire 1.6 manual, but not the 1.8 
manual, so I don't know for sure that it isn't documented.  Its purpose is 
fairly obvious, but its existence was unknown to me until just now.  It 
also doesn't seem to appear in the index to R5RS.

There seem to be a number of repl related procedures that are exported. 
Should all of them be available?  (Obviously some of the procedures 
returned by (apropos "repl") are not repl related, like string-replace... 
I've removed them.)

guile> (apropos "repl")
(guile): repl   #<procedure repl (read evaler print)>
(guile): scm-style-repl #<procedure scm-style-repl ()>
(guile): repl-reader    #<procedure #f (prompt)>
(guile): error-catching-repl    #<procedure error-catching-repl (r e p)>
(guile): set-repl-prompt!       #<procedure set-repl-prompt! (v)>
(guile): scm-repl-prompt
(guile): assert-repl-verbosity  #<procedure assert-repl-verbosity (v)>
(guile): scm-repl-verbose
(guile): assert-repl-print-unspecified  #<procedure 
assert-repl-print-unspecified (v)>
(guile): top-repl       #<procedure top-repl ()>
(guile): scm-repl-print-unspecified
(guile): assert-repl-silence    #<procedure assert-repl-silence (v)>
(guile): scm-repl-silent


Regards,
Jon


_______________________________________________
Guile-user mailing list
Guile-user@gnu.org
http://lists.gnu.org/mailman/listinfo/guile-user

Re: undocumented function repl

[Kevin Ryde]

Jon Wilson <j85wilson@fastmail.fm> writes:
>
> There seem to be a number of repl related procedures that are
> exported. Should all of them be available?

Probably not.  There's a fair bit of stuff in boot-9 that ought to
either made private or documented.


_______________________________________________
Guile-user mailing list
Guile-user@gnu.org
http://lists.gnu.org/mailman/listinfo/guile-user