From: Sebastian Urban <mrsebastianurban@gmail.com>
To: Lars Ingebrigtsen <larsi@gnus.org>
Cc: 35885@debbugs.gnu.org
Subject: bug#35885: 25.2; Few mistakes in Emacs Manual (+ proposals)
Date: Sun, 16 Aug 2020 15:00:17 +0200 [thread overview]
Message-ID: <9d2594a9-8632-eb3b-18aa-359584c96753@gmail.com> (raw)
In-Reply-To: <87d03qx2mm.fsf@gnus.org>
>> -Similarly, @kbd{C-x 8 ]}, @kbd{C-x 8 @{} (...)
>> +Similarly, @w{@kbd{C-x 8 ]}}, @kbd{C-x 8 @{} (...)
>
> Looking at the thread I don't think this @kbd -> @w{@kbd thing was
> discussed? What does that fix?
As I wrote in original message describing these changes: "1st change
@w - in PDF this key is split on two pages, which looks bad." The @w
prevents line breaking. Or open Emacs 26.3 PDF manual on page 38
(bottom right) - 39 (top left), and see for yourself.
I just wanted to prevent this, so that shortcut is in one place.
I also just built PDF:
- with TEXI files from emacs-27 branch,
- with texinfo.tex: 2020-06-25.17,
- without my changes,
and "C-x 8 ]" is still split.
>> -accent and apostrophe @kbd{`like this'}, it is converted (...)
>> [...]
>> +accent and apostrophe @verb{|`like this'|}, it is converted (...)
>
> Neither can I see a discussion of the @kbd -> @verb{| change.
Again, as I wrote:
2nd change:
- changed @kbd to @verb, because @kbd surrounds text with pair of
curved quotes in plain text - result it ‘``like this''’, @verb
doesn't do it;
Unfortunately (for me), in HTML, @kbd prints text in "italics", while
@verb doesn't.
So, in case of @verb, the choice is:
- stay with @kbd, and ignore extra quotes in plaintext, which are ok
for shortcuts, but with text surrounded with ``...'' they look
unnecessary and confusing,
- pick @verb for ``...'' as an exception, but without "italics" in
HTML.
Although, there is other example later (in TEXT.TEXI), where @verb
would do a nice job in plaintext. As I described it:
Optionally, I would also suggest replacing @kbd for ` ' `` '' with
@verb for the same reason as stated above, i.e. instead of ` in
plain text, with @kbd we're getting ‘`’, which looks quite
interesting in e.g. "Quotation Marks" section: "(...) it optionally
converts ‘`’ to ‘, ‘'’ to ’, ‘``’ to “, and ‘''’ to ”."
S. U.
next prev parent reply other threads:[~2020-08-16 13:00 UTC|newest]
Thread overview: 48+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-05-24 15:59 bug#35885: 25.2; Few mistakes in Emacs Manual (+ proposals) Sebastian Urban
2019-06-02 22:50 ` Sebastian Urban
2019-06-03 16:36 ` Eli Zaretskii
2019-06-04 10:48 ` Sebastian Urban
2019-06-04 15:12 ` Eli Zaretskii
2019-06-05 10:40 ` Sebastian Urban
2019-06-05 16:52 ` Eli Zaretskii
2019-06-06 9:49 ` Sebastian Urban
2019-06-06 21:19 ` Sebastian Urban
2019-06-09 8:31 ` Eli Zaretskii
2019-06-09 8:22 ` Eli Zaretskii
2019-06-10 10:30 ` Sebastian Urban
2019-06-10 17:01 ` Eli Zaretskii
2019-06-11 10:32 ` Sebastian Urban
2019-06-11 16:59 ` Eli Zaretskii
2019-06-12 8:44 ` Sebastian Urban
2019-06-12 13:25 ` Drew Adams
2019-06-03 16:32 ` Eli Zaretskii
2020-05-10 20:02 ` Sebastian Urban
2020-08-13 9:11 ` Sebastian Urban
2020-08-13 13:20 ` Eli Zaretskii
2020-08-13 14:06 ` Sebastian Urban
2020-08-13 14:16 ` Eli Zaretskii
2020-08-14 0:01 ` Sebastian Urban
2020-08-15 13:18 ` Lars Ingebrigtsen
2020-08-15 13:34 ` Eli Zaretskii
2020-08-15 13:52 ` Lars Ingebrigtsen
2020-08-15 14:11 ` Sebastian Urban
2020-08-16 11:16 ` Lars Ingebrigtsen
2020-08-16 13:00 ` Sebastian Urban [this message]
2020-08-18 14:54 ` Lars Ingebrigtsen
2020-08-18 15:07 ` Eli Zaretskii
2020-08-19 10:15 ` Lars Ingebrigtsen
2020-08-19 8:44 ` Sebastian Urban
2020-08-19 10:19 ` Lars Ingebrigtsen
2020-08-19 12:14 ` Sebastian Urban
2020-08-20 12:44 ` Lars Ingebrigtsen
2020-08-20 13:35 ` Eli Zaretskii
2020-08-20 18:24 ` Sebastian Urban
2020-08-22 7:20 ` Eli Zaretskii
2020-08-22 10:19 ` Sebastian Urban
2020-10-19 18:52 ` Sebastian Urban
2021-05-12 14:47 ` Lars Ingebrigtsen
2021-05-13 11:48 ` Sebastian Urban
2021-05-16 13:30 ` Lars Ingebrigtsen
2021-05-18 9:17 ` Sebastian Urban
2021-05-18 13:15 ` bug#42199: " Lars Ingebrigtsen
[not found] <<cf31e2b2-3ad4-57f0-8847-e5f01ff35fc8@gmail.com>
[not found] ` <<f2fff09b-fc97-795b-dc3b-4175c48234db@gmail.com>
[not found] ` <<83k1e2tym6.fsf@gnu.org>
[not found] ` <<e083f8bd-8c77-3558-c373-a8d9d9ef6079@gmail.com>
[not found] ` <<835zpltme6.fsf@gnu.org>
[not found] ` <<d1695e2e-7f87-7493-fbd9-97cd6347d837@gmail.com>
[not found] ` <<83muiwrn2u.fsf@gnu.org>
[not found] ` <<1583c6b3-2421-794d-8c8b-86287ef3fd5a@gmail.com>
[not found] ` <<83tvczb236.fsf@gnu.org>
[not found] ` <<616312d4-0faf-0382-3f21-5b66327d8d8b@gmail.com>
[not found] ` <<83tvcx9xyl.fsf@gnu.org>
2019-06-10 17:44 ` Drew Adams
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=9d2594a9-8632-eb3b-18aa-359584c96753@gmail.com \
--to=mrsebastianurban@gmail.com \
--cc=35885@debbugs.gnu.org \
--cc=larsi@gnus.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).