From: "Andreas Röhler" <andreas.roehler@online.de>
To: Robert Pluim <rpluim@gmail.com>
Cc: emacs-devel@gnu.org
Subject: Re: Gather a list of confusions beginner tend to have
Date: Tue, 15 Sep 2020 12:13:27 +0200 [thread overview]
Message-ID: <b40863fb-9588-b143-1047-f22128094823@online.de> (raw)
In-Reply-To: <m2ft7ja1si.fsf@gmail.com>
On 15.09.20 10:21, Robert Pluim wrote:
>>>>>> On Tue, 15 Sep 2020 09:11:34 +0200, Andreas Röhler <andreas.roehler@online.de> 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
next prev parent reply other threads:[~2020-09-15 10:13 UTC|newest]
Thread overview: 51+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-09-08 17:28 Gather a list of confusions beginner tend to have Yuan Fu
2020-09-10 11:51 ` Jean Louis
2020-09-10 12:51 ` tomas
2020-09-15 7:11 ` Andreas Röhler
2020-09-15 8:21 ` Robert Pluim
2020-09-15 10:13 ` Andreas Röhler [this message]
2020-09-15 10:34 ` Robert Pluim
2020-09-15 11:22 ` Göktuğ Kayaalp
-- strict thread matches above, loose matches on Subject: below --
2020-09-08 18:48 Göktuğ Kayaalp
2020-09-08 19:30 ` Yuan Fu
2020-09-08 21:30 ` Praharsh Suryadevara
2020-09-09 3:51 ` Richard Stallman
2020-09-09 14:18 ` Eli Zaretskii
2020-09-09 14:24 ` Göktuğ Kayaalp
2020-09-09 15:07 ` Stefan Kangas
2020-09-09 16:09 ` Göktuğ Kayaalp
2020-09-09 16:23 ` Praharsh Suryadevara
2020-09-09 16:06 ` Praharsh Suryadevara
2020-09-11 4:13 ` Richard Stallman
2020-09-11 4:13 ` Richard Stallman
2020-09-11 4:41 ` Praharsh Suryadevara
2020-09-09 7:57 ` tomas
2020-09-10 2:40 ` Richard Stallman
2020-09-10 3:32 ` Eli Zaretskii
2020-09-10 8:29 ` tomas
2020-09-10 9:08 ` Gregory Heytings via Emacs development discussions.
2020-09-10 9:34 ` Eli Zaretskii
2020-09-10 10:08 ` tomas
2020-09-10 9:30 ` Eli Zaretskii
2020-09-10 10:11 ` tomas
2020-09-11 4:18 ` Richard Stallman
2020-09-11 7:06 ` Eli Zaretskii
2020-09-11 13:47 ` Stefan Monnier
2020-09-12 3:22 ` Richard Stallman
2020-09-12 3:46 ` Emanuel Berg via Emacs development discussions.
2020-09-10 8:28 ` tomas
2020-09-09 14:01 ` Eli Zaretskii
2020-09-10 23:20 ` Yuan Fu
2020-09-11 6:45 ` Eli Zaretskii
2020-09-11 8:51 ` Dmitry Gutov
2020-09-11 8:59 ` Emanuel Berg via Emacs development discussions.
2020-09-11 13:52 ` Yuan Fu
2020-09-11 14:01 ` Eli Zaretskii
2020-09-11 14:27 ` Stefan Monnier
2020-09-09 2:01 ` Nick Savage
2020-09-09 14:48 ` Göktuğ Kayaalp
2020-09-10 2:36 ` Richard Stallman
2020-09-10 10:07 ` Göktuğ Kayaalp
2020-09-10 17:28 ` Drew Adams
2020-09-10 21:17 ` Göktuğ Kayaalp
2020-09-08 20:10 Göktuğ Kayaalp
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=b40863fb-9588-b143-1047-f22128094823@online.de \
--to=andreas.roehler@online.de \
--cc=emacs-devel@gnu.org \
--cc=rpluim@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.