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 10:21:01 +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="10433"; 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 10:22:10 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 1kI6E6-0002aB-OO for ged-emacs-devel@m.gmane-mx.org; Tue, 15 Sep 2020 10:22:10 +0200 Original-Received: from localhost ([::1]:46542 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kI6E5-0000H4-Pu for ged-emacs-devel@m.gmane-mx.org; Tue, 15 Sep 2020 04:22:09 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:49730) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kI6D9-0006Wt-Cp for emacs-devel@gnu.org; Tue, 15 Sep 2020 04:21:11 -0400 Original-Received: from mail-wr1-x434.google.com ([2a00:1450:4864:20::434]:36933) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kI6D2-0002qp-Tz for emacs-devel@gnu.org; Tue, 15 Sep 2020 04:21:10 -0400 Original-Received: by mail-wr1-x434.google.com with SMTP id z4so2313643wrr.4 for ; Tue, 15 Sep 2020 01:21:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:references:gmane-reply-to-list:date:in-reply-to :message-id:mime-version:content-transfer-encoding; bh=MNJjvGQ2r/EBF8kJ+L37VAd8BMzmmP50UgLWMmgWapo=; b=MqDOXqTHljDzMgbuu/Fcc/xDc6XflNCyirCi3hDMhBqtUwFvuYcPrMFZCFtice8tBz s8y74lhZfvl203FCXOX0EN5zAEfdmT9uMPHsGG+eSJOr09AAZmqnrYEO2el5qkMDjb+o 79Wa7pkgZnX7k13sy1NLt0N5+LwX3UXEXbnUx/rN3zkEOx6inCjBQPIJ4nYGifS0DuZ/ Z7wPAP3cdAtdIIz7ATag3ambtAc3jKLzl5XWSJUi89Nv8eo6iMeeXxNcue6H6WH5yzK1 Y9MZViftfXUOiDolYWHDvquWIauNYZ6aM3pGwlSyjWssvyS+42L5ef7NQl3CG/tzCbCg eDwg== 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 :gmane-reply-to-list:date:in-reply-to:message-id:mime-version :content-transfer-encoding; bh=MNJjvGQ2r/EBF8kJ+L37VAd8BMzmmP50UgLWMmgWapo=; b=l2O01dMkYLCtgVSv8FOVt56Q7Av/CPno338JbXnGhnML3EKG32TatTdPpd1a+PN9wP NnH32BUYLxmke8vhM3hO2wVb08z7g8aVXNoeiytr9atTJYB8u+K3oLRwZGAw7RUsO4ef GH1t2IaSRrIMQdPZNYUZ/hSvq6HvQatNt5A0S760v12kOoBhgA6sHEDf8YLwJoOJg2ni nTBDC+E4fnhgh/Cnpq50cU5j7fgmcSGMZtijrJFJ8dv3ooqMuZDkM9sfdqbB6uTM2VUe ykWK2mn8ocSKIzeQGPYWPqFokZMJpJZIWv0hH8o+nSGnbzeX3xFIzfyU6lqRzJdN8kwD jG5Q== X-Gm-Message-State: AOAM531fGsZO9mt3NYtw/K1Ien0ROGGngrPaaVygeg8efzexEoZF8FMh RtKU/AHWegUq7AST5Kl7np3gSnWClS8= X-Google-Smtp-Source: ABdhPJzWX0Pj2joNi8XUfqF5RDjwEpwcyX9J/qd6HJ6l4psRDG9GrMzYTR3BM/6Y4PWCj9OYP2Wo1g== X-Received: by 2002:a5d:608a:: with SMTP id w10mr19345318wrt.48.1600158062919; Tue, 15 Sep 2020 01:21:02 -0700 (PDT) Original-Received: from rpluim-mac ([2a01:e34:ecfc:a860:1cb9:65e9:2391:c618]) by smtp.gmail.com with ESMTPSA id l17sm17408267wme.11.2020.09.15.01.21.01 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 15 Sep 2020 01:21:02 -0700 (PDT) Gmane-Reply-To-List: yes In-Reply-To: <903b50f6-ccb9-1214-405e-dbdd30b9d0f2@online.de> ("Andreas =?utf-8?Q?R=C3=B6hler=22's?= message of "Tue, 15 Sep 2020 09:11:34 +0200") Received-SPF: pass client-ip=2a00:1450:4864:20::434; envelope-from=rpluim@gmail.com; helo=mail-wr1-x434.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:255722 Archived-At: >>>>> On Tue, 15 Sep 2020 09:11:34 +0200, Andreas R=C3=B6hler 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 ke= y. 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=CA=BCt tell you this? If the latter, point them out and we'll try to fix them. Robert