* Re: emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode
@ 2022-10-14 15:56 Eli Zaretskii
2022-10-14 16:17 ` Robert Pluim
0 siblings, 1 reply; 20+ messages in thread
From: Eli Zaretskii @ 2022-10-14 15:56 UTC (permalink / raw)
To: Robert Pluim; +Cc: emacs-devel
> + An alternative to using non-@acronym{ASCII} characters directly is
> +to use one of the character escape syntaxes described in
> +@pxref{General Escape Syntax,,, elisp, The Emacs Lisp Reference
> +Manual}, as they allow all Unicode codepoints to be specified using
> +only @acronym{ASCII} characters.
IMO, if we think this alternative needs to be described in the Emacs
manual, we should describe it, not cross-link to the ELisp manual.
References to ELisp are only justified when they refer to Lisp code or
details of some functions or variables, not to user commands.
^ permalink raw reply [flat|nested] 20+ messages in thread
* Re: emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode 2022-10-14 15:56 emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode Eli Zaretskii @ 2022-10-14 16:17 ` Robert Pluim 2022-10-14 17:42 ` Eli Zaretskii 0 siblings, 1 reply; 20+ messages in thread From: Robert Pluim @ 2022-10-14 16:17 UTC (permalink / raw) To: Eli Zaretskii; +Cc: emacs-devel >>>>> On Fri, 14 Oct 2022 18:56:35 +0300, Eli Zaretskii <eliz@gnu.org> said: >> + An alternative to using non-@acronym{ASCII} characters directly is >> +to use one of the character escape syntaxes described in >> +@pxref{General Escape Syntax,,, elisp, The Emacs Lisp Reference >> +Manual}, as they allow all Unicode codepoints to be specified using >> +only @acronym{ASCII} characters. Eli> IMO, if we think this alternative needs to be described in the Emacs Eli> manual, we should describe it, not cross-link to the ELisp manual. Eli> References to ELisp are only justified when they refer to Lisp code or Eli> details of some functions or variables, not to user commands. Hmm, so move or copy "General Escape Syntax" under (emacs)International somewhere, and refer to it from the "You can insert non-ASCII characters or search for them" section of that node (since thatʼs where we talk about C-x 8)? Robert -- ^ permalink raw reply [flat|nested] 20+ messages in thread
* Re: emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode 2022-10-14 16:17 ` Robert Pluim @ 2022-10-14 17:42 ` Eli Zaretskii 2022-10-18 15:05 ` Robert Pluim 0 siblings, 1 reply; 20+ messages in thread From: Eli Zaretskii @ 2022-10-14 17:42 UTC (permalink / raw) To: Robert Pluim; +Cc: emacs-devel > From: Robert Pluim <rpluim@gmail.com> > Cc: emacs-devel@gnu.org > Date: Fri, 14 Oct 2022 18:17:05 +0200 > > >>>>> On Fri, 14 Oct 2022 18:56:35 +0300, Eli Zaretskii <eliz@gnu.org> said: > > Eli> IMO, if we think this alternative needs to be described in the Emacs > Eli> manual, we should describe it, not cross-link to the ELisp manual. > Eli> References to ELisp are only justified when they refer to Lisp code or > Eli> details of some functions or variables, not to user commands. > > Hmm, so move or copy "General Escape Syntax" under > (emacs)International somewhere, and refer to it from the "You can > insert non-ASCII characters or search for them" section of that node > (since thatʼs where we talk about C-x 8)? Yes, something like that. ^ permalink raw reply [flat|nested] 20+ messages in thread
* Re: emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode 2022-10-14 17:42 ` Eli Zaretskii @ 2022-10-18 15:05 ` Robert Pluim 2022-10-18 15:18 ` Eli Zaretskii 0 siblings, 1 reply; 20+ messages in thread From: Robert Pluim @ 2022-10-18 15:05 UTC (permalink / raw) To: Eli Zaretskii; +Cc: emacs-devel >>>>> On Fri, 14 Oct 2022 20:42:39 +0300, Eli Zaretskii <eliz@gnu.org> said: >> Hmm, so move or copy "General Escape Syntax" under >> (emacs)International somewhere, and refer to it from the "You can >> insert non-ASCII characters or search for them" section of that node >> (since thatʼs where we talk about C-x 8)? Eli> Yes, something like that. Hereʼs a rough attempt: diff --git c/doc/emacs/custom.texi i/doc/emacs/custom.texi index 2bc1d3820d..817501b3f8 100644 --- c/doc/emacs/custom.texi +++ i/doc/emacs/custom.texi @@ -2794,9 +2794,8 @@ Init Non-ASCII An alternative to using non-@acronym{ASCII} characters directly is to use one of the character escape syntaxes described in -@pxref{General Escape Syntax,,, elisp, The Emacs Lisp Reference -Manual}, as they allow all Unicode codepoints to be specified using -only @acronym{ASCII} characters. +@xref{Character Escape Syntax}, as they allow all Unicode codepoints +to be specified using only @acronym{ASCII} characters. To bind non-@acronym{ASCII} keys, you must use a vector (@pxref{Init Rebinding}). The string syntax cannot be used, since the diff --git c/doc/emacs/mule.texi i/doc/emacs/mule.texi index f87c1252d3..c202c21aa4 100644 --- c/doc/emacs/mule.texi +++ i/doc/emacs/mule.texi @@ -56,7 +56,9 @@ International your keyboard can produce non-@acronym{ASCII} characters, you can select an appropriate keyboard coding system (@pxref{Terminal Coding}), and Emacs will accept those characters. Latin-1 characters can also be input by -using the @kbd{C-x 8} prefix, see @ref{Unibyte Mode}. +using the @kbd{C-x 8} prefix, see @ref{Unibyte Mode}. It is also +possible to write non-@acronym{ASCII} characters using various +pure-@acronym{ASCII} escape syntaxes, see @ref{Character Escape Syntax}. With the X Window System, your locale should be set to an appropriate value to make sure Emacs interprets keyboard input correctly; see @@ -67,6 +69,7 @@ International @menu * International Chars:: Basic concepts of multibyte characters. +* Character Escape Syntax:: Alternative ways to write characters * Language Environments:: Setting things up for the language you use. * Input Methods:: Entering text characters not on your keyboard. * Select Input Method:: Specifying your choice of input methods. @@ -240,6 +243,63 @@ International Chars decomposition: (101 770) ('e' '^') @end smallexample +@c This is (almost) verbatim from "General Escape Syntax" in the Emacs +@c Lisp Reference Manual, please keep in sync. +@node Character Escape Syntax +@section Character Escape Syntax + + Input methods provide ways to enter non-@acronym{ASCII} characters, +but sometimes it is more convenient to use an @acronym{ASCII}-only +representation, e.g. when there are several similar characters that +are hard to visually distinguish. Emacs provides several types of +escape syntax that you can use to write such characters + +@enumerate +@item +@cindex @samp{\} in character constant +@cindex backslash in character constants +@cindex unicode character escape +You can specify characters by their Unicode names, if any. +@code{?\N@{@var{NAME}@}} represents the Unicode character named +@var{NAME}. Thus, @samp{?\N@{LATIN SMALL LETTER A WITH GRAVE@}} is +equivalent to @code{?à} and denotes the Unicode character U+00E0. To +simplify entering multi-line strings, you can replace spaces in the +names by non-empty sequences of whitespace (e.g., newlines). + +@item +You can specify characters by their Unicode values. +@code{?\N@{U+@var{X}@}} represents a character with Unicode code point +@var{X}, where @var{X} is a hexadecimal number. Also, +@code{?\u@var{xxxx}} and @code{?\U@var{xxxxxxxx}} represent code +points @var{xxxx} and @var{xxxxxxxx}, respectively, where each @var{x} +is a single hexadecimal digit. For example, @code{?\N@{U+E0@}}, +@code{?\u00e0} and @code{?\U000000E0} are all equivalent to @code{?à} +and to @samp{?\N@{LATIN SMALL LETTER A WITH GRAVE@}}. The Unicode +Standard defines code points only up to @samp{U+@var{10ffff}}, so if +you specify a code point higher than that, Emacs signals an error. + +@item +You can specify characters by their hexadecimal character +codes. A hexadecimal escape sequence consists of a backslash, +@samp{x}, and the hexadecimal character code. Thus, @samp{?\x41} is +the character @kbd{A}, @samp{?\x1} is the character @kbd{C-a}, and +@code{?\xe0} is the character @kbd{à} (@kbd{a} with grave accent). +You can use any number of hex digits, so you can represent any +character code in this way. + +@item +@cindex octal character code +You can specify characters by their character code in +octal. An octal escape sequence consists of a backslash followed by +up to three octal digits; thus, @samp{?\101} for the character +@kbd{A}, @samp{?\001} for the character @kbd{C-a}, and @code{?\002} +for the character @kbd{C-b}. Only characters up to octal code 777 can +be specified this way. + +@end enumerate + + These escape sequences may also be used in strings. + @node Language Environments @section Language Environments @cindex language environments diff --git c/doc/lispref/objects.texi i/doc/lispref/objects.texi index a715b45a6c..35f413c5a5 100644 --- c/doc/lispref/objects.texi +++ i/doc/lispref/objects.texi @@ -440,6 +440,8 @@ Basic Char Syntax you should write an extra space after the character constant to separate it from the following text.) +@c This is reproduced in "Character Escape Syntax" in the Emacs +@c manual, please keep in sync. @node General Escape Syntax @subsubsection General Escape Syntax ^ permalink raw reply related [flat|nested] 20+ messages in thread
* Re: emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode 2022-10-18 15:05 ` Robert Pluim @ 2022-10-18 15:18 ` Eli Zaretskii 2022-10-18 15:58 ` Eli Zaretskii 2022-10-21 19:42 ` Richard Stallman 0 siblings, 2 replies; 20+ messages in thread From: Eli Zaretskii @ 2022-10-18 15:18 UTC (permalink / raw) To: Robert Pluim; +Cc: emacs-devel > From: Robert Pluim <rpluim@gmail.com> > Cc: emacs-devel@gnu.org > Date: Tue, 18 Oct 2022 17:05:44 +0200 > > >>>>> On Fri, 14 Oct 2022 20:42:39 +0300, Eli Zaretskii <eliz@gnu.org> said: > >> Hmm, so move or copy "General Escape Syntax" under > >> (emacs)International somewhere, and refer to it from the "You can > >> insert non-ASCII characters or search for them" section of that node > >> (since thatʼs where we talk about C-x 8)? > > Eli> Yes, something like that. > > Hereʼs a rough attempt: Thanks. One minor nit: > +representation, e.g. when there are several similar characters that ^^^^^ Either "e.g.," (with a comma) or "e.g.@:". Otherwise TeX will typeset this as an end of a sentence. ^ permalink raw reply [flat|nested] 20+ messages in thread
* Re: emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode 2022-10-18 15:18 ` Eli Zaretskii @ 2022-10-18 15:58 ` Eli Zaretskii 2022-10-18 16:06 ` Robert Pluim 2022-10-21 19:42 ` Richard Stallman 1 sibling, 1 reply; 20+ messages in thread From: Eli Zaretskii @ 2022-10-18 15:58 UTC (permalink / raw) To: rpluim; +Cc: emacs-devel > Date: Tue, 18 Oct 2022 18:18:41 +0300 > From: Eli Zaretskii <eliz@gnu.org> > Cc: emacs-devel@gnu.org > > > From: Robert Pluim <rpluim@gmail.com> > > Cc: emacs-devel@gnu.org > > Date: Tue, 18 Oct 2022 17:05:44 +0200 > > > > >>>>> On Fri, 14 Oct 2022 20:42:39 +0300, Eli Zaretskii <eliz@gnu.org> said: > > >> Hmm, so move or copy "General Escape Syntax" under > > >> (emacs)International somewhere, and refer to it from the "You can > > >> insert non-ASCII characters or search for them" section of that node > > >> (since thatʼs where we talk about C-x 8)? > > > > Eli> Yes, something like that. > > > > Hereʼs a rough attempt: > > Thanks. One minor nit: Btw, to avoid having 2 copies of the same text, we could remove it from the ELisp reference and replace it with a cross-reference to the user manual. That direction of a link is okay for user-level stuff. ^ permalink raw reply [flat|nested] 20+ messages in thread
* Re: emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode 2022-10-18 15:58 ` Eli Zaretskii @ 2022-10-18 16:06 ` Robert Pluim 0 siblings, 0 replies; 20+ messages in thread From: Robert Pluim @ 2022-10-18 16:06 UTC (permalink / raw) To: Eli Zaretskii; +Cc: emacs-devel >>>>> On Tue, 18 Oct 2022 18:58:05 +0300, Eli Zaretskii <eliz@gnu.org> said: >> Date: Tue, 18 Oct 2022 18:18:41 +0300 >> From: Eli Zaretskii <eliz@gnu.org> >> Cc: emacs-devel@gnu.org >> >> > From: Robert Pluim <rpluim@gmail.com> >> > Cc: emacs-devel@gnu.org >> > Date: Tue, 18 Oct 2022 17:05:44 +0200 >> > >> > >>>>> On Fri, 14 Oct 2022 20:42:39 +0300, Eli Zaretskii <eliz@gnu.org> said: >> > >> Hmm, so move or copy "General Escape Syntax" under >> > >> (emacs)International somewhere, and refer to it from the "You can >> > >> insert non-ASCII characters or search for them" section of that node >> > >> (since thatʼs where we talk about C-x 8)? >> > >> > Eli> Yes, something like that. >> > >> > Hereʼs a rough attempt: >> >> Thanks. One minor nit: Eli> Btw, to avoid having 2 copies of the same text, we could remove it Eli> from the ELisp reference and replace it with a cross-reference to the Eli> user manual. That direction of a link is okay for user-level stuff. Yes, that sounds like a good idea (but for tomorrow) Robert -- ^ permalink raw reply [flat|nested] 20+ messages in thread
* Re: emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode 2022-10-18 15:18 ` Eli Zaretskii 2022-10-18 15:58 ` Eli Zaretskii @ 2022-10-21 19:42 ` Richard Stallman 2022-10-22 6:19 ` Eli Zaretskii 1 sibling, 1 reply; 20+ messages in thread From: Richard Stallman @ 2022-10-21 19:42 UTC (permalink / raw) To: Eli Zaretskii; +Cc: rpluim, emacs-devel [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] We try to avoid the Latin abbreviations (such as "e.g.") that used to be customary in erudite writing. Many readers don't know them. It is better to say "such as" instead. -- Dr Richard Stallman (https://stallman.org) Chief GNUisance of the GNU Project (https://gnu.org) Founder, Free Software Foundation (https://fsf.org) Internet Hall-of-Famer (https://internethalloffame.org) ^ permalink raw reply [flat|nested] 20+ messages in thread
* Re: emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode 2022-10-21 19:42 ` Richard Stallman @ 2022-10-22 6:19 ` Eli Zaretskii 2022-10-22 7:43 ` Po Lu ` (2 more replies) 0 siblings, 3 replies; 20+ messages in thread From: Eli Zaretskii @ 2022-10-22 6:19 UTC (permalink / raw) To: rms; +Cc: rpluim, emacs-devel > From: Richard Stallman <rms@gnu.org> > Cc: rpluim@gmail.com, emacs-devel@gnu.org > Date: Fri, 21 Oct 2022 15:42:19 -0400 > > We try to avoid the Latin abbreviations (such as "e.g.") that used to > be customary in erudite writing. Many readers don't know them. > It is better to say "such as" instead. We use "such as" and "like" and "for example" and others, but we also use "e.g.". I find nothing wrong with that; technical literature out there is full of those, and people who use and develop software should be familiar with this abbreviation. (And if they aren't, there's always Wikipedia, and our Glossary also explains it.) That is part of everyone's education, if you will. I'm sorry, but I refuse to give in to such "winds of change". Where it feels natural to say "e.g.", we will not avoid saying that just because someone might need to go look it up. Of course, we shouldn't use it too much: for example, using more than one in places too close to one another should be definitely avoided. ^ permalink raw reply [flat|nested] 20+ messages in thread
* Re: emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode 2022-10-22 6:19 ` Eli Zaretskii @ 2022-10-22 7:43 ` Po Lu 2022-10-22 20:05 ` Richard Stallman 2022-10-22 17:22 ` [External] : " Drew Adams 2022-10-22 20:06 ` Richard Stallman 2 siblings, 1 reply; 20+ messages in thread From: Po Lu @ 2022-10-22 7:43 UTC (permalink / raw) To: Eli Zaretskii; +Cc: rms, rpluim, emacs-devel Eli Zaretskii <eliz@gnu.org> writes: > We use "such as" and "like" and "for example" and others, but we also > use "e.g.". I find nothing wrong with that; technical literature out > there is full of those, and people who use and develop software should > be familiar with this abbreviation. (And if they aren't, there's > always Wikipedia, and our Glossary also explains it.) That is part of > everyone's education, if you will. > > I'm sorry, but I refuse to give in to such "winds of change". Where > it feels natural to say "e.g.", we will not avoid saying that just > because someone might need to go look it up. Of course, we shouldn't > use it too much: for example, using more than one in places too close > to one another should be definitely avoided. FWIW, even living in a country where the average level of proficiency in English is very low, I find that most people are able to understand abbreviations such as "i.e." and "e.g."; they are taught in the education system and are in fact used quite often on the internet. So I don't see why using any of those abbreviations (which may as well be called colloquialisms) would be a problem. ^ permalink raw reply [flat|nested] 20+ messages in thread
* Re: emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode 2022-10-22 7:43 ` Po Lu @ 2022-10-22 20:05 ` Richard Stallman 2022-10-24 4:40 ` Christopher Dimech 0 siblings, 1 reply; 20+ messages in thread From: Richard Stallman @ 2022-10-22 20:05 UTC (permalink / raw) To: Po Lu; +Cc: eliz, rpluim, emacs-devel [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > FWIW, even living in a country where the average level of proficiency in > English is very low, I find that most people are able to understand > abbreviations such as "i.e." and "e.g."; they are taught in the > education system and are in fact used quite often on the internet. I suspect it varies from country to country. I would not know where to find the reports I got that people had trouble understanding these Latin abbreviations, since it was years ago, but I did get them. People who don't recognize "e.g." will certainly recognize "for example", so there's no harm in choosing the latter. -- Dr Richard Stallman (https://stallman.org) Chief GNUisance of the GNU Project (https://gnu.org) Founder, Free Software Foundation (https://fsf.org) Internet Hall-of-Famer (https://internethalloffame.org) ^ permalink raw reply [flat|nested] 20+ messages in thread
* Re: emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode 2022-10-22 20:05 ` Richard Stallman @ 2022-10-24 4:40 ` Christopher Dimech 2022-10-24 13:06 ` Eli Zaretskii 0 siblings, 1 reply; 20+ messages in thread From: Christopher Dimech @ 2022-10-24 4:40 UTC (permalink / raw) To: rms; +Cc: Po Lu, eliz, rpluim, emacs-devel > Sent: Sunday, October 23, 2022 at 8:05 AM > From: "Richard Stallman" <rms@gnu.org> > To: "Po Lu" <luangruo@yahoo.com> > Cc: eliz@gnu.org, rpluim@gmail.com, emacs-devel@gnu.org > Subject: Re: emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode > > [[[ To any NSA and FBI agents reading my email: please consider ]]] > [[[ whether defending the US Constitution against all enemies, ]]] > [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > > > FWIW, even living in a country where the average level of proficiency in > > English is very low, I find that most people are able to understand > > abbreviations such as "i.e." and "e.g."; they are taught in the > > education system and are in fact used quite often on the internet. > > I suspect it varies from country to country. > > I would not know where to find the reports I got that people had > trouble understanding these Latin abbreviations, since it was years > ago, but I did get them. People who don't recognize "e.g." will > certainly recognize "for example", so there's no harm in choosing the > latter. We could provide a list of abbreviations. Although I am not against the use of "for example". An alternative to "for example" which is short would be "as in". The New York Times also uses e.g. and i.e. Although the Oxford Style Manual has dropped the use a comma after e.g. and i.e. to avoid double punctuation. The Guardian, The Economist and The Times of London use eg. and ie. Thusly, their use is very common actually. ^ permalink raw reply [flat|nested] 20+ messages in thread
* Re: emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode 2022-10-24 4:40 ` Christopher Dimech @ 2022-10-24 13:06 ` Eli Zaretskii 0 siblings, 0 replies; 20+ messages in thread From: Eli Zaretskii @ 2022-10-24 13:06 UTC (permalink / raw) To: Christopher Dimech; +Cc: rms, luangruo, rpluim, emacs-devel > From: Christopher Dimech <dimech@gmx.com> > Cc: Po Lu <luangruo@yahoo.com>, eliz@gnu.org, rpluim@gmail.com, > emacs-devel@gnu.org > Date: Mon, 24 Oct 2022 06:40:35 +0200 > Sensitivity: Normal > > We could provide a list of abbreviations. We already do, see Glossary. ^ permalink raw reply [flat|nested] 20+ messages in thread
* RE: [External] : Re: emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode 2022-10-22 6:19 ` Eli Zaretskii 2022-10-22 7:43 ` Po Lu @ 2022-10-22 17:22 ` Drew Adams 2022-10-24 3:05 ` RE: [External] : " Christopher Dimech 2022-10-22 20:06 ` Richard Stallman 2 siblings, 1 reply; 20+ messages in thread From: Drew Adams @ 2022-10-22 17:22 UTC (permalink / raw) To: Eli Zaretskii, rms@gnu.org; +Cc: rpluim@gmail.com, emacs-devel@gnu.org > > From: Richard Stallman > > We try to avoid the Latin abbreviations (such as "e.g.") that used to > > be customary in erudite writing. Many readers don't know them. > > It is better to say "such as" instead. > > We use "such as" and "like" and "for example" and others, but we also > use "e.g.". I find nothing wrong with that; technical literature out > there is full of those, and people who use and develop software should > be familiar with this abbreviation. (And if they aren't, there's > always Wikipedia, and our Glossary also explains it.) That is part of > everyone's education, if you will. > > I'm sorry, but I refuse to give in to such "winds of change". Where > it feels natural to say "e.g.", we will not avoid saying that just > because someone might need to go look it up. Of course, we shouldn't > use it too much: for example, using more than one in places too close > to one another should be definitely avoided. FWIW, I agree with Eli here (and Po Lu). Pretty much everyone who understands most of the common words used in our doc understands "e.g." (and "etc."). That's not a reason to overuse such abbreviations. It's a reason not to overly avoid their use. ___ It's more important to be sure to use "such as" and "like" correctly than it is to avoid "e.g.". Unfortunately, readers won't necessarily get the difference. "such as X" includes X. "like X" doesn't necessarily include X - and X need not even be an includable value - it could be a pattern/exemplar that describes possible values. ___ On the other hand, there are plenty of people who confuse "i.e.", thinking it means the same as "e.g.". I, for one, avoid using "i.e.", in favor of "that is". ^ permalink raw reply [flat|nested] 20+ messages in thread
* Re: RE: [External] : emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode 2022-10-22 17:22 ` [External] : " Drew Adams @ 2022-10-24 3:05 ` Christopher Dimech 0 siblings, 0 replies; 20+ messages in thread From: Christopher Dimech @ 2022-10-24 3:05 UTC (permalink / raw) To: rms@gnu.org Cc: Eli Zaretskii, rpluim@gmail.com, emacs-devel@gnu.org, Drew Adams > Sent: Sunday, October 23, 2022 at 5:22 AM > From: "Drew Adams" <drew.adams@oracle.com> > To: "Eli Zaretskii" <eliz@gnu.org>, "rms@gnu.org" <rms@gnu.org> > Cc: "rpluim@gmail.com" <rpluim@gmail.com>, "emacs-devel@gnu.org" <emacs-devel@gnu.org> > Subject: RE: [External] : Re: emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode > > > > From: Richard Stallman > > > We try to avoid the Latin abbreviations (such as "e.g.") that used to > > > be customary in erudite writing. Many readers don't know them. > > > It is better to say "such as" instead. There is nothing erudite about e.g. Besides the fact that there is nothing wrong about formal text and standardisation in style. Knowing about them and what they mean is even more relevant today. Having advocated for good writing, I see nothing discrepant regarding its use. > > We use "such as" and "like" and "for example" and others, but we also > > use "e.g.". I find nothing wrong with that; technical literature out > > there is full of those, and people who use and develop software should > > be familiar with this abbreviation. (And if they aren't, there's > > always Wikipedia, and our Glossary also explains it.) That is part of > > everyone's education, if you will. > > > > I'm sorry, but I refuse to give in to such "winds of change". Where > > it feels natural to say "e.g.", we will not avoid saying that just > > because someone might need to go look it up. Of course, we shouldn't > > use it too much: for example, using more than one in places too close > > to one another should be definitely avoided. > > FWIW, I agree with Eli here (and Po Lu). > > Pretty much everyone who understands most of the > common words used in our doc understands "e.g." > (and "etc."). That's not a reason to overuse such > abbreviations. It's a reason not to overly avoid > their use. > ___ > > It's more important to be sure to use "such as" > and "like" correctly than it is to avoid "e.g.". > > Unfortunately, readers won't necessarily get the > difference. "such as X" includes X. "like X" > doesn't necessarily include X - and X need not > even be an includable value - it could be a > pattern/exemplar that describes possible values. > ___ > > On the other hand, there are plenty of people who > confuse "i.e.", thinking it means the same as > "e.g.". I, for one, avoid using "i.e.", in favor > of "that is". > > ^ permalink raw reply [flat|nested] 20+ messages in thread
* Re: emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode 2022-10-22 6:19 ` Eli Zaretskii 2022-10-22 7:43 ` Po Lu 2022-10-22 17:22 ` [External] : " Drew Adams @ 2022-10-22 20:06 ` Richard Stallman 2022-10-23 5:15 ` Eli Zaretskii 2 siblings, 1 reply; 20+ messages in thread From: Richard Stallman @ 2022-10-22 20:06 UTC (permalink / raw) To: Eli Zaretskii; +Cc: rpluim, emacs-devel [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > We use "such as" and "like" and "for example" and others, but we also > use "e.g.". I didn't ask people to go through all the existing documentation and eliminate the Latin abbreviations. -- Dr Richard Stallman (https://stallman.org) Chief GNUisance of the GNU Project (https://gnu.org) Founder, Free Software Foundation (https://fsf.org) Internet Hall-of-Famer (https://internethalloffame.org) ^ permalink raw reply [flat|nested] 20+ messages in thread
* Re: emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode 2022-10-22 20:06 ` Richard Stallman @ 2022-10-23 5:15 ` Eli Zaretskii 2022-10-24 19:31 ` Richard Stallman 0 siblings, 1 reply; 20+ messages in thread From: Eli Zaretskii @ 2022-10-23 5:15 UTC (permalink / raw) To: rms; +Cc: rpluim, emacs-devel > From: Richard Stallman <rms@gnu.org> > Cc: rpluim@gmail.com, emacs-devel@gnu.org > Date: Sat, 22 Oct 2022 16:06:47 -0400 > > > We use "such as" and "like" and "for example" and others, but we also > > use "e.g.". > > I didn't ask people to go through all the existing > documentation and eliminate the Latin abbreviations. Alas, there are people among us who'd be driven to do precisely that, having read what you wrote. ^ permalink raw reply [flat|nested] 20+ messages in thread
* Re: emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode 2022-10-23 5:15 ` Eli Zaretskii @ 2022-10-24 19:31 ` Richard Stallman 2022-10-24 19:44 ` Eli Zaretskii 2022-10-24 19:57 ` Christopher Dimech 0 siblings, 2 replies; 20+ messages in thread From: Richard Stallman @ 2022-10-24 19:31 UTC (permalink / raw) To: Eli Zaretskii; +Cc: rpluim, emacs-devel [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > > I didn't ask people to go through all the existing > > documentation and eliminate the Latin abbreviations. > Alas, there are people among us who'd be driven to do precisely that, > having read what you wrote. Replacing a Latin abbreviation is an improvement, but not an urgent or major improvement. If someone feels like replacing some from time to time, in master, I see no reason not to. -- Dr Richard Stallman (https://stallman.org) Chief GNUisance of the GNU Project (https://gnu.org) Founder, Free Software Foundation (https://fsf.org) Internet Hall-of-Famer (https://internethalloffame.org) ^ permalink raw reply [flat|nested] 20+ messages in thread
* Re: emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode 2022-10-24 19:31 ` Richard Stallman @ 2022-10-24 19:44 ` Eli Zaretskii 2022-10-24 19:57 ` Christopher Dimech 1 sibling, 0 replies; 20+ messages in thread From: Eli Zaretskii @ 2022-10-24 19:44 UTC (permalink / raw) To: rms; +Cc: rpluim, emacs-devel > From: Richard Stallman <rms@gnu.org> > Cc: rpluim@gmail.com, emacs-devel@gnu.org > Date: Mon, 24 Oct 2022 15:31:22 -0400 > > Replacing a Latin abbreviation is an improvement, but not an urgent or > major improvement. If someone feels like replacing some from time to > time, in master, I see no reason not to. I do: it's a bad use of our scarce resources. We have much more important fish to fry. ^ permalink raw reply [flat|nested] 20+ messages in thread
* Re: emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode 2022-10-24 19:31 ` Richard Stallman 2022-10-24 19:44 ` Eli Zaretskii @ 2022-10-24 19:57 ` Christopher Dimech 1 sibling, 0 replies; 20+ messages in thread From: Christopher Dimech @ 2022-10-24 19:57 UTC (permalink / raw) To: rms; +Cc: Eli Zaretskii, rpluim, emacs-devel > Sent: Tuesday, October 25, 2022 at 7:31 AM > From: "Richard Stallman" <rms@gnu.org> > To: "Eli Zaretskii" <eliz@gnu.org> > Cc: rpluim@gmail.com, emacs-devel@gnu.org > Subject: Re: emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode > > [[[ To any NSA and FBI agents reading my email: please consider ]]] > [[[ whether defending the US Constitution against all enemies, ]]] > [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > > > > I didn't ask people to go through all the existing > > > documentation and eliminate the Latin abbreviations. > > > Alas, there are people among us who'd be driven to do precisely that, > > having read what you wrote. > > Replacing a Latin abbreviation is an improvement, but not an urgent or > major improvement. If someone feels like replacing some from time to > time, in master, I see no reason not to. There could be a rule, abbreviated-format and long-format. And then it would not matter what one uses. Solves problem with everybody. ^ permalink raw reply [flat|nested] 20+ messages in thread
end of thread, other threads:[~2022-10-24 19:57 UTC | newest] Thread overview: 20+ messages (download: mbox.gz follow: Atom feed -- links below jump to the message on this page -- 2022-10-14 15:56 emacs-28 b7d7c2d9e9: Add cross-reference to alternative syntaxes for Unicode Eli Zaretskii 2022-10-14 16:17 ` Robert Pluim 2022-10-14 17:42 ` Eli Zaretskii 2022-10-18 15:05 ` Robert Pluim 2022-10-18 15:18 ` Eli Zaretskii 2022-10-18 15:58 ` Eli Zaretskii 2022-10-18 16:06 ` Robert Pluim 2022-10-21 19:42 ` Richard Stallman 2022-10-22 6:19 ` Eli Zaretskii 2022-10-22 7:43 ` Po Lu 2022-10-22 20:05 ` Richard Stallman 2022-10-24 4:40 ` Christopher Dimech 2022-10-24 13:06 ` Eli Zaretskii 2022-10-22 17:22 ` [External] : " Drew Adams 2022-10-24 3:05 ` RE: [External] : " Christopher Dimech 2022-10-22 20:06 ` Richard Stallman 2022-10-23 5:15 ` Eli Zaretskii 2022-10-24 19:31 ` Richard Stallman 2022-10-24 19:44 ` Eli Zaretskii 2022-10-24 19:57 ` Christopher Dimech
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.