From unknown Sun Jun 22 04:12:58 2025 X-Loop: help-debbugs@gnu.org Subject: bug#24845: 24.5; out-of-date text in (elisp) `Autoload'? Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 01 Nov 2016 15:11:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 24845 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 24845@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.1478013017693 (code B ref -1); Tue, 01 Nov 2016 15:11:02 +0000 Received: (at submit) by debbugs.gnu.org; 1 Nov 2016 15:10:17 +0000 Received: from localhost ([127.0.0.1]:39043 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c1ahd-0000B7-3q for submit@debbugs.gnu.org; Tue, 01 Nov 2016 11:10:17 -0400 Received: from eggs.gnu.org ([208.118.235.92]:47015) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c1ahb-0000As-N3 for submit@debbugs.gnu.org; Tue, 01 Nov 2016 11:10:16 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1c1ahT-0007BP-El for submit@debbugs.gnu.org; Tue, 01 Nov 2016 11:10:10 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:56459) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1c1ahT-0007Ay-CG for submit@debbugs.gnu.org; Tue, 01 Nov 2016 11:10:07 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:37972) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c1ahN-00054y-8t for bug-gnu-emacs@gnu.org; Tue, 01 Nov 2016 11:10:07 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1c1ahK-00076c-0j for bug-gnu-emacs@gnu.org; Tue, 01 Nov 2016 11:10:01 -0400 Received: from userp1040.oracle.com ([156.151.31.81]:19792) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1c1ahJ-00076O-PA for bug-gnu-emacs@gnu.org; Tue, 01 Nov 2016 11:09:57 -0400 Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id uA1F9tS3017761 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 1 Nov 2016 15:09:56 GMT Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by aserv0022.oracle.com (8.14.4/8.13.8) with ESMTP id uA1F9sU0026578 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 1 Nov 2016 15:09:55 GMT Received: from abhmp0018.oracle.com (abhmp0018.oracle.com [141.146.116.24]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id uA1F9sN9018332 for ; Tue, 1 Nov 2016 15:09:54 GMT MIME-Version: 1.0 Message-ID: <73b474f6-2494-4b85-b92f-cee2830acd8a@default> Date: Tue, 1 Nov 2016 08:09:52 -0700 (PDT) From: Drew Adams X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 12.0.6753.5000 (x86)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Source-IP: aserv0022.oracle.com [141.146.126.234] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.0 (----) I see this in that node: Other definition types: defcustom, defgroup, defclass (*note EIEIO: (eieio)Top.), and define-skeleton (see the commentary in skeleton.el). ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ But I do not see anything appropriate in the commentary in `skeleton.el'. What is this all about? In GNU Emacs 24.5.1 (i686-pc-mingw32) of 2015-04-11 on LEG570 Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --prefix=3D3D/c/usr --host=3D3Di686-pc-mingw32' From unknown Sun Jun 22 04:12:58 2025 X-Loop: help-debbugs@gnu.org Subject: bug#24845: 24.5; out-of-date text in (elisp) `Autoload'? Resent-From: npostavs@users.sourceforge.net Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 02 Nov 2016 01:14:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24845 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Drew Adams Cc: 24845@debbugs.gnu.org Received: via spool by 24845-submit@debbugs.gnu.org id=B24845.147804919330028 (code B ref 24845); Wed, 02 Nov 2016 01:14:02 +0000 Received: (at 24845) by debbugs.gnu.org; 2 Nov 2016 01:13:13 +0000 Received: from localhost ([127.0.0.1]:39603 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c1k77-0007oG-24 for submit@debbugs.gnu.org; Tue, 01 Nov 2016 21:13:13 -0400 Received: from mail-it0-f47.google.com ([209.85.214.47]:36831) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c1k76-0007o4-BB for 24845@debbugs.gnu.org; Tue, 01 Nov 2016 21:13:12 -0400 Received: by mail-it0-f47.google.com with SMTP id m138so60737602itm.1 for <24845@debbugs.gnu.org>; Tue, 01 Nov 2016 18:13:12 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=+mLzwt1hPRUtuAAD8nR2Kr8SDPTRAwtgZhERKsKTM2I=; b=MVgnnmGvIkufyuB1R1kRyQDY2TyRp0FnaM8u9pCisPNhNCFScxWu3rn+lTBTuQAtC6 gZPNeqb0zz/iHx6pCtjJe1f6OWsGKizEJKyoP4hjwAlPsqBlynCi2E694x+aeRK5/5EF nhs1bEeFsSZW0gppwwKvoYb6zVgjIAojqx+VliFi8h1H+qkkrlW1OGT8/JiBcDf879pm 4BqSuLTgZV2aUiMact2c/zgRoswMueHOO6hYiavVqbbnY/6RxbWXP8ZPwLI4uSoKVfqN 5UUMxT4VO41gmGHP6xLf7AvielAPofhin0EyiFXo+wzhcLElQZLZ0yS/RGELpvxVN9YV X8Kg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:sender:from:to:cc:subject:references:date :in-reply-to:message-id:user-agent:mime-version; bh=+mLzwt1hPRUtuAAD8nR2Kr8SDPTRAwtgZhERKsKTM2I=; b=TiBq2f0Cy+AJWAXxC0r7Rh/KI29AnfGvBO+S/gCndnohNunh5j4KZoK4SmVrbKZTI+ H9XDX5syQUrqGpgH5SxmvoiIa8H9cQRJO7ozQhG4KAAxabWSc94MgpTVbjG/tWgnWdpx 3+Dgs/oWjhky8JXpKa3y4kaCFL5MTMOzJ+chNHPHrmCxFem71sMaYQrMqTiQvYPJLfXO VTTj6RJbOXZp7EF3M/SScWGCoTMSsysWaP6AQ2cQ0z0DoK2X80KEFbKmRZMdc6kLa8Bn cNOvVXnoAPJuYQc8zveUbxjbFz4zLc/IBhakBq67ZrUltMBYeshCGKVKw1xdwTdXgJyk L5+w== X-Gm-Message-State: ABUngve4KGL4vwE/qF0UfFo2CkhFdWx0ZRouRWQAIn+Lvl49BT4padD89rS5Sd+RSrKwVA== X-Received: by 10.107.131.150 with SMTP id n22mr1542363ioi.71.1478049186550; Tue, 01 Nov 2016 18:13:06 -0700 (PDT) Received: from zony ([45.2.7.130]) by smtp.googlemail.com with ESMTPSA id r67sm48153ioi.9.2016.11.01.18.13.05 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Tue, 01 Nov 2016 18:13:05 -0700 (PDT) From: npostavs@users.sourceforge.net References: <73b474f6-2494-4b85-b92f-cee2830acd8a@default> Date: Tue, 01 Nov 2016 21:13:48 -0400 In-Reply-To: <73b474f6-2494-4b85-b92f-cee2830acd8a@default> (Drew Adams's message of "Tue, 1 Nov 2016 08:09:52 -0700 (PDT)") Message-ID: <87oa1ypttf.fsf@users.sourceforge.net> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.7 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.7 (/) Drew Adams writes: > I see this in that node: > > Other definition types: > defcustom, defgroup, defclass (*note EIEIO: (eieio)Top.), and > define-skeleton (see the commentary in skeleton.el). > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ > > But I do not see anything appropriate in the commentary in > `skeleton.el'. What is this all about? The reference to skeleton.el's commentary was introduced in bc44be50 "* loading.texi (Autoload): Explicitly state which forms are processed specially.", there is no additional commentary in skeleton.el regarding autoloading in that revision either. I think it's just intended to be an explanation of what `define-skeleton' is. Perhaps a better link would be `(autotype) Skeleton Language', similar to how defclass has a link to eieio. diff --git i/doc/lispref/loading.texi w/doc/lispref/loading.texi index 81a1922..82bdde0 100644 --- i/doc/lispref/loading.texi +++ w/doc/lispref/loading.texi @@ -610,8 +610,8 @@ Autoload @item Other definition types: @code{defcustom}, @code{defgroup}, @code{defclass} -(@pxref{Top,EIEIO,,eieio,EIEIO}), and @code{define-skeleton} (see the -commentary in @file{skeleton.el}). +(@pxref{Top,EIEIO,,eieio,EIEIO}), and @code{define-skeleton} +(@pxref{Skeleton Language,,,autotype,Autotyping}). @end table You can also use a magic comment to execute a form at build time From unknown Sun Jun 22 04:12:58 2025 X-Loop: help-debbugs@gnu.org Subject: bug#24845: 24.5; out-of-date text in (elisp) `Autoload'? Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 02 Nov 2016 15:52:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24845 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: npostavs@users.sourceforge.net Cc: 24845@debbugs.gnu.org, drew.adams@oracle.com Reply-To: Eli Zaretskii Received: via spool by 24845-submit@debbugs.gnu.org id=B24845.147810190032485 (code B ref 24845); Wed, 02 Nov 2016 15:52:01 +0000 Received: (at 24845) by debbugs.gnu.org; 2 Nov 2016 15:51:40 +0000 Received: from localhost ([127.0.0.1]:40778 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c1xpD-0008Rt-Tp for submit@debbugs.gnu.org; Wed, 02 Nov 2016 11:51:40 -0400 Received: from eggs.gnu.org ([208.118.235.92]:55450) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c1xpC-0008Rg-5e for 24845@debbugs.gnu.org; Wed, 02 Nov 2016 11:51:38 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1c1xp3-0007Ml-Uy for 24845@debbugs.gnu.org; Wed, 02 Nov 2016 11:51:33 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_50,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:34579) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c1xp3-0007Mh-Qo; Wed, 02 Nov 2016 11:51:29 -0400 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:4907 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1c1xp3-000702-2x; Wed, 02 Nov 2016 11:51:29 -0400 Date: Wed, 02 Nov 2016 17:51:48 +0200 Message-Id: <83k2clnaln.fsf@gnu.org> From: Eli Zaretskii In-reply-to: <87oa1ypttf.fsf@users.sourceforge.net> (npostavs@users.sourceforge.net) References: <73b474f6-2494-4b85-b92f-cee2830acd8a@default> <87oa1ypttf.fsf@users.sourceforge.net> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -7.7 (-------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -7.7 (-------) > From: npostavs@users.sourceforge.net > Date: Tue, 01 Nov 2016 21:13:48 -0400 > Cc: 24845@debbugs.gnu.org > > Drew Adams writes: > > > I see this in that node: > > > > Other definition types: > > defcustom, defgroup, defclass (*note EIEIO: (eieio)Top.), and > > define-skeleton (see the commentary in skeleton.el). > > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ > > > > But I do not see anything appropriate in the commentary in > > `skeleton.el'. What is this all about? > > The reference to skeleton.el's commentary was introduced in bc44be50 "* > loading.texi (Autoload): Explicitly state which forms are processed > specially.", there is no additional commentary in skeleton.el regarding > autoloading in that revision either. I think it's just intended to be > an explanation of what `define-skeleton' is. Indeed, that's also my impression. > Perhaps a better link would be `(autotype) Skeleton Language', similar > to how defclass has a link to eieio. I think we should link to "Using Skeletons", or maybe even to "Top" in that manual, since the cross-reference is meant for those readers who don't know what skeletons are. Thanks. From unknown Sun Jun 22 04:12:58 2025 X-Loop: help-debbugs@gnu.org Subject: bug#24845: 24.5; out-of-date text in (elisp) `Autoload'? Resent-From: npostavs@users.sourceforge.net Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 05 Nov 2016 14:14:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24845 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: 24845@debbugs.gnu.org, drew.adams@oracle.com Received: via spool by 24845-submit@debbugs.gnu.org id=B24845.147835519010657 (code B ref 24845); Sat, 05 Nov 2016 14:14:01 +0000 Received: (at 24845) by debbugs.gnu.org; 5 Nov 2016 14:13:10 +0000 Received: from localhost ([127.0.0.1]:46058 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c31iX-0002lk-Sp for submit@debbugs.gnu.org; Sat, 05 Nov 2016 10:13:10 -0400 Received: from mail-it0-f52.google.com ([209.85.214.52]:35928) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c31iV-0002lS-EC; Sat, 05 Nov 2016 10:13:07 -0400 Received: by mail-it0-f52.google.com with SMTP id m138so27383674itm.1; Sat, 05 Nov 2016 07:13:07 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=luMPagRUBGohIyhdaO37qSHhtyryJGrWKEpkkf8SgIQ=; b=m9v3l9QgLb/YzYOODCwEWndhodoFvcElotRXiwg0zxZv3Rqtmbcw0gOGtOokO9F+VD QAwcKoVLdXbvETyRh4fU3zHx/+XCYYwwt4/dU18cpioVvzyFQF1WuBl+DlXN2mBRFN8u 21Jko6Qhuan3BXSYmvPAWv+YhI8jkFRCXoo5FPiwxIYSCPEqkIM8VRyaekg8K/3jdaxb 51HOixyaPVF/TUn2CyJG5c0xfLNrtr0farsdosZyByto/y9tTXcBw8zkqaF7PVNzyuTX kx5H/s11yPvGx77UKqC1NH9mX3T5tyq3MonKlDT+Z+A7Y+NO+T55NiztTMoHC5UQWAK2 o3+g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:sender:from:to:cc:subject:references:date :in-reply-to:message-id:user-agent:mime-version; bh=luMPagRUBGohIyhdaO37qSHhtyryJGrWKEpkkf8SgIQ=; b=dDFitkQe4XIYEzd0Oa3j5QBz3gE6RYgcrLxmIkcSheITIBNifoETdkxAcTe6N8oQGo knYZBVVDqIrP0suxzatV0j2U5t6K2UJ/5s0B3gy0uNm6MjFhKCARTn8qK/ZpnbqZ7BDB C9KLf+fxnPlJQ634SWaeq8Wdbkh4dPjYdr7YNGRiellvNY6q85/3k7/20/ACVQHsO6cy hBa8HPMgU18cuKf+zzdk7agqZX0EvRZKeF6psHfcX1BjA71as4McDlMvum14NmykzKc8 HSnIET2sI+75YO9+jHer3TqXBpi+IMJcpPQOPqkoDRjD0lHcL81fzgZv5FNfHhre+hJS 25bw== X-Gm-Message-State: ABUngvfuBDw3+KF8fDOM7Y4MUZoZinjfGUXOmsor6ZjMdj1RZwVOqbw1tu0elJISPffEhg== X-Received: by 10.36.89.135 with SMTP id p129mr1456413itb.2.1478355181892; Sat, 05 Nov 2016 07:13:01 -0700 (PDT) Received: from zony ([45.2.7.130]) by smtp.googlemail.com with ESMTPSA id v197sm816276ita.0.2016.11.05.07.13.00 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Sat, 05 Nov 2016 07:13:01 -0700 (PDT) From: npostavs@users.sourceforge.net References: <73b474f6-2494-4b85-b92f-cee2830acd8a@default> <87oa1ypttf.fsf@users.sourceforge.net> <83k2clnaln.fsf@gnu.org> Date: Sat, 05 Nov 2016 10:13:47 -0400 In-Reply-To: <83k2clnaln.fsf@gnu.org> (Eli Zaretskii's message of "Wed, 02 Nov 2016 17:51:48 +0200") Message-ID: <87r36qnhes.fsf@users.sourceforge.net> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.0 (/) tags 24845 fixed close 24845 25.2 quit Eli Zaretskii writes: > > I think we should link to "Using Skeletons", or maybe even to "Top" in > that manual, since the cross-reference is meant for those readers who > don't know what skeletons are. I chose Top in bb61e505.