From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#21695: 25.0.50; Change most occurrences of `setq' in Emacs manual to `customize-set-variable' Date: Fri, 16 Oct 2015 16:57:37 -0700 (PDT) Message-ID: References: <97d3ff2c-9e72-4004-88a9-08130ac99a74@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1445039903 28416 80.91.229.3 (16 Oct 2015 23:58:23 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 16 Oct 2015 23:58:23 +0000 (UTC) To: 21695@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Oct 17 01:58:10 2015 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1ZnEsz-0002Xd-Kf for geb-bug-gnu-emacs@m.gmane.org; Sat, 17 Oct 2015 01:58:09 +0200 Original-Received: from localhost ([::1]:56371 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZnEsy-0004AW-S1 for geb-bug-gnu-emacs@m.gmane.org; Fri, 16 Oct 2015 19:58:08 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:36510) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZnEsv-0004AF-Sv for bug-gnu-emacs@gnu.org; Fri, 16 Oct 2015 19:58:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZnEss-0003J1-Mi for bug-gnu-emacs@gnu.org; Fri, 16 Oct 2015 19:58:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:34776) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZnEss-0003IZ-Iq for bug-gnu-emacs@gnu.org; Fri, 16 Oct 2015 19:58:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1ZnEss-0004P6-Bc for bug-gnu-emacs@gnu.org; Fri, 16 Oct 2015 19:58:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 16 Oct 2015 23:58:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 21695 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 21695-submit@debbugs.gnu.org id=B21695.144503986116902 (code B ref 21695); Fri, 16 Oct 2015 23:58:02 +0000 Original-Received: (at 21695) by debbugs.gnu.org; 16 Oct 2015 23:57:41 +0000 Original-Received: from localhost ([127.0.0.1]:53717 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZnEsW-0004OY-M8 for submit@debbugs.gnu.org; Fri, 16 Oct 2015 19:57:41 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:37457) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZnEsV-0004OP-C6 for 21695@debbugs.gnu.org; Fri, 16 Oct 2015 19:57:39 -0400 Original-Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t9GNvcSb019727 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for <21695@debbugs.gnu.org>; Fri, 16 Oct 2015 23:57:38 GMT Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by userv0021.oracle.com (8.13.8/8.13.8) with ESMTP id t9GNvcem004650 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL) for <21695@debbugs.gnu.org>; Fri, 16 Oct 2015 23:57:38 GMT Original-Received: from abhmp0019.oracle.com (abhmp0019.oracle.com [141.146.116.25]) by userv0122.oracle.com (8.13.8/8.13.8) with ESMTP id t9GNvbwp025521 for <21695@debbugs.gnu.org>; Fri, 16 Oct 2015 23:57:38 GMT In-Reply-To: <97d3ff2c-9e72-4004-88a9-08130ac99a74@default> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] X-Source-IP: userv0021.oracle.com [156.151.31.71] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" 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:107692 Archived-At: The same is apparently true for the manual "An Introduction to Programming in Emacs Lisp" (which is a fine intro to learning Elisp). What's more, it even states: "The 'custom-set-variables' function works somewhat differently than a 'setq'. While I have never learned the differences, I modify the ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 'custom-set-variables' expressions in my '.emacs' file by hand: I make the changes in what appears to me to be a reasonable manner and have not had any problems. Others prefer to use the Customization command and let Emacs do the work for them." It might have been OK to say that when it was first written, but by now the manual should understand the differences, and even point them out. Especially in that section, which is about `defcustom'. The node says: "Although you can use 'defvar' or 'setq' for variables that users set, the 'defcustom' macro is designed for the job." Part of its design for that job is handling `:type', `:set' `:initialize', et.c, precisely what makes options different from ordinary variables and thus `custom-set-variables' different from `setq'.