From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: asjo@koldfront.dk (Adam =?UTF-8?Q?Sj=C3=B8gren?=) Newsgroups: gmane.emacs.bugs Subject: bug#9082: Add hints to documentation of car and cdr for (e)lisp newcomers Date: Thu, 14 Jul 2011 17:03:30 +0200 Organization: koldfront - analysis & revolution, Copenhagen, Denmark Message-ID: <8762n4ewfx.fsf@topper.koldfront.dk> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable X-Trace: dough.gmane.org 1310662127 3791 80.91.229.12 (14 Jul 2011 16:48:47 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Thu, 14 Jul 2011 16:48:47 +0000 (UTC) To: 9082@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Jul 14 18:48:42 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1QhP5d-00081w-I3 for geb-bug-gnu-emacs@m.gmane.org; Thu, 14 Jul 2011 18:48:41 +0200 Original-Received: from localhost ([::1]:47010 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QhP5c-0000DR-Ob for geb-bug-gnu-emacs@m.gmane.org; Thu, 14 Jul 2011 12:48:40 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:57106) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QhOzI-0007Mm-QQ for bug-gnu-emacs@gnu.org; Thu, 14 Jul 2011 12:42:12 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QhOzE-0003cn-5g for bug-gnu-emacs@gnu.org; Thu, 14 Jul 2011 12:42:08 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:47076) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QhOzD-0003cR-8h for bug-gnu-emacs@gnu.org; Thu, 14 Jul 2011 12:42:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1QhOzC-0004az-JX; Thu, 14 Jul 2011 12:42:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: asjo@koldfront.dk (Adam =?UTF-8?Q?Sj=C3=B8gren?=) Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 14 Jul 2011 16:42:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 9082 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.131066171817652 (code B ref -1); Thu, 14 Jul 2011 16:42:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 14 Jul 2011 16:41:58 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhOz7-0004ae-4D for submit@debbugs.gnu.org; Thu, 14 Jul 2011 12:41:58 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhNSD-0000bA-B0 for submit@debbugs.gnu.org; Thu, 14 Jul 2011 11:03:54 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QhNS3-0003yV-MO for submit@debbugs.gnu.org; Thu, 14 Jul 2011 11:03:47 -0400 Original-Received: from lists.gnu.org ([140.186.70.17]:34228) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QhNS3-0003yQ-Gt for submit@debbugs.gnu.org; Thu, 14 Jul 2011 11:03:43 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:48026) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QhNRz-0003my-5n for bug-gnu-emacs@gnu.org; Thu, 14 Jul 2011 11:03:43 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QhNRv-0003xr-1P for bug-gnu-emacs@gnu.org; Thu, 14 Jul 2011 11:03:39 -0400 Original-Received: from 2505ds5-by.0.fullrate.dk ([95.166.24.143]:59432 helo=topper.koldfront.dk) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QhNRu-0003xk-HV for bug-gnu-emacs@gnu.org; Thu, 14 Jul 2011 11:03:34 -0400 Original-Received: by topper.koldfront.dk (Postfix, from userid 1000) id E49AC50FA70D; Thu, 14 Jul 2011 17:03:30 +0200 (CEST) X-Hashcash: 1:21:110714:bug-gnu-emacs@gnu.org::XwZQoMf45NH+9659:00000000000000000000000000000000000000002j2h X-Now-Playing: Daisies, Once upon a time in the north (moi caprice) X-Face: )qY&CseJ?.:=8F#^~GcSA?F=9eu'{KAFfL1C3/A&:nE?PW\i65"ba0NS)97, Q(^@xk}n4Ou rPuR#V8I(J_@~H($[ym:`K_+]*kjvW>xH5jbgLBVFGXY:(#4P>zVBklLbdL&XxL\M)%T}3S/IS9lMJ ^St'=VZBR List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:49034 Archived-At: ** Description Adds hints to the documentation of car and cdr to help newbies remember which is which. Saying that (car|cdr) returns the (car|cdr) of a LIST is a little terse for beginners (probably the only ones looking at the documentation of such basic functions). ** ChangeLog 2011-07-14 Adam Sj=F8gren * data.c (car, cdr): add functionality hints to documentation. ** Patch =3D=3D=3D modified file 'src/data.c' *** src/data.c 2011-07-10 08:20:10 +0000 --- src/data.c 2011-07-14 13:23:02 +0000 *************** DEFUN ("floatp", Ffloatp, Sfloatp, 1, 1, *** 463,469 **** /* Extract and set components of lists */ =20=20 DEFUN ("car", Fcar, Scar, 1, 1, 0, ! doc: /* Return the car of LIST. If arg is nil, return nil. Error if arg is not nil and not a cons cell. See also `car-safe'. =20=20 See Info node `(elisp)Cons Cells' for a discussion of related basic --- 463,469 ---- /* Extract and set components of lists */ =20=20 DEFUN ("car", Fcar, Scar, 1, 1, 0, ! doc: /* Return the car (first element) of LIST. If arg is nil, re= turn nil. Error if arg is not nil and not a cons cell. See also `car-safe'. =20=20 See Info node `(elisp)Cons Cells' for a discussion of related basic *************** DEFUN ("car-safe", Fcar_safe, Scar_safe, *** 481,487 **** } =20=20 DEFUN ("cdr", Fcdr, Scdr, 1, 1, 0, ! doc: /* Return the cdr of LIST. If arg is nil, return nil. Error if arg is not nil and not a cons cell. See also `cdr-safe'. =20=20 See Info node `(elisp)Cons Cells' for a discussion of related basic --- 481,487 ---- } =20=20 DEFUN ("cdr", Fcdr, Scdr, 1, 1, 0, ! doc: /* Return the cdr (rest) of LIST. If arg is nil, return nil. Error if arg is not nil and not a cons cell. See also `cdr-safe'. =20=20 See Info node `(elisp)Cons Cells' for a discussion of related basic