From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Sebastian Miele Newsgroups: gmane.lisp.guile.bugs Subject: bug#41981: Reference Manual on Vtables: Missing Information on Permission "h" Date: Mon, 22 Jun 2020 15:42:46 +0200 Message-ID: <877dvzkyi1.fsf@gmail.com> References: Reply-To: sebastian.miele@gmail.com Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="26820"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: mu4e 1.4.10; emacs 26.3 Cc: "'41981@debbugs.gnu.org'" <41981@debbugs.gnu.org> To: dsmich@roadrunner.com Original-X-From: bug-guile-bounces+guile-bugs=m.gmane-mx.org@gnu.org Mon Jun 22 15:43:09 2020 Return-path: Envelope-to: guile-bugs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1jnMj5-0006oe-GV for guile-bugs@m.gmane-mx.org; Mon, 22 Jun 2020 15:43:07 +0200 Original-Received: from localhost ([::1]:52034 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jnMj4-0007DJ-J5 for guile-bugs@m.gmane-mx.org; Mon, 22 Jun 2020 09:43:06 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:53842) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jnMj0-0007D8-K1 for bug-guile@gnu.org; Mon, 22 Jun 2020 09:43:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:50183) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jnMj0-0005Uo-AT for bug-guile@gnu.org; Mon, 22 Jun 2020 09:43:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1jnMj0-0007nF-6r for bug-guile@gnu.org; Mon, 22 Jun 2020 09:43:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Sebastian Miele Original-Sender: "Debbugs-submit" Resent-CC: bug-guile@gnu.org Resent-Date: Mon, 22 Jun 2020 13:43:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 41981 X-GNU-PR-Package: guile Original-Received: via spool by 41981-submit@debbugs.gnu.org id=B41981.159283337629943 (code B ref 41981); Mon, 22 Jun 2020 13:43:02 +0000 Original-Received: (at 41981) by debbugs.gnu.org; 22 Jun 2020 13:42:56 +0000 Original-Received: from localhost ([127.0.0.1]:33496 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jnMiu-0007ms-Gw for submit@debbugs.gnu.org; Mon, 22 Jun 2020 09:42:56 -0400 Original-Received: from mail-wr1-f42.google.com ([209.85.221.42]:34763) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jnMir-0007mc-U3 for 41981@debbugs.gnu.org; Mon, 22 Jun 2020 09:42:54 -0400 Original-Received: by mail-wr1-f42.google.com with SMTP id v3so9248929wrc.1 for <41981@debbugs.gnu.org>; Mon, 22 Jun 2020 06:42:53 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=references:user-agent:from:to:cc:subject:reply-to:in-reply-to :message-id:date:mime-version:content-transfer-encoding; bh=bnsxd2/WRUyg0Uhljc0S3WDQc7lYULVQC2CKE6Fl+U8=; b=eSw2f9T/2W9l9l9oTk7KJkkq2By2iYrojGqy2m+c40tQ23n5TXTnPfpqtdZj9pD4B5 0/445h26aosJITOeA1UjDW4I+nCYcMV+fFmBgKJVfDSQQMWeElPshSNvQs8lkjAWM2p7 a1GXiVPJ5FekYeZ18pXVAkUfyPgH7WN0E9nJhTp9U7v8pnJUgsVdTetWVUGwBjJ/+Oi3 qqzEwNsEvnMb9jHe+Ne+81a09FK2HU2tJJAXd5pfcTpdXFm7twFKE22tGMvo5swQLSS9 NsmRJcApGTCQe25Xs3w2fl9SOSccmnX/8pL/ADTPVPn5qwQErGfYvD/hdjhfxFT7YxhY MKpg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:references:user-agent:from:to:cc:subject :reply-to:in-reply-to:message-id:date:mime-version :content-transfer-encoding; bh=bnsxd2/WRUyg0Uhljc0S3WDQc7lYULVQC2CKE6Fl+U8=; b=qdgBrWP6UN7WVqwxZZhVZIQZcd0Hz75keui3mBRxLpoW4uF6wr+ac9LBhk+s+eEMUr bL/4vVghGApaA0hBR6W4ygsvbJ3CkKUDnsCj9oxccwtkb90ZBYgNybNiaX8C9PdLC4KV FSzM/l1N+t6VhBhOw9QJQlIrKDqkMVLKszy8+Gh6zXGw0H+mCEiRXEyqDeFGpbrLWPJ2 lyJd6JiNNpx5qjShTJ44kdsszNxlbimBrN55zAtxDF1aSSNZTZxo4r+n1NV8nlxKiJl5 n/EvzNpnhpg2ejAQ8IpJxce8VYUPdNnySpOYsw7zRrxYs6ZT5O3i9yQ3S8q2AtNTzgFi eY2Q== X-Gm-Message-State: AOAM530CNok2PPyxsJp8W+aVDSnBLGhgPldl7NODlGYQjMtT3BocjYs7 hiEuDjeRLIfmxRGYNnFMjK1S6V7t X-Google-Smtp-Source: ABdhPJz7tS4LVA6IinPM7b5VzCf5NqisLlzEzZEOb3sjuWikHlecrTwxtQ155e9GaaQvEsHZiURGRw== X-Received: by 2002:a5d:56c7:: with SMTP id m7mr19020726wrw.223.1592833367792; Mon, 22 Jun 2020 06:42:47 -0700 (PDT) Original-Received: from huette ([2a02:908:175c:4260:33a6:b2b0:4ad5:928d]) by smtp.gmail.com with ESMTPSA id j41sm18994260wre.12.2020.06.22.06.42.46 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 22 Jun 2020 06:42:47 -0700 (PDT) In-reply-to: X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-guile@gnu.org List-Id: "Bug reports for GUILE, GNU's Ubiquitous Extension Language" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-guile-bounces+guile-bugs=m.gmane-mx.org@gnu.org Original-Sender: "bug-guile" Xref: news.gmane.io gmane.lisp.guile.bugs:9822 Archived-At: 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 =E2=80=98make-vtable=E2=80=99 (*note Vtables::)". But that descriptio= n 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.