From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: =?UTF-8?Q?Andreas_R=c3=b6hler?= Newsgroups: gmane.emacs.devel Subject: Re: Gather a list of confusions beginner tend to have Date: Tue, 15 Sep 2020 12:13:27 +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; format=flowed Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="26040"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mozilla/5.0 (X11; Linux i686; rv:68.0) Gecko/20100101 Thunderbird/68.9.0 Cc: emacs-devel@gnu.org To: Robert Pluim Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue Sep 15 12:14:08 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 1kI7yR-0006eR-N3 for ged-emacs-devel@m.gmane-mx.org; Tue, 15 Sep 2020 12:14:07 +0200 Original-Received: from localhost ([::1]:56454 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kI7yQ-0008PM-Id for ged-emacs-devel@m.gmane-mx.org; Tue, 15 Sep 2020 06:14:06 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:45514) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kI7xv-0007z3-B9 for emacs-devel@gnu.org; Tue, 15 Sep 2020 06:13:35 -0400 Original-Received: from mout.kundenserver.de ([217.72.192.74]:44209) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kI7xs-0000D3-Jk for emacs-devel@gnu.org; Tue, 15 Sep 2020 06:13:34 -0400 Original-Received: from [192.168.178.39] ([82.207.239.241]) by mrelayeu.kundenserver.de (mreue108 [212.227.15.183]) with ESMTPSA (Nemesis) id 1MUooJ-1js6dV20ED-00Qgap; Tue, 15 Sep 2020 12:13:28 +0200 In-Reply-To: Content-Language: en-US X-Provags-ID: V03:K1:k9J/fd4PGCOJQigeN/ImvgDkrZzM9JU551c10Ha1v4ZEUnqaOHb cwOgDjfIpKp0o7FsOplPYNL9evXSknPfHj0QIpp8tuwdLWnJsuJAEfI4ZUXRgvJBBC4Tdor bTjQaYAQEjAiqBHaMO/GDmbf6OPSFeoJy9d6oyxig3gT0q2cahDz5sSL1Y1fkVLiRyZkxfp EMcck4EQZY5ifqSzWr5EQ== X-UI-Out-Filterresults: notjunk:1;V03:K0:oRz1IMk7LHM=:p5FNRxGe7BTTA9w6GyL80Q xv6fuwb5+DWrCRCmFsPNacoSl8UawNWYMfWCeggk2DH0MWi7tn3KtQB/eWkRkc9QiJIubimr8 9ottKpCRIJiBsE0HAeFqJXOw07qMjDXKafsMc09rqTr+Li0YZqFuVgactZAw7jResV9hrOp0N RxgBKLyYP3pGiUPN5VUCXgd6rKFp3N8L1smUQOE8of5OQKPNZGJRsXQLuJSxi3W3nfDKhrIR5 pFKPHbAFLBRmGEKHDZIMqogZsyubRpJRB6kp/K6s/jyw0wd3FHA2Kl2mGvHCEKLmnB0UYEFU/ jfTy9cjuX0hPkP9hgjdX4gujfHlJhFqE76tdA6xGy8KsyC76cQfUxwZi+hKRceJQQTfhqpe8D R1PWByoEvUwqqUJMkYK/9hDtEg2Z7aOObO9Bz0GLDVMcb2sW8WCyJpan1Ay5CxYH7dOa7iOYD bNt065b9xnZWOB/ypGRVu0mVV0FO+8BFy136yazkZxGEtnfKsFnG/m6X85z6/SHJPR0yX5Bdk l838gimaTF8B3PEaFM7R5pWbChPyuc0A0JhSnRtFOLwffzPCxmC6hLh++O4ZHQciVz1fLQWdQ sbIBTAhYMnIssmu45WlQ1oMTvYKGUXG5lMT7E2z+Qt1NQ5VWF55RpCLSQY5gcoi8DTmuqUnUs vOZlIC5jfY8/J76wejCCxswY3k/pFcewT3Kcyuji54TFA138nxGnW2poVfrVfvYn+uTyRJGrM Io7auj7iVxkhzC2C38wJl8kUZJsdmbP3S2YgpCgZeUlC6grgwci5cNlLLEI4mB0Yx0+XfCpS Received-SPF: pass client-ip=217.72.192.74; envelope-from=andreas.roehler@online.de; helo=mout.kundenserver.de X-detected-operating-system: by eggs.gnu.org: First seen = 2020/09/15 06:13:29 X-ACL-Warn: Detected OS = Linux 2.2.x-3.x [generic] X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, NICE_REPLY_A=-0.001, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, 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:255728 Archived-At: On 15.09.20 10:21, Robert Pluim wrote: >>>>>> On Tue, 15 Sep 2020 09:11:34 +0200, Andreas Röhler said: > Andreas> On 08.09.20 19:28, Yuan Fu wrote: > > > Andreas> Hi, > > Andreas> thanks bringing up that matter. > > Andreas> When deciding to start with Emacs the faculty to extend was key. > > Andreas> A difficulty I'm still facing from time to time is the missing > Andreas> type-info in function documentation strings. Need to know the type of > Andreas> arguments and also the return-type. > > Is this something missing in Emacs, or is it that some documentation > strings donʼt tell you this? If the latter, point them out and we'll > try to fix them. > > Robert Well, it happens from time to time... Let's search for some example though: in ange-ftp.el defun ange-ftp-dired-compress-file (name) it's not told if "name" should be delivered as string are just a (quoted?) symbol. defun ange-ftp-load (file &optional noerror nomessage nosuffix) Assume the optional args must be boolean,  but not hint so far. If you grep for "&rest args", should appear some stuff where it's not told what kind of args are expected. For example in widget.el (defun define-widget (name class doc &rest args) Thanks developing Emacs, Andreas