GNU bug report logs -
#55332
29.0.50; Greek tutorial multiline [...] mishandled
Previous Next
Reported by: "Basil L. Contovounesios" <contovob <at> tcd.ie>
Date: Mon, 9 May 2022 07:05:02 UTC
Severity: minor
Tags: patch
Found in version 29.0.50
Fixed in version 29.1
Done: "Basil L. Contovounesios" <contovob <at> tcd.ie>
Bug is archived. No further changes may be made.
To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 55332 in the body.
You can then email your comments to 55332 AT debbugs.gnu.org in the normal way.
Toggle the display of automated, internal messages from the tracker.
Report forwarded
to
info <at> protesilaos.com, bug-gnu-emacs <at> gnu.org
:
bug#55332
; Package
emacs
.
(Mon, 09 May 2022 07:05:02 GMT)
Full text and
rfc822 format available.
Acknowledgement sent
to
"Basil L. Contovounesios" <contovob <at> tcd.ie>
:
New bug report received and forwarded. Copy sent to
info <at> protesilaos.com, bug-gnu-emacs <at> gnu.org
.
(Mon, 09 May 2022 07:05:03 GMT)
Full text and
rfc822 format available.
Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):
[Message part 1 (text/plain, inline)]
Severity: minor
Tags: patch
First off, thank you very much Protesilae for the new translation of the
tutorial!
While reading it I noticed a technical discrepancy with other tutorials:
0. emacs -Q
1. C-u C-h t Greek RET
If the Emacs frame is short enough, I see:
[short.png (image/png, attachment)]
[Message part 3 (text/plain, inline)]
And if it's tall enough, I see:
[tall.png (image/png, attachment)]
[Message part 5 (text/plain, inline)]
IOW, the multiline Greek translation of:
[Middle of page left blank for didactic purposes. Text continues below]
is either half-erased in short frames, or divided by several blank lines
in tall frames.
One solution would be to limit the Greek translation to a single line as
in other translations, but why not instead teach tutorial.el to handle
multiline instances of this comment, as in the following patch?
[0001-Support-multiline-.-comments-in-Emacs-Tutorial.patch (text/x-diff, inline)]
From d0eee019a6e7b228378074295ef60bf4b6b47af9 Mon Sep 17 00:00:00 2001
From: "Basil L. Contovounesios" <contovob <at> tcd.ie>
Date: Sun, 8 May 2022 22:51:36 +0300
Subject: [PATCH] Support multiline [...] comments in Emacs Tutorial
* lisp/tutorial.el (help-with-tutorial): Don't assume [...] comment
spans a single line; instead skip it as a sexp.
---
lisp/tutorial.el | 5 +++--
1 file changed, 3 insertions(+), 2 deletions(-)
diff --git a/lisp/tutorial.el b/lisp/tutorial.el
index 0f3a1506d6..8ae370944a 100644
--- a/lisp/tutorial.el
+++ b/lisp/tutorial.el
@@ -905,13 +905,14 @@ help-with-tutorial
(progn
;; For a short gap, we don't need the [...] line,
;; so delete it.
- (delete-region (point) (progn (end-of-line) (point)))
+ (delete-region (point) (progn (forward-sexp) (point)))
(if (> n 0) (newline n)))
;; Some people get confused by the large gap.
(newline (/ n 2))
;; Skip the [...] line (don't delete it).
- (forward-line 1)
+ (forward-sexp)
+ (forward-line)
(newline (- n (/ n 2)))))
(goto-char (point-min)))
(setq buffer-undo-list nil)
--
2.35.1
[Message part 7 (text/plain, inline)]
Thanks,
--
Basil
In GNU Emacs 29.0.50 (build 1, x86_64-pc-linux-gnu, X toolkit, cairo version 1.16.0, Xaw3d scroll bars)
of 2022-05-08 built on tia
Repository revision: 21ef29d4b1ea85c4b94232f028b3aa29a4a1a81b
Repository branch: master
Windowing system distributor 'The X.Org Foundation', version 11.0.12101003
System Description: Debian GNU/Linux bookworm/sid
Configured using:
'configure CC=gcc-12 'CFLAGS=-Og -ggdb3' --config-cache --prefix
/home/blc/.local --enable-checking=structs --with-x-toolkit=lucid
--with-file-notification=yes --with-x'
Configured features:
ACL CAIRO DBUS FREETYPE GIF GLIB GMP GNUTLS GPM GSETTINGS HARFBUZZ JPEG
JSON LCMS2 LIBOTF LIBSELINUX LIBSYSTEMD LIBXML2 M17N_FLT MODULES NOTIFY
INOTIFY PDUMPER PNG RSVG SECCOMP SOUND SQLITE3 THREADS TIFF
TOOLKIT_SCROLL_BARS WEBP X11 XAW3D XDBE XIM XINPUT2 XPM LUCID ZLIB
Important settings:
value of $LANG: en_IE.UTF-8
value of $XMODIFIERS: @im=ibus
locale-coding-system: utf-8-unix
Major mode: Fundamental
Minor modes in effect:
tooltip-mode: t
global-eldoc-mode: t
show-paren-mode: t
electric-indent-mode: t
mouse-wheel-mode: t
tool-bar-mode: t
menu-bar-mode: t
file-name-shadow-mode: t
global-font-lock-mode: t
blink-cursor-mode: t
line-number-mode: t
indent-tabs-mode: t
transient-mark-mode: t
auto-composition-mode: t
auto-encryption-mode: t
auto-compression-mode: t
Load-path shadows:
None found.
Features:
(shadow sort mail-extr emacsbug message mailcap yank-media rmc puny
dired dired-loaddefs rfc822 mml mml-sec password-cache epa derived epg
rfc6068 epg-config gnus-util text-property-search time-date seq gv
subr-x byte-opt bytecomp byte-compile cconv mm-decode mm-bodies
mm-encode mail-parse rfc2231 mailabbrev gmm-utils mailheader sendmail
rfc2047 rfc2045 ietf-drums mm-util mail-prsvr mail-utils tutorial
help-mode cl-loaddefs cl-lib iso-transl tooltip eldoc paren electric
uniquify ediff-hook vc-hooks lisp-float-type elisp-mode mwheel
term/x-win x-win term/common-win x-dnd tool-bar dnd fontset image
regexp-opt fringe tabulated-list replace newcomment text-mode lisp-mode
prog-mode register page tab-bar menu-bar rfn-eshadow isearch easymenu
timer select scroll-bar mouse jit-lock font-lock syntax font-core
term/tty-colors frame minibuffer nadvice simple cl-generic cham georgian
utf-8-lang misc-lang vietnamese tibetan thai tai-viet lao korean
japanese eucjp-ms cp51932 hebrew greek romanian slovak czech european
ethiopic indian cyrillic chinese composite emoji-zwj charscript charprop
case-table epa-hook jka-cmpr-hook help abbrev obarray oclosure
cl-preloaded button loaddefs faces cus-face macroexp files window
text-properties overlay sha1 md5 base64 format env code-pages mule
custom widget keymap hashtable-print-readable backquote threads dbusbind
inotify lcms2 dynamic-setting system-font-setting font-render-setting
cairo x-toolkit xinput2 x multi-tty make-network-process emacs)
Memory information:
((conses 16 45197 8027)
(symbols 48 5860 1)
(strings 32 16891 1337)
(string-bytes 1 532340)
(vectors 16 11507)
(vector-slots 8 165888 7813)
(floats 8 23 38)
(intervals 56 383 0)
(buffers 992 12))
Information forwarded
to
bug-gnu-emacs <at> gnu.org
:
bug#55332
; Package
emacs
.
(Mon, 09 May 2022 07:46:01 GMT)
Full text and
rfc822 format available.
Message #8 received at 55332 <at> debbugs.gnu.org (full text, mbox):
[Message part 1 (text/plain, inline)]
> From: "Basil L. Contovounesios" <contovob <at> tcd.ie>
> Date: Sun, 08 May 2022 23:14:12 +0300
>
> First off, thank you very much Protesilae for the new translation of the
> tutorial!
You are welcome and thank you for giving it a try!
[ By the way, what do you think about my choice of word for "buffer"?
It is the one I had the most doubts about... ]
> [... 14 lines elided]
>
> IOW, the multiline Greek translation of:
>
> [Middle of page left blank for didactic purposes. Text continues below]
>
> is either half-erased in short frames, or divided by several blank lines
> in tall frames.
>
> One solution would be to limit the Greek translation to a single line as
> in other translations,
I shortened it to fit on a single line. See attached patch.
> but why not instead teach tutorial.el to handle multiline instances of
> this comment, as in the following patch?
Seems right. Let's wait to read from the maintainers.
--
Protesilaos Stavrou
https://protesilaos.com
[0001-Shorten-note-about-didactic-space-in-TUTORIAL.el_GR-.patch (text/x-patch, attachment)]
Information forwarded
to
bug-gnu-emacs <at> gnu.org
:
bug#55332
; Package
emacs
.
(Mon, 09 May 2022 10:10:02 GMT)
Full text and
rfc822 format available.
Message #11 received at 55332 <at> debbugs.gnu.org (full text, mbox):
Protesilaos Stavrou <info <at> protesilaos.com> writes:
>> but why not instead teach tutorial.el to handle multiline instances of
>> this comment, as in the following patch?
>
> Seems right. Let's wait to read from the maintainers.
I'm not quite sure that forward-sexp will do the correct think in all
circumstances (I'm wondering whether there are languages that would be
using parentheses inside that [...] pair). But I guess it's unlikely.
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog: http://lars.ingebrigtsen.no
Information forwarded
to
bug-gnu-emacs <at> gnu.org
:
bug#55332
; Package
emacs
.
(Mon, 09 May 2022 11:57:02 GMT)
Full text and
rfc822 format available.
Message #14 received at 55332 <at> debbugs.gnu.org (full text, mbox):
> From: Protesilaos Stavrou <info <at> protesilaos.com>
> Date: Mon, 09 May 2022 10:45:12 +0300
>
> > but why not instead teach tutorial.el to handle multiline instances of
> > this comment, as in the following patch?
>
> Seems right. Let's wait to read from the maintainers.
I don't object, but if we don't have examples of tutorials that will
use this feature, do we really need it?
Information forwarded
to
bug-gnu-emacs <at> gnu.org
:
bug#55332
; Package
emacs
.
(Mon, 09 May 2022 13:13:02 GMT)
Full text and
rfc822 format available.
Message #17 received at 55332 <at> debbugs.gnu.org (full text, mbox):
> From: Eli Zaretskii <eliz <at> gnu.org>
> Date: Mon, 09 May 2022 14:55:33 +0300
>
>> From: Protesilaos Stavrou <info <at> protesilaos.com>
>> Date: Mon, 09 May 2022 10:45:12 +0300
>>
>> > but why not instead teach tutorial.el to handle multiline instances of
>> > this comment, as in the following patch?
>>
>> Seems right. Let's wait to read from the maintainers.
>
> I don't object, but if we don't have examples of tutorials that will
> use this feature, do we really need it?
There is no pressing need for such a change. I just pushed the change
that shortens the note in TUTORIAL.el_GR to fit on a single line.
Should we pursue this further or close the bug report?
--
Protesilaos Stavrou
https://protesilaos.com
Information forwarded
to
bug-gnu-emacs <at> gnu.org
:
bug#55332
; Package
emacs
.
(Mon, 09 May 2022 13:41:01 GMT)
Full text and
rfc822 format available.
Message #20 received at 55332 <at> debbugs.gnu.org (full text, mbox):
> From: Protesilaos Stavrou <info <at> protesilaos.com>
> Cc: contovob <at> tcd.ie, 55332 <at> debbugs.gnu.org, Lars Ingebrigtsen <larsi <at> gnus.org>
> Date: Mon, 09 May 2022 16:12:42 +0300
>
> > From: Eli Zaretskii <eliz <at> gnu.org>
> > Date: Mon, 09 May 2022 14:55:33 +0300
> >
> >> From: Protesilaos Stavrou <info <at> protesilaos.com>
> >> Date: Mon, 09 May 2022 10:45:12 +0300
> >>
> >> > but why not instead teach tutorial.el to handle multiline instances of
> >> > this comment, as in the following patch?
> >>
> >> Seems right. Let's wait to read from the maintainers.
> >
> > I don't object, but if we don't have examples of tutorials that will
> > use this feature, do we really need it?
>
> There is no pressing need for such a change. I just pushed the change
> that shortens the note in TUTORIAL.el_GR to fit on a single line.
>
> Should we pursue this further or close the bug report?
I'm okay either way. Lars?
Information forwarded
to
bug-gnu-emacs <at> gnu.org
:
bug#55332
; Package
emacs
.
(Mon, 09 May 2022 13:45:02 GMT)
Full text and
rfc822 format available.
Message #23 received at 55332 <at> debbugs.gnu.org (full text, mbox):
Eli Zaretskii <eliz <at> gnu.org> writes:
>> There is no pressing need for such a change. I just pushed the change
>> that shortens the note in TUTORIAL.el_GR to fit on a single line.
>>
>> Should we pursue this further or close the bug report?
>
> I'm okay either way. Lars?
Me too.
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog: http://lars.ingebrigtsen.no
Information forwarded
to
bug-gnu-emacs <at> gnu.org
:
bug#55332
; Package
emacs
.
(Mon, 09 May 2022 13:51:01 GMT)
Full text and
rfc822 format available.
Message #26 received at 55332 <at> debbugs.gnu.org (full text, mbox):
> From: Lars Ingebrigtsen <larsi <at> gnus.org>
> Cc: Protesilaos Stavrou <info <at> protesilaos.com>, contovob <at> tcd.ie,
> 55332 <at> debbugs.gnu.org
> Date: Mon, 09 May 2022 15:43:43 +0200
>
> Eli Zaretskii <eliz <at> gnu.org> writes:
>
> >> There is no pressing need for such a change. I just pushed the change
> >> that shortens the note in TUTORIAL.el_GR to fit on a single line.
> >>
> >> Should we pursue this further or close the bug report?
> >
> > I'm okay either way. Lars?
>
> Me too.
Then I guess the easiest is to close the bug, unless Basil disagrees.
Information forwarded
to
bug-gnu-emacs <at> gnu.org
:
bug#55332
; Package
emacs
.
(Mon, 16 May 2022 12:53:02 GMT)
Full text and
rfc822 format available.
Message #29 received at 55332 <at> debbugs.gnu.org (full text, mbox):
Protesilaos Stavrou [2022-05-09 10:45 +0300] wrote:
> [ By the way, what do you think about my choice of word for "buffer"?
> It is the one I had the most doubts about... ]
Hm, I'm not a great judge of Greek translations of computing terms,
because my education has all been in English.
That said, αποσβεστήρας (damper / shock absorber) does not strike me as
the intended meaning of 'buffer' in Emacs:
buffer noun [1]
1 an apparatus designed to take the shock when an object such as a
railway carriage or a ship hits something, especially a device using
springs, on a railway carriage, etc, or a cushion of rope on a ship.
2 a person or thing which protects from harm or shock, etc, or makes
its impact less damaging or severe.
Rather, I think it should be interpreted as:
3 /computing/ a temporary storage area for data that is being
transmitted from the central processing unit to an output device such
as a printer.
Thomas Moraitis' 1990 translation of K&R's The C Programming Language,
2nd Edition refers to a buffer as ενδιάμεση αποθήκευση (intermediate
storage), whereas Wikipedia uses προσωρινή μνήμη (temporary memory) or
ενδιάμεση μνήμη (intermediate memory) [2].
Any of these would be fine with me, but they all lack the uniqueness and
self-containment of αποσβεστήρας :). In all cases we should probably
avoid στιλβωτικό (polisher/shiner) ;).
[1]: https://chambers.co.uk/search/?title=21st&query=buffer
[2]: https://el.wikipedia.org/wiki/Προσωρινή_μνήμη_(υπολογιστές)
>> IOW, the multiline Greek translation of:
>>
>> [Middle of page left blank for didactic purposes. Text continues below]
>>
>> is either half-erased in short frames, or divided by several blank lines
>> in tall frames.
>>
>> One solution would be to limit the Greek translation to a single line as
>> in other translations,
>
> I shortened it to fit on a single line. See attached patch.
Thanks,
--
Basil
Information forwarded
to
bug-gnu-emacs <at> gnu.org
:
bug#55332
; Package
emacs
.
(Mon, 16 May 2022 12:56:02 GMT)
Full text and
rfc822 format available.
Message #32 received at 55332 <at> debbugs.gnu.org (full text, mbox):
Lars Ingebrigtsen [2022-05-09 12:08 +0200] wrote:
> Protesilaos Stavrou <info <at> protesilaos.com> writes:
>
>>> but why not instead teach tutorial.el to handle multiline instances of
>>> this comment, as in the following patch?
>>
>> Seems right. Let's wait to read from the maintainers.
>
> I'm not quite sure that forward-sexp will do the correct think in all
> circumstances (I'm wondering whether there are languages that would be
> using parentheses inside that [...] pair). But I guess it's unlikely.
An alternative could be (search-forward "]") or (search-forward "]\n").
--
Basil
bug marked as fixed in version 29.1, send any further explanations to
55332 <at> debbugs.gnu.org and "Basil L. Contovounesios" <contovob <at> tcd.ie>
Request was from
"Basil L. Contovounesios" <contovob <at> tcd.ie>
to
control <at> debbugs.gnu.org
.
(Mon, 16 May 2022 12:56:02 GMT)
Full text and
rfc822 format available.
Information forwarded
to
bug-gnu-emacs <at> gnu.org
:
bug#55332
; Package
emacs
.
(Mon, 16 May 2022 12:56:03 GMT)
Full text and
rfc822 format available.
Message #37 received at 55332-done <at> debbugs.gnu.org (full text, mbox):
close 55332 29.1
quit
Eli Zaretskii [2022-05-09 09:50 -0400] wrote:
>> From: Lars Ingebrigtsen <larsi <at> gnus.org>
>> Cc: Protesilaos Stavrou <info <at> protesilaos.com>, contovob <at> tcd.ie,
>> 55332 <at> debbugs.gnu.org
>> Date: Mon, 09 May 2022 15:43:43 +0200
>>
>> Eli Zaretskii <eliz <at> gnu.org> writes:
>>
>> >> There is no pressing need for such a change. I just pushed the change
>> >> that shortens the note in TUTORIAL.el_GR to fit on a single line.
>> >>
>> >> Should we pursue this further or close the bug report?
>> >
>> > I'm okay either way. Lars?
>>
>> Me too.
>
> Then I guess the easiest is to close the bug, unless Basil disagrees.
Me three; closing.
Thanks,
--
Basil
Information forwarded
to
bug-gnu-emacs <at> gnu.org
:
bug#55332
; Package
emacs
.
(Tue, 17 May 2022 05:35:02 GMT)
Full text and
rfc822 format available.
Message #40 received at 55332 <at> debbugs.gnu.org (full text, mbox):
> From: "Basil L. Contovounesios" <contovob <at> tcd.ie>
> Date: Mon, 16 May 2022 15:52:43 +0300
>
> Protesilaos Stavrou [2022-05-09 10:45 +0300] wrote:
>
>> [ By the way, what do you think about my choice of word for "buffer"?
>> It is the one I had the most doubts about... ]
>
> Hm, I'm not a great judge of Greek translations of computing terms,
> because my education has all been in English.
>
> That said, αποσβεστήρας (damper / shock absorber) does not strike me as
> the intended meaning of 'buffer' in Emacs:
>
> buffer noun [1]
>
> 1 an apparatus designed to take the shock when an object such as a
> railway carriage or a ship hits something, especially a device using
> springs, on a railway carriage, etc, or a cushion of rope on a ship.
>
> 2 a person or thing which protects from harm or shock, etc, or makes
> its impact less damaging or severe.
>
> Rather, I think it should be interpreted as:
>
> 3 /computing/ a temporary storage area for data that is being
> transmitted from the central processing unit to an output device such
> as a printer.
>
> Thomas Moraitis' 1990 translation of K&R's The C Programming Language,
> 2nd Edition refers to a buffer as ενδιάμεση αποθήκευση (intermediate
> storage), whereas Wikipedia uses προσωρινή μνήμη (temporary memory) or
> ενδιάμεση μνήμη (intermediate memory) [2].
>
> Any of these would be fine with me, but they all lack the uniqueness and
> self-containment of αποσβεστήρας :). In all cases we should probably
> avoid στιλβωτικό (polisher/shiner) ;).
>
> [1]: https://chambers.co.uk/search/?title=21st&query=buffer
> [2]: https://el.wikipedia.org/wiki/Προσωρινή_μνήμη_(υπολογιστές)
Thanks for sharing! My choice of term was informed by what is described
(and implied) in the TUTORIAL where the "buffer" acts as a cushion: the
user's edits are not written directly to the underlying file. Though
that also counts as an intermediate object, i.e. intermediate memory...
The other consideration is stylistic. If we opt for the wording of
"intermediate memory" then we get verbose formulations for concepts like
the buffer list: "list of intermediate memories". Is "intermediate
memory" countable? Is the plural form of "memories" correct in this
context?
Remember that I do not have a background in computer science, so these
finer points are not entirely clear to me. I am happy to edit the
tutorial in the interest of correctness.
--
Protesilaos Stavrou
https://protesilaos.com
Information forwarded
to
bug-gnu-emacs <at> gnu.org
:
bug#55332
; Package
emacs
.
(Tue, 17 May 2022 09:39:01 GMT)
Full text and
rfc822 format available.
Message #43 received at 55332 <at> debbugs.gnu.org (full text, mbox):
[Message part 1 (text/plain, inline)]
Hi all,
Basil brought this thread to my attention, what about ενταμιευτής or
μικροενταμιευτής, courtesy of https://el.wiktionary.org/wiki/ενταμιευτής.
For example,
Ολοκλήρωση κειμένου στον μικροενταμιευτή.
I think this fits well both conceptually as a meaning and stylistically, it
being one word albeit a bit longer than the original buffer.
Best,
Romanos
[Message part 2 (text/html, inline)]
Information forwarded
to
bug-gnu-emacs <at> gnu.org
:
bug#55332
; Package
emacs
.
(Tue, 17 May 2022 14:45:02 GMT)
Full text and
rfc822 format available.
Message #46 received at 55332 <at> debbugs.gnu.org (full text, mbox):
> From: Romanos Skiadas <rom.skiad <at> gmail.com>
> Date: Tue, 17 May 2022 12:37:57 +0300
>
> Hi all,
Hello Romanos,
> Basil brought this thread to my attention, what about ενταμιευτής or
> μικροενταμιευτής, courtesy of https://el.wiktionary.org/wiki/ενταμιευτής.
>
> For example,
>
> Ολοκλήρωση κειμένου στον μικροενταμιευτή.
>
> I think this fits well both conceptually as a meaning and stylistically, it
> being one word albeit a bit longer than the original buffer.
I like it! My original choice of term always felt awkward.
Will prepare the update later in the evening.
Thank you!
Protesilaos (or simply "Prot")
--
Protesilaos Stavrou
https://protesilaos.com
bug archived.
Request was from
Debbugs Internal Request <help-debbugs <at> gnu.org>
to
internal_control <at> debbugs.gnu.org
.
(Wed, 15 Jun 2022 11:24:05 GMT)
Full text and
rfc822 format available.
This bug report was last modified 1 year and 313 days ago.
Previous Next
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997,2003 nCipher Corporation Ltd,
1994-97 Ian Jackson.