unofficial mirror of bug-guile@gnu.org 
 help / color / mirror / Atom feed
* bug#41981: Reference Manual on Vtables: Missing Information on Permission "h"
@ 2020-06-21 13:51 Sebastian Miele
  2020-06-21 16:29 ` dsmich
  0 siblings, 1 reply; 3+ messages in thread
From: Sebastian Miele @ 2020-06-21 13:51 UTC (permalink / raw)
  To: 41981

I am on the current master branch. The standard-vtable-fields is
"pwuhuhpwphuhuhuh" on my system and something similar in the Reference
Manual. In particular, it contains the permission letter "h", but I find
no explanation in the manual what that means.

Section 6.6.18.1 (Vtables) just mentions: "It used to be that the second
letter for each field was a permission code, such as ‘w’ for writable or
‘r’ for read-only." And that read-only has become depriciated.

At the end of section 6.6.18.4 (Meta-Vtables) is an example:

  (define* (make-vtable fields #:optional printer)
    (make-struct/no-tail <standard-vtable>
      (make-struct-layout fields)
      printer))

Without information on "h", I was not able to make sense of the fact,
that fields with permission "h" somehow seem to be skipped by
make-struct/no-tail when processing the two init values. In particular,
for some reason, the value of printer is put into field 3 of the new
structure and not in field 1, almost certainly somehow because fields 1
and 2 have "h".

"h" should be documented.





^ permalink raw reply	[flat|nested] 3+ messages in thread

* bug#41981: Reference Manual on Vtables: Missing Information on Permission "h"
  2020-06-21 13:51 bug#41981: Reference Manual on Vtables: Missing Information on Permission "h" Sebastian Miele
@ 2020-06-21 16:29 ` dsmich
  2020-06-22 13:42   ` Sebastian Miele
  0 siblings, 1 reply; 3+ messages in thread
From: dsmich @ 2020-06-21 16:29 UTC (permalink / raw)
  To: 'sebastian.miele@gmail.com'; +Cc: '41981@debbugs.gnu.org'

[-- Attachment #1: Type: text/plain, Size: 770 bytes --]

Is is documented in the docstring:

scheme@(guile-user)> ,d make-struct-layout
- Scheme Procedure: make-struct-layout fields
 Return a new structure layout object.

 FIELDS must be a string made up of pairs of characters strung
 together. The first character of each pair describes a field type,
 the second a field protection. Allowed types are 'p' for
 GC-protected Scheme data, 'u' for unprotected binary data. Allowed
 protections are 'w' for normal fields or 'h' for hidden fields.

 Hidden fields are writable, but they will not consume an
 initializer arg passed to `make-struct'. They are useful to add
 slots to a struct in a way that preserves backward-compatibility
 with existing calls to `make-struct', especially for derived
 vtables.



[-- Attachment #2: Type: text/html, Size: 1184 bytes --]

^ permalink raw reply	[flat|nested] 3+ messages in thread

* bug#41981: Reference Manual on Vtables: Missing Information on Permission "h"
  2020-06-21 16:29 ` dsmich
@ 2020-06-22 13:42   ` Sebastian Miele
  0 siblings, 0 replies; 3+ messages in thread
From: Sebastian Miele @ 2020-06-22 13:42 UTC (permalink / raw)
  To: dsmich; +Cc: '41981@debbugs.gnu.org'

dsmich@roadrunner.com writes:
> Is is documented in the docstring:
>
> scheme@(guile-user)> ,d make-struct-layout

In the reference manual, a description of make-struct-layout directly
precedes the '(define* (make-vtable ..) ..)' example that cannot be
understood without somehow grasping what is documented about "h" in the
docstring of make-struct-layout. However, the description of
make-struct-layout in the reference manual says: "FIELDS is as described
under ‘make-vtable’ (*note Vtables::)". But that description lacks the
information on "h".

It may be a matter of opinion. But my opinion stronly is that
descriptions about the behavior around permission "h" do should appear
in the reference manual in two places: The description of make-vtable
and the description of make-struct/no-tail.

After glancing at libguile/struct.c, "w", "h", and the depreciated "r"
seem in fact to be all possible permissions. I will prepare a patch after
I finish getting a good overview of Guile.





^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2020-06-22 13:42 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-06-21 13:51 bug#41981: Reference Manual on Vtables: Missing Information on Permission "h" Sebastian Miele
2020-06-21 16:29 ` dsmich
2020-06-22 13:42   ` Sebastian Miele

unofficial mirror of bug-guile@gnu.org 

This inbox may be cloned and mirrored by anyone:

	git clone --mirror https://yhetil.org/guile-bugs/0 guile-bugs/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 guile-bugs guile-bugs/ https://yhetil.org/guile-bugs \
		bug-guile@gnu.org
	public-inbox-index guile-bugs

Example config snippet for mirrors.
Newsgroups are available over NNTP:
	nntp://news.yhetil.org/yhetil.lisp.guile.bugs
	nntp://news.gmane.io/gmane.lisp.guile.bugs


AGPL code for this site: git clone http://ou63pmih66umazou.onion/public-inbox.git