From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lennart Borgman Newsgroups: gmane.emacs.bugs Subject: bug#4869: 23.1.50; weak documentation of prefer-coding-system Date: Fri, 6 Nov 2009 03:50:03 +0100 Message-ID: References: <87y6mmc79m.fsf@kzsu.stanford.edu> <87r5sce70b.fsf@mail.jurta.org> Reply-To: Lennart Borgman , 4869@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1257476856 18097 80.91.229.12 (6 Nov 2009 03:07:36 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 6 Nov 2009 03:07:36 +0000 (UTC) Cc: Joseph Brenner To: Juri Linkov , 4869@emacsbugs.donarmstrong.com Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Nov 06 04:07:29 2009 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1N6FAe-00056l-Ra for geb-bug-gnu-emacs@m.gmane.org; Fri, 06 Nov 2009 04:07:29 +0100 Original-Received: from localhost ([127.0.0.1]:33401 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1N6FAe-0005rl-Bp for geb-bug-gnu-emacs@m.gmane.org; Thu, 05 Nov 2009 22:07:28 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1N6FAa-0005rV-Uv for bug-gnu-emacs@gnu.org; Thu, 05 Nov 2009 22:07:24 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1N6FAW-0005qV-8C for bug-gnu-emacs@gnu.org; Thu, 05 Nov 2009 22:07:24 -0500 Original-Received: from [199.232.76.173] (port=33983 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1N6FAW-0005qQ-01 for bug-gnu-emacs@gnu.org; Thu, 05 Nov 2009 22:07:20 -0500 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:53503) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1N6FAV-0000Fl-DJ for bug-gnu-emacs@gnu.org; Thu, 05 Nov 2009 22:07:19 -0500 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id nA637Gll021583; Thu, 5 Nov 2009 19:07:17 -0800 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.14.3/8.14.3/Submit) id nA6306mP020121; Thu, 5 Nov 2009 19:00:06 -0800 Resent-Date: Thu, 5 Nov 2009 19:00:06 -0800 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: Lennart Borgman Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs 2Resent-Date: Fri, 06 Nov 2009 03:00:06 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: followup 4869 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by 4869-submit@emacsbugs.donarmstrong.com id=B4869.125747583019189 (code B ref 4869); Fri, 06 Nov 2009 03:00:06 +0000 Original-Received: (at 4869) by emacsbugs.donarmstrong.com; 6 Nov 2009 02:50:30 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-Received: from mail-yx0-f190.google.com (mail-yx0-f190.google.com [209.85.210.190]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id nA62oSuh019184 for <4869@emacsbugs.donarmstrong.com>; Thu, 5 Nov 2009 18:50:29 -0800 Original-Received: by yxe28 with SMTP id 28so596695yxe.19 for <4869@emacsbugs.donarmstrong.com>; Thu, 05 Nov 2009 18:50:23 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:received:in-reply-to:references :from:date:message-id:subject:to:cc:content-type :content-transfer-encoding; bh=cYLTTyL3rEZmohapvCK2FzTDiY8LJ6HQGpVvvkhZNBY=; b=dADsuE/USqLnEOHfnlozVRltSv2rmB3hvBJB0TRrvNczLa181jcetW533XS1jAhths +dltDCfEktgbSuBK8PzD9riCe+WquFkqNxrlrdWmyNx+74DUR4ANAHP5IOvLo0GHsas7 Ty3QiprkahXnby98sMZ7dts7ZqeTdj2q9nrb4= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type:content-transfer-encoding; b=r5o27JUndvXb8kKyAQ3UrkfJgJvWM6JjucOO4scYyDZP9oP8S+j2IHtTJ3vMyugk7u zYOCnHA7WvBbLbBPUoSGUOG7FTCo0Q/QPHmvQRehKcCmUDwhqByXf/bjXEMnWuM7Y7qp YhpWo7/GtsXnGAdWHOehplZGNCmSyWijgJmyA= Original-Received: by 10.101.28.1 with SMTP id f1mr1049128anj.126.1257475823095; Thu, 05 Nov 2009 18:50:23 -0800 (PST) In-Reply-To: <87r5sce70b.fsf@mail.jurta.org> X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) Resent-Date: Thu, 05 Nov 2009 22:07:24 -0500 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:32441 Archived-At: On Fri, Nov 6, 2009 at 2:47 AM, Juri Linkov wrote: >> The function prefer-coding-system does not explain if the CODING-SYSTEM >> argument must be a symbol or a string (or either). >> >> Without seeing a code example, a user might try using a quoted string: >> >> =C2=A0 =C2=A0(prefer-coding-system "utf-8") >> >> In which case, the error message is very confusing (this makes it sound >> as though utf-8 is not supported): >> >> =C2=A0 =C2=A0error: Invalid coding system `utf-8' >> >> At a minimum, the documentation should be made more explicit, and I >> would strongly suggest adding a code example: >> >> =C2=A0 =C2=A0(prefer-coding-system 'utf-8) > > Why not allow both? =C2=A0Some MULE functions allow a symbol and a string= . Because it is at least a rudimentary type check? ;-)