From: Michael Albinus <michael.albinus@gmx.de>
To: David Kastrup <dak@gnu.org>
Cc: emacs-devel@gnu.org
Subject: Re: Uncomprehensible DOC string
Date: Fri, 09 May 2008 09:53:55 +0200 [thread overview]
Message-ID: <nqlk2joquk.fsf@alcatel-lucent.de> (raw)
In-Reply-To: <85tzh8j79e.fsf@lola.goethe.zz> (David Kastrup's message of "Fri, 09 May 2008 08:55:57 +0200")
David Kastrup <dak@gnu.org> writes:
> That addresses the last partial sentence of my report. What about the
> rest? There is no sense to leave a fragmentary explanation in the DOC
> string when you need to read up the function's behavior elsewhere,
> anyhow. The manual reference should be there to explain the _terms_
> used in the DOC string, but the DOC string should still be _complete_
> once the terms are clear.
I'll try to be a little bit more comprehensive in the doc
string. However, I don't believe that the doc string of
`start-file-process' is the place to explain what are file name
handlers at all.
Best regards, Michael.
next prev parent reply other threads:[~2008-05-09 7:53 UTC|newest]
Thread overview: 10+ messages / expand[flat|nested] mbox.gz Atom feed top
2008-05-07 11:32 Uncomprehensible DOC string David Kastrup
2008-05-09 5:20 ` Michael Albinus
2008-05-09 6:55 ` David Kastrup
2008-05-09 7:53 ` Michael Albinus [this message]
2008-05-09 8:30 ` David Kastrup
2008-05-09 9:35 ` Michael Albinus
2008-05-09 9:39 ` David Kastrup
2008-05-09 13:54 ` Michael Albinus
2008-05-09 14:21 ` David Kastrup
2008-05-09 15:30 ` Michael Albinus
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=nqlk2joquk.fsf@alcatel-lucent.de \
--to=michael.albinus@gmx.de \
--cc=dak@gnu.org \
--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).