mirror/guile
mirror/guile
1
Fork 0
mirror of https://git.savannah.gnu.org/git/guile.git synced 2025-04-29 19:30:36 +02:00
Code Activity

Review REFFIXME

Browse source 
H/t t20kdc on #guile.
This commit is contained in:
Daniel Llorens 2021-12-13 08:11:29 +01:00
parent 5759e37181
commit dc7f1b403b
3 changed files with 12 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

4
doc/ref/api-procedures.texi
View file

@ -801,8 +801,8 @@ procedure has a so-called @dfn{setter} attached, which is a procedure
for storing something into a data structure.
Procedures with setters are treated specially when the procedure appears
in the special form @code{set!} (REFFIXME). How it works is best shown
by example.
in the special form @code{set!}. @c (REFFIXME)
How it works is best shown by example.
Suppose we have a procedure called @code{foo-ref}, which accepts two
arguments, a value of type @code{foo} and an integer. The procedure

5
doc/ref/api-utility.texi
View file

@ -184,8 +184,9 @@ properties allow you to do just that.
Guile's representation of an object property is a procedure-with-setter
(@pxref{Procedures with Setters}) that can be used with the generalized
form of @code{set!} (REFFIXME) to set and retrieve that property for any
Scheme object. So, setting a property looks like this:
form of @code{set!} @c (REFFIXME)
to set and retrieve that property for any Scheme object. So, setting a
property looks like this:
@lisp
(set! (my-property obj1) value-for-obj1)

10
doc/ref/libguile-program.texi
View file

@ -610,8 +610,7 @@ The C level work required in this model usually consists of packaging
and exporting functions and application objects such that they can be
seen and manipulated on the Scheme level. To help with this, Guile's C
language interface includes utility features that aim to make this kind
of integration very easy for the application developer. These features
are documented later in this part of the manual: see REFFIXME.
of integration very easy for the application developer.
This model, though, is really just one of a range of possible
programming options. If all of the functionality that you need is
@ -704,20 +703,25 @@ written, most of the difficulties of memory management can be avoided by
using Guile's C interface features from the start.
For the full documentation on writing C code for Guile and connecting
existing C code to the Guile world, see REFFIXME.
existing C code to the Guile world, see @ref{Defining New
Foreign Object Types}, @ref{Primitive Procedures}, and @ref{Foreign
Function Interface}.
@node Basic Constraints
@subsubsection Functional and Performance Constraints
@c REFFIXME
@node Style Choices
@subsubsection Your Preferred Programming Style
@c REFFIXME
@node Program Control
@subsubsection What Controls Program Execution?
@c REFFIXME
@node User Programming
@subsection How About Application Users?