From: Robert Pluim <rpluim@gmail.com>
To: "Andreas Röhler" <andreas.roehler@online.de>
Cc: emacs-devel@gnu.org
Subject: Re: Gather a list of confusions beginner tend to have
Date: Tue, 15 Sep 2020 12:34:14 +0200 [thread overview]
Message-ID: <m25z8f9vmh.fsf@gmail.com> (raw)
In-Reply-To: <b40863fb-9588-b143-1047-f22128094823@online.de> ("Andreas Röhler"'s message of "Tue, 15 Sep 2020 12:13:27 +0200")
>>>>> On Tue, 15 Sep 2020 12:13:27 +0200, Andreas Röhler <andreas.roehler@online.de> said:
>> 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
Andreas> Well, it happens from time to time... Let's search for some example 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, but not hint so far.
Hmm yes, but I think thatʼs an internal function, so not too
surprising.
Andreas> If you grep for "&rest args", should appear some stuff where it'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ʼre using, so itʼs
hard to specify in the docstring.
Robert
next prev parent reply other threads:[~2020-09-15 10:34 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
2020-09-15 10:34 ` Robert Pluim [this message]
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
List information: https://www.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=m25z8f9vmh.fsf@gmail.com \
--to=rpluim@gmail.com \
--cc=andreas.roehler@online.de \
--cc=emacs-devel@gnu.org \
/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 public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).