* bug#25195: 25.1; Index backslash for escape of left-margin paren
@ 2016-12-13 21:04 Drew Adams
2019-07-27 11:21 ` Lars Ingebrigtsen
0 siblings, 1 reply; 9+ messages in thread
From: Drew Adams @ 2016-12-13 21:04 UTC (permalink / raw)
To: 25195
The Emacs manual, node `Left Margin Convention', seems to be the only
place that the convention of a paren in column 0 is documented. The
backslash escaping is not indexed however - it should be.
It should also be documented in the Elisp manual, I think. And so
should the similar escaping of a column-zero paren or bracket in a doc
string. I could not find any mention of this. And again, doc of these
features should be indexed under backslash escaping.
In GNU Emacs 25.1.1 (x86_64-w64-mingw32)
of 2016-09-17 built on LAPHROAIG
Windowing system distributor 'Microsoft Corp.', version 6.1.7601
Configured using:
'configure --without-dbus --without-compress-install CFLAGS=-static'
^ permalink raw reply [flat|nested] 9+ messages in thread
* bug#25195: 25.1; Index backslash for escape of left-margin paren
2016-12-13 21:04 bug#25195: 25.1; Index backslash for escape of left-margin paren Drew Adams
@ 2019-07-27 11:21 ` Lars Ingebrigtsen
2019-07-27 16:13 ` Drew Adams
2019-07-27 16:36 ` Noam Postavsky
0 siblings, 2 replies; 9+ messages in thread
From: Lars Ingebrigtsen @ 2019-07-27 11:21 UTC (permalink / raw)
To: Drew Adams; +Cc: 25195
Drew Adams <drew.adams@oracle.com> writes:
> The Emacs manual, node `Left Margin Convention', seems to be the only
> place that the convention of a paren in column 0 is documented. The
> backslash escaping is not indexed however - it should be.
Hm... Well, it does say that if you have a parent in column 0, then
it's treated specially. If you have
"bla bla
\(foo bar)"
then the ( isn't in column zero, and \( => ( in this context.
So I'm not sure this is even a convention; it's just a work-around. And
what character to use in what language to get a similar effect is surely
language-dependent?
So I don't think this is something that needs expounding upon; closing.
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog: http://lars.ingebrigtsen.no
^ permalink raw reply [flat|nested] 9+ messages in thread
* bug#25195: 25.1; Index backslash for escape of left-margin paren
2019-07-27 11:21 ` Lars Ingebrigtsen
@ 2019-07-27 16:13 ` Drew Adams
2019-07-27 16:36 ` Noam Postavsky
1 sibling, 0 replies; 9+ messages in thread
From: Drew Adams @ 2019-07-27 16:13 UTC (permalink / raw)
To: Lars Ingebrigtsen; +Cc: 25195
> > The Emacs manual, node `Left Margin Convention', seems to be the only
> > place that the convention of a paren in column 0 is documented. The
> > backslash escaping is not indexed however - it should be.
>
> Hm... Well, it does say that if you have a parent in column 0, then
> it's treated specially. If you have
>
> "bla bla
> \(foo bar)"
>
> then the ( isn't in column zero, and \( => ( in this context.
>
> So I'm not sure this is even a convention; it's just a work-around.
> And what character to use in what language to get a similar effect is
> surely language-dependent?
>
> So I don't think this is something that needs expounding upon; closing.
(I should have said mode `Left Margin Paren'.
The title of the node is "Left Margin Convention".)
I don't understand what you're saying.
If you have a paren in column 0 then you need to
escape it, to make indentation, movement etc.
work well.
What's not a convention about that (see the title)?
But what difference does it make if you prefer to
see it as a workaround. Users need to know about
it, which is why we document it.
And it's why we font-lock delimiters "that ought
to be quoted". ("Ought" is a strong word, showing
that this is indeed intended as a convention.)
And it's why we have a variable to inhibit the need
for such escaping - also documented in this node.
And it's not just for a paren - same thing for other
delimiters. E.g., in Elisp a (square) bracket.
^ permalink raw reply [flat|nested] 9+ messages in thread* bug#25195: 25.1; Index backslash for escape of left-margin paren
2019-07-27 11:21 ` Lars Ingebrigtsen
2019-07-27 16:13 ` Drew Adams
@ 2019-07-27 16:36 ` Noam Postavsky
2019-07-28 9:45 ` Lars Ingebrigtsen
1 sibling, 1 reply; 9+ messages in thread
From: Noam Postavsky @ 2019-07-27 16:36 UTC (permalink / raw)
To: Lars Ingebrigtsen; +Cc: 25195
Lars Ingebrigtsen <larsi@gnus.org> writes:
> So I don't think this is something that needs expounding upon; closing.
I don't we need to "expound" on anything, the report just asks about
indexing. So with something like the diff below, if someone sees
"bla bla
\(foo bar)"
And they wonder "what's that \( thing for?", they could do i \( RET to
find the right spot in the manual.
--- i/doc/emacs/programs.texi
+++ w/doc/emacs/programs.texi
@@ -180,6 +180,7 @@ Left Margin Paren
affect the contents of the string, but will prevent that opening
delimiter from starting a defun. Here's an example:
+@cindex \( in strings
@example
(insert "Foo:
\(bar)
^ permalink raw reply [flat|nested] 9+ messages in thread
* bug#25195: 25.1; Index backslash for escape of left-margin paren
2019-07-27 16:36 ` Noam Postavsky
@ 2019-07-28 9:45 ` Lars Ingebrigtsen
2019-07-30 13:20 ` Noam Postavsky
0 siblings, 1 reply; 9+ messages in thread
From: Lars Ingebrigtsen @ 2019-07-28 9:45 UTC (permalink / raw)
To: Noam Postavsky; +Cc: 25195
Noam Postavsky <npostavs@gmail.com> writes:
> I don't we need to "expound" on anything, the report just asks about
> indexing. So with something like the diff below, if someone sees
>
> "bla bla
> \(foo bar)"
>
> And they wonder "what's that \( thing for?", they could do i \( RET to
> find the right spot in the manual.
Makes sense; please apply.
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog: http://lars.ingebrigtsen.no
^ permalink raw reply [flat|nested] 9+ messages in thread
end of thread, other threads:[~2019-07-31 12:37 UTC | newest]
Thread overview: 9+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2016-12-13 21:04 bug#25195: 25.1; Index backslash for escape of left-margin paren Drew Adams
2019-07-27 11:21 ` Lars Ingebrigtsen
2019-07-27 16:13 ` Drew Adams
2019-07-27 16:36 ` Noam Postavsky
2019-07-28 9:45 ` Lars Ingebrigtsen
2019-07-30 13:20 ` Noam Postavsky
2019-07-30 19:10 ` Drew Adams
2019-07-31 4:52 ` Glenn Morris
2019-07-31 12:37 ` Noam Postavsky
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).