From: nljlistbox2@gmail.com (N. Jackson)
To: Eli Zaretskii <eliz@gnu.org>
Cc: 22984@debbugs.gnu.org
Subject: bug#22984: 25.0.92; Typo in etc/DEBUG
Date: Fri, 11 Mar 2016 15:06:40 -0400 [thread overview]
Message-ID: <871t7g4ywv.fsf@gmail.com> (raw)
In-Reply-To: <83k2l8j1uc.fsf@gnu.org> (Eli Zaretskii's message of "Fri, 11 Mar 2016 20:39:39 +0200")
At 20:39 +0200 on Friday 2016-03-11, Eli Zaretskii wrote:
>
>> From: nljlistbox2@gmail.com (N. Jackson)
>> Cc: 22984@debbugs.gnu.org
>> Date: Fri, 11 Mar 2016 14:30:29 -0400
>>
>> This will suggest the default binary to debug; if you are going to
>> start a new Emacs process, change it as needed to point to the
>> correct binary.
>>
>> I think the full meaning of this sentence only becomes clear after one
>> reads the following sentence:
>>
>> Alternatively, if you want to attach the debugger to an already
>> running Emacs process...
>>
>> The problems with the first sentence are "you", "new", and "it". Perhaps
>> it could be made slightly clearer?
>>
>> Perhaps something along the lines of:
>>
>> This will suggest the default binary for GDB to start; if you want
>> GDB to start a different binary, change the suggestion as needed.
>> Alternatively, if you want to attach GDB to an already running Emacs
>> process...
>
> No, this is a false dichotomy. The real issue here is that, when you
> invoke GDB like that, the default binary it suggests is not emacs,
> it's something else. Try it, and you will see.
Yes, when I accepted the default, (something like `prog 3' IIRC), GDB
then complained that it didn't exist.
Anyway, if this is not what the paragraph is trying to say, then I don't
know what is intending to say, which still suggests that it could
benefit from some clarification.
In particular:
- the noun that "it" seems to stand for is the "suggestion" but that
noun never appears, so grammatically "it" must be referring to something
else -- but what?;
- the "you are going to start" seems wrong; won't it be GDB that will
start the process?;
- the "new process" in the second case suggests that there is not a new
process being started in the first (default) case.
I hope I'm not being too nitpicky (nor too obtuse) here. Just seems to
me there is a bit of opportunity here for an improvement.
Regards,
N.
next prev parent reply other threads:[~2016-03-11 19:06 UTC|newest]
Thread overview: 10+ messages / expand[flat|nested] mbox.gz Atom feed top
2016-03-11 15:18 bug#22984: 25.0.92; Typo in etc/DEBUG N. Jackson
2016-03-11 15:59 ` Eli Zaretskii
2016-03-11 18:30 ` N. Jackson
2016-03-11 18:39 ` Eli Zaretskii
2016-03-11 19:06 ` N. Jackson [this message]
2016-03-11 19:42 ` Eli Zaretskii
2016-03-11 20:12 ` N. Jackson
2016-03-11 20:27 ` Eli Zaretskii
2016-03-11 21:18 ` N. Jackson
2016-03-12 8:34 ` Eli Zaretskii
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=871t7g4ywv.fsf@gmail.com \
--to=nljlistbox2@gmail.com \
--cc=22984@debbugs.gnu.org \
--cc=eliz@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 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.