From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.devel Subject: Re: Add hints to documentation of car and cdr for (e)lisp newcomers - take 2 Date: Thu, 15 Jul 2021 01:49:23 +0200 Message-ID: References: <8735shrl57.fsf@tullinup.koldfront.dk> <83v95c7v3v.fsf@gnu.org> <87bl74evd7.fsf@gnus.org> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="31989"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Eli Zaretskii , =?UTF-8?Q?Adam_Sj=C3=B8gren?= , Emacs developers To: Lars Ingebrigtsen Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Thu Jul 15 01:50:33 2021 Return-path: Envelope-to: ged-emacs-devel@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 1m3oe8-00084j-Uh for ged-emacs-devel@m.gmane-mx.org; Thu, 15 Jul 2021 01:50:32 +0200 Original-Received: from localhost ([::1]:46004 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1m3oe7-0006SM-Sm for ged-emacs-devel@m.gmane-mx.org; Wed, 14 Jul 2021 19:50:31 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:33182) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1m3odG-0005nA-UH for emacs-devel@gnu.org; Wed, 14 Jul 2021 19:49:38 -0400 Original-Received: from mail-pg1-f173.google.com ([209.85.215.173]:38629) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1m3odF-0005xi-DO; Wed, 14 Jul 2021 19:49:38 -0400 Original-Received: by mail-pg1-f173.google.com with SMTP id h4so4170588pgp.5; Wed, 14 Jul 2021 16:49:36 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc:content-transfer-encoding; bh=6MUcpEwGKpiXcbHXANGPquLD0eg6Jj2eaMgBSOWdxsM=; b=s3C7npBAdyLiMbTRFD7+qTgvK1UcKshc7X6nYwjuZGG1H/yHDnsTMQhFNpBHA8AFf+ 4IBnR7OvDPm1+4Fja+l33GBkMNqrUh8+mvtH+sfXH6Cjg3JkDGcLQk9ZQp3qoi37pQa5 w/q36e/ohxLF/wa/Sf8BH6bzt7O/UlksyfqYBz+D3JPHQJAFRERzzmmJqp+N9PFxnSS4 ZHXSGvv2Rsx+3KixTwqMdW7LKi8tskPdK6Tp9cb4kF75E1lKbLGrASHgH1G5KdNYECM5 E0w200eGXuJZZaxWdWyze286NuFW3Uo1/HtKMkex7n9hh0yqhsV5QgmNNxWV0/RoLFUl 4dHg== X-Gm-Message-State: AOAM530SXFySx8yFxtQr2ZbzLCNiC5WJspGBn3QD9vtIDa5BLyH2Susf 2O6+p+o+EWS45w9S7NllgySwdvLKDIpGMiCyIhBgvqbtpJ+0BQ== X-Google-Smtp-Source: ABdhPJyKvhA8I8iBAodeliTArfODVwuzEw9bqPFo/91gO2ChVcybWDPnQPmIHM2ZYAPY5eoFH04Cufajuu+hu7Vx88g= X-Received: by 2002:a62:520e:0:b029:30b:fc21:975d with SMTP id g14-20020a62520e0000b029030bfc21975dmr536272pfb.57.1626306575165; Wed, 14 Jul 2021 16:49:35 -0700 (PDT) In-Reply-To: <87bl74evd7.fsf@gnus.org> Received-SPF: pass client-ip=209.85.215.173; envelope-from=stefankangas@gmail.com; helo=mail-pg1-f173.google.com X-Spam_score_int: -13 X-Spam_score: -1.4 X-Spam_bar: - X-Spam_report: (-1.4 / 5.0 requ) BAYES_00=-1.9, FREEMAIL_FORGED_FROMDOMAIN=0.249, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.249, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:271229 Archived-At: Lars Ingebrigtsen writes: > The doc strings could say something terse like "The `car' is usually the > first element in LIST, and the `cdr' is usually the rest of LIST" > perhaps? The R6RS does it with examples: (car pair) procedure Returns the contents of the car field of pair. (car =E2=80=99(a b c)) =E2=87=92 a (car =E2=80=99((a) b c d)) =E2=87=92 (a) (car =E2=80=99(1 . 2)) =E2=87=92 1 (car =E2=80=99()) &assertion exception https://docs.racket-lang.org/r6rs/r6rs-std/r6rs-Z-H-14.html#node_idx_612