From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Robert Pluim Newsgroups: gmane.emacs.devel Subject: Re: Gather a list of confusions beginner tend to have Date: Tue, 15 Sep 2020 12:34:14 +0200 Message-ID: References: <6936F2AB-0968-42B5-9914-56538608A42C@gmail.com> <903b50f6-ccb9-1214-405e-dbdd30b9d0f2@online.de> 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="1776"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Andreas =?utf-8?Q?R=C3=B6hler?= Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue Sep 15 12:36:06 2020 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 1kI8Ji-0000Mu-3r for ged-emacs-devel@m.gmane-mx.org; Tue, 15 Sep 2020 12:36:06 +0200 Original-Received: from localhost ([::1]:54120 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kI8Jh-0003ml-4u for ged-emacs-devel@m.gmane-mx.org; Tue, 15 Sep 2020 06:36:05 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:50242) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kI8I0-0002MG-Aa for emacs-devel@gnu.org; Tue, 15 Sep 2020 06:34:20 -0400 Original-Received: from mail-wm1-x336.google.com ([2a00:1450:4864:20::336]:35503) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kI8Hy-00038W-Ih for emacs-devel@gnu.org; Tue, 15 Sep 2020 06:34:19 -0400 Original-Received: by mail-wm1-x336.google.com with SMTP id y15so2922463wmi.0 for ; Tue, 15 Sep 2020 03:34:18 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:references:date:in-reply-to:message-id :mime-version:content-transfer-encoding; bh=yNSt9fSf8o8gcG0k8m8fICZO9naywvJW7WMkm/hBzKE=; b=S+6eA8U1HRx0AJmXrTXaCZUydzB5hiB7tBagrGU2tWjRbpzeB/u5j9U1qYLymH7g2/ U4ZDVhiACWZujSYb1IozTZ2pgselqQ3h0Dp1Gi1GNRIMdCpYeb5v1+xWvzvBEdXlczO9 YZkl5fO59TN5kvSBS/z/j3h+UX7Ua2f7B+TVKiAS7ERqKvQOxEAn/CMBOOwwv1/iqJOI A9F+fthWnxbjNDnV0HDsP8xbTqQdGGJKYJCb9eIESnMTacwSuHuZNh2cuuSPptwvFy6k HmCsf8pw/2sFQjvktlEXgAY1HuQpAQIReaZWFlR+Xsq+arGRUxsPfDAnEG+/hiPdiPJ7 jRJQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:mime-version:content-transfer-encoding; bh=yNSt9fSf8o8gcG0k8m8fICZO9naywvJW7WMkm/hBzKE=; b=cmA8giG0vzXaxT8iMQ1t89ORlHr736V09yxeYorW54wqNKPRYZticKYFiNgqLk+aFY CBta/x/T+OjlzNQBXib+P4V0G/+vsmgCIpS+lqeegATCFAp2E4j0fxAmC3VT0M4BRGXQ 9UB/eI9d7g1aRPMz37iNWg/qVT214hdQtkk0nGb27wiRUQvdrThqMAcukxL5Mf2t4NHc Tx/pgAguLjX/KVBEjhLxQRfujjN2mRH5xR3p9Of8NP9Mq/0Ro7h6eXtj86OE+HqDk7Pe 8rVhPvEIq1KQbUQIKUen2IOFe+sphL7GJlxc84X0xu4TXc16kjL+KmzMZvtcrzEsNoUZ DA8g== X-Gm-Message-State: AOAM530MKEh8YPfmOL++wzTfOcY5lutHPucka+qiV4tyPtdjsn0IjiBO eseNNfkR/TZG+kzxjIg9lF9oJMn/q+Y1nw== X-Google-Smtp-Source: ABdhPJw6boJ2ca9TXRPIRQg/xyEhkM3lqnaxp1fuXphe+IoXHD8y99G0CzBVytvup6kMFDcdFF1u3g== X-Received: by 2002:a1c:a551:: with SMTP id o78mr4034705wme.4.1600166056410; Tue, 15 Sep 2020 03:34:16 -0700 (PDT) Original-Received: from rpluim-mac ([2a01:e34:ecfc:a860:1cb9:65e9:2391:c618]) by smtp.gmail.com with ESMTPSA id q18sm25032601wre.78.2020.09.15.03.34.15 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 15 Sep 2020 03:34:15 -0700 (PDT) In-Reply-To: ("Andreas =?utf-8?Q?R=C3=B6hler=22's?= message of "Tue, 15 Sep 2020 12:13:27 +0200") Received-SPF: pass client-ip=2a00:1450:4864:20::336; envelope-from=rpluim@gmail.com; helo=mail-wm1-x336.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham 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:255730 Archived-At: >>>>> On Tue, 15 Sep 2020 12:13:27 +0200, Andreas R=C3=B6hler said: >> Is this something missing in Emacs, or is it that some documentation >> strings don=CA=BCt tell you this? If the latter, point them out and = we'll >> try to fix them. >>=20 >> Robert Andreas> Well, it happens from time to time... Let's search for some ex= ample though: Andreas> in ange-ftp.el Andreas> defun ange-ftp-dired-compress-file (name) Andreas> it's not told if "name" should be delivered as string are just= a Andreas> (quoted?) symbol. I think emacs always uses strings when naming files. Andreas> defun ange-ftp-load (file &optional noerror nomessage nosuffix) Andreas> Assume the optional args must be boolean,=C2=A0 but not hint s= o far. Hmm yes, but I think that=CA=BCs an internal function, so not too surprising. Andreas> If you grep for "&rest args", should appear some stuff where i= t's not Andreas> told what kind of args are expected. Andreas> For example in widget.el Andreas> (defun define-widget (name class doc &rest args) Are here it depends very much on which widget you=CA=BCre using, so it=CA= =BCs hard to specify in the docstring. Robert