From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id ABKpDUgqzmGu1AAAgWs5BA (envelope-from ) for ; Thu, 30 Dec 2021 22:53:12 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id yF09BkgqzmG/EAEAG6o9tA (envelope-from ) for ; Thu, 30 Dec 2021 22:53:12 +0100 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id C1AD163BD for ; Thu, 30 Dec 2021 22:53:11 +0100 (CET) Received: from localhost ([::1]:42730 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n33ME-0001Kj-L0 for larch@yhetil.org; Thu, 30 Dec 2021 16:53:10 -0500 Received: from eggs.gnu.org ([209.51.188.92]:37222) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n33Ly-0001H2-IF for guix-devel@gnu.org; Thu, 30 Dec 2021 16:52:54 -0500 Received: from mx1.riseup.net ([198.252.153.129]:51534) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n33Lr-0004TN-Lz for guix-devel@gnu.org; Thu, 30 Dec 2021 16:52:49 -0500 Received: from fews2.riseup.net (fews2-pn.riseup.net [10.0.1.84]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "mail.riseup.net", Issuer "R3" (not verified)) by mx1.riseup.net (Postfix) with ESMTPS id 4JQ27d2k0KzF4mp; Thu, 30 Dec 2021 13:52:45 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=riseup.net; s=squak; t=1640901165; bh=hsWkTgDyWdR762XNBtCj6gjWAZxPyMCcaWVwqDxwy4c=; h=Subject:From:To:Cc:Date:In-Reply-To:References:From; b=mGwt+o8Jdx5OQfE4cMvg0tQLsjyv4tZmaSI5IiWiiYe9WA1bXG1WeEIHOTJ0RH2HZ b6DrGP47ZvZp4Cj9H5AXTvHfOUuOb/t8dlYr7rp6PmqG1bXz0fwcXRCFICeqs9bofX GwBbofccWWcvqeBhEyjubSlVsxU8DoHRyk/eEpWg= X-Riseup-User-ID: C3B0C5ED090996B716C245921DB5F8D21C062C59BA23F3BCF0033DCBD56FA7FB Received: from [127.0.0.1] (localhost [127.0.0.1]) by fews2.riseup.net (Postfix) with ESMTPSA id 4JQ27b6SZNz20Ts; Thu, 30 Dec 2021 13:52:43 -0800 (PST) Message-ID: <363f0c07c5d49eac83006c628e9b8aad461650e0.camel@riseup.net> Subject: Re: Guix Documentation Meetup From: adriano To: Katherine Cox-Buday , Blake Shaw Date: Thu, 30 Dec 2021 22:52:39 +0100 In-Reply-To: <87sfuxfyps.fsf@gmail.com> References: <87y24s13u8.fsf@nonconstructivism.com> <871r2jgeed.fsf@gmail.com> <87lf0q2m7n.fsf@nonconstructivism.com> <87sfuxfyps.fsf@gmail.com> Content-Type: text/plain; charset="UTF-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=198.252.153.129; envelope-from=randomlooser@riseup.net; helo=mx1.riseup.net X-Spam_score_int: -8 X-Spam_score: -0.9 X-Spam_bar: / X-Spam_report: (-0.9 / 5.0 requ) DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=unavailable autolearn_force=no X-Spam_action: no action X-BeenThere: guix-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Guix Devel Errors-To: guix-devel-bounces+larch=yhetil.org@gnu.org Sender: "Guix-devel" X-Migadu-Flow: FLOW_IN X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1640901191; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=HbEiSLeASu8Pg22C0zD/MzWtcITbjoGu4+5geq+T6ao=; b=AFsUW1tJOom5vk8hdAEsHY96KjTuREBKLZtvhLS4qAScMcSAlYKFTdxfSi07YYTeDIzTkD ODAPPHQ4vb1lKKes39veCXBFrQ9/7asJQ4jLrfHh72TbzcrwNrXFdSMZMSDYU2hWz7XuuN ZGgKvdhtIdhinc4W/PudXYK7tkmPaDUx8zeY0Sh/8ViM+dsI1Y4hMNc+QyY9rCWV1JB+bu 4+3AgoputJkBUOrbmLqY7RtJLg/+7A1XdZ+9WfSDwd7gkX3z6ji8ntNHJ4iSyjAlYGHc6e G7pY8xs0eGF2YHRSDu7qOJe1ePU8IeNwCsXRFw41JrLoGZicl5QyfxnD3N3tgg== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1640901191; a=rsa-sha256; cv=none; b=hQGf3IGMgmuH3BJFK8jOkDKmDXmk531i+6oKfLJwB+o024d3OzE/RcoyTB1URjl4mpq0dr QXF3otEjSkzFwtPbWQwiHb5cC1pTo+g+JvmSF9LI5svoNMjOXD0WP+9sefp04XaF8zxHO3 XEP84XVT0jarpda7eSADPdHQYav+y6Q5WrX94gqrL56hmXbXHWIT6gncxxZz/ZGhWOhNUr 3+9Vn1MjmQVV1XvmxWlIVPmGlgk1gWr2vNpRJ9V/TvAa3PmqsyLEmA8hunP612dua5gEbv hWb/fptC9h7YNGArVqFQrvk9PzUfMpK7qJCy7J7p9vfmIv4UJklDYfE4Zz9DkA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=riseup.net header.s=squak header.b=mGwt+o8J; dmarc=pass (policy=none) header.from=riseup.net; spf=pass (aspmx1.migadu.com: domain of "guix-devel-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-devel-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -5.37 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=riseup.net header.s=squak header.b=mGwt+o8J; dmarc=pass (policy=none) header.from=riseup.net; spf=pass (aspmx1.migadu.com: domain of "guix-devel-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-devel-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: C1AD163BD X-Spam-Score: -5.37 X-Migadu-Scanner: scn1.migadu.com X-TUID: yXPmh0wIdOHp Il giorno dom, 12/12/2021 alle 21.50 -0600, Katherine Cox-Buday ha scritto: > - In geiser, run =,a thing-i-want-to-look-for= (this is supposedly an > apropos >   command that is supposed to search symbols for you). The command > returns >   nothing. I realize I have to import the module implementing the > thing I'm >   looking for first, thus defeating the purpose. about this, I want to report an example scheme@(guile-user)> (help tail) Did not find any object named `tail' scheme@(guile-user)> BUT scheme@(guile-user)> (help "tail") <-- notice the quotation marks ! Documentation found for: (language cps): $ktail (language tree-il): seq-tail (language tree-il): abort-tail (guile): list-tail (guile): make-struct/no-tail (srfi srfi-1): find-tail (system vm assembler): emit-tail-call-label (system vm assembler): emit-tail-call (system vm assembler): emit-tail-pointer-ref/immediate (ice-9 vlist): vlist-tail `$ktail' is an object in the (language cps) module. - Variable: $ktail `seq-tail' is a procedure in the (language tree-il) module. - Variable: seq-tail `abort-tail' is a procedure in the (language tree-il) module. - Variable: abort-tail `list-tail' is a procedure in the (guile) module. - Function: list-tail _ _ - Scheme Procedure: list-tail lst k Return the "tail" of LST beginning with its Kth element. The first element of the list is considered to be element 0. `list-tail' and `list-cdr-ref' are identical. It may help to think of `list-cdr-ref' as accessing the Kth cdr of the list, or returning the results of cdring K times down LST. `make-struct/no-tail' is a procedure in the (guile) module. - Function: make-struct/no-tail _ . _ - Scheme Procedure: make-struct/no-tail vtable . init Create a new structure. VTABLE must be a vtable structure (see Vtables). The INIT1, ... are optional arguments describing how successive fields of the structure should be initialized. Note that hidden fields (those with protection 'h') have to be manually set. If fewer optional arguments than initializable fields are supplied, fields of type 'p' get default value #f while fields of type 'u' are initialized to 0. `find-tail' is a procedure in the (srfi srfi-1) module. - Function: find-tail pred lst Return the first pair of LST whose CAR satisfies the predicate PRED, or return `#f' if no such element is found. `emit-tail-call-label' is a procedure in the (system vm assembler) module. - Function: emit-tail-call-label asm t-ff72ee5a3696d21-378b `emit-tail-call' is a procedure in the (system vm assembler) module. - Function: emit-tail-call asm `emit-tail-pointer-ref/immediate' is a procedure in the (system vm assembler) module. - Function: emit-tail-pointer-ref/immediate asm t-ff72ee5a3696d21-3ac6 t-ff72ee5a3696d21-3ac7 t-ff72ee5a3696d21-3ac8 `vlist-tail' is a procedure in the (ice-9 vlist) module. - Function: vlist-tail vlist Return the tail of VLIST. That is, help with the quotation marks reports about things even if they're in namespaces you haven't imported yet ! I'm confused about the difference between help withouth and with the quotation marks In fact scheme@(guile-user)> ,a tail (guile): list-tail # (guile): make-struct/no-tail # apropos does find at least something, but scheme@(guile-user)> (help tail) Did not find any object named `tail' help with no quotation marks finds nothing ! Why is this so ? I can't fathom that ¯\_(ツ)_/¯ And I can't even remember how I discovered this behaviour I remember I was quite puzzled when I did This is hidden and arbitrary But it IS like that ! So maybe this little trick can make your sessions a bit less frustrating ! "tail" was just a silly example I was able to come up with I'd be curious to try with some of your things :-) Bye Adriano