scm_ documentation

scm_ documentation

[Jon Wilson]

Hi,
This doesn't seem to have gotten sent the first time around, so I'm trying 
again.  If the list gets two messages... my apologies.

Is there any documentation for the scm_ interface (replacement for gh_)?

I've looked in the guile manual at
http://www.gnu.org/software/guile/docs/guile-ref/index.html, but all I've
found is the section on trasitioning from gh_ to scm_, which isn't very
complete.  I haven't looked through every page of the manual, but I have
looked in the procedure index, and not found several of the scm_ functions
which are mentioned in the gh_ to scm_ transition page.

Regards,
Jon



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

Re: scm_ documentation

[Kevin Ryde]

Jon Wilson <j85wilson@fastmail.fm> writes:
>
> but all I've found is the section on trasitioning from gh_ to scm_,
> which isn't very complete.

What gh funcs are missing for instance?

> and not found several of the scm_ functions which are mentioned in
> the gh_ to scm_ transition page.

Such as?  It's not good to recommend something that's not otherwise
documented.

(Make sure you're looking at the new 1.8 release manual, it's had some
work since 1.6 series.)


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

Re: scm_ documentation

[Jon Wilson]

Hi Kevin,

Thanks for responding!

Note, I just saw the 1.8 release message and new manual today.  Everything 
in this email still applies to 1.6, however.

Kevin Ryde wrote:
> Jon Wilson <j85wilson@fastmail.fm> writes:
> 
>>but all I've found is the section on trasitioning from gh_ to scm_,
>>which isn't very complete.
> 
> 
> What gh funcs are missing for instance?
> 

I actually intended to mean that the gh_ to scm_ section was not a very 
complete documentation of the scm_ interface.  Of course, there is no 
reason it should be a complete doc of scm_; that is not its purpose.  In 
the absence of any other scm_ doc, the statement should be taken to mean 
that the only existing doc (that I could find) for scm_ is rather 
incomplete.  However, I realize that that was not really clear from what I 
actually said.  Sorry. :-/

> 
>>and not found several of the scm_ functions which are mentioned in
>>the gh_ to scm_ transition page.
> 
> 
> Such as? 

scm_mem2str is the particular one that I was looking for.  It is mentioned 
on the gh_ to scm_ transition page as the scm_ replacement for gh_str2scm.

Also, all of the following are found on the gh_ to scm_ page, but are not 
mentioned in the procedure index.

scm_c_eval_string
scm_c_primitive_load
SCM_DEFER_INTS
SCM_ALLOW_INTS
SCM_DEFER_INTS
scm_ulong2num
scm_long2num
scm_make_real
scm_mem2string
scm_makfrom0str
scm_str2symbol
scm_str02symbol
scm_num2int
scm_num2ulong
scm_num2long
scm_num2dbl
SCM_VALIDATE_CHAR
SCM_BOOLP
SCM_NUMBERP
SCM_INEXACTP
SCM_EQ_P
scm_eq_p
scm_eqv_p
scm_equal_p
scm_string_equal_p
SCM_NULLP
SCM_CXXR
SCM_CXXXR
scm_listify
scm_num2ulong
scm_listify
scm_apply

> It's not good to recommend something that's not otherwise
> documented.

I'm not quite sure what you mean by this.  What was I recommending?

> (Make sure you're looking at the new 1.8 release manual, it's had some
> work since 1.6 series.)

Well, it seems to make sense for me to look at the 1.6 manual, as I am 
using guile 1.6.4.  I may soon move to guile 1.8.x, but currently 1.6.4 is 
what I am using.

Regards,
Jon


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

Re: scm_ documentation

[Kevin Ryde]

Jon Wilson <j85wilson@fastmail.fm> writes:
>
> Everything in this email still applies to 1.6, however.

Alas the 1.6 manual hasn't been getting updates, not beyond the level
of fixing outright errors.

> I actually intended to mean that the gh_ to scm_ section was not a
> very complete documentation of the scm_ interface.  Of course, there
> is no reason it should be a complete doc of scm_; that is not its
> purpose.

Yep.

> In the absence of any other scm_ doc, the statement should
> be taken to mean that the only existing doc (that I could find) for
> scm_ is rather incomplete.

In 1.8 it's improving.

> scm_mem2str is the particular one that I was looking for.  It is
> mentioned on the gh_ to scm_ transition page as the scm_ replacement
> for gh_str2scm.

Hmm.  Yes, alas only digging in the source reveals what it does :-(.

> Also, all of the following are found on the gh_ to scm_ page, but are
> not mentioned in the procedure index.

They've improved in the new release, I think they're all in good shape
now.

> What was I recommending?

I meant if the manual recommends you transition to something, then
that something ought to be described ...


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

Re: scm_ documentation

[Jon Wilson]

Hi Kevin,

Thanks for your help.  I guess it really is just time to move to 1.8...

Regards,
Jon


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

scm_ documentation

[Jon Wilson]

Hi,
Is there any documentation for the scm_ interface (replacement for gh_)?

I've looked in the guile manual at 
http://www.gnu.org/software/guile/docs/guile-ref/index.html, but all I've 
found is the section on trasitioning from gh_ to scm_, which isn't very 
complete.  I haven't looked through every page of the manual, but I have 
looked in the procedure index, and not found several of the scm_ functions 
which are mentioned in the gh_ to scm_ transition page.

Regards,
Jon


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