unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#55773: Emacs 29.0.50:: allow single-quoted chars in docstring
@ 2022-06-02 19:49 Andreas Röhler
  2022-06-02 23:25 ` Phil Sainty
  0 siblings, 1 reply; 3+ messages in thread
From: Andreas Röhler @ 2022-06-02 19:49 UTC (permalink / raw)
  To: 55773

[-- Attachment #1: Type: text/plain, Size: 233 bytes --]

Need to display single-quoted chars in docstring dealing with Python code


result = some_function_that_takes_arguments(
     'a', 'b', 'c',
     'd', 'e', 'f'
)

Example shown in

https://peps.python.org/pep-0008/#indentation

[-- Attachment #2: Type: text/html, Size: 639 bytes --]

^ permalink raw reply	[flat|nested] 3+ messages in thread

* bug#55773: Emacs 29.0.50:: allow single-quoted chars in docstring
  2022-06-02 19:49 bug#55773: Emacs 29.0.50:: allow single-quoted chars in docstring Andreas Röhler
@ 2022-06-02 23:25 ` Phil Sainty
  2022-06-03  4:00   ` Lars Ingebrigtsen
  0 siblings, 1 reply; 3+ messages in thread
From: Phil Sainty @ 2022-06-02 23:25 UTC (permalink / raw)
  To: Andreas Röhler; +Cc: 55773

On 2022-06-03 07:49, Andreas Röhler wrote:
> Need to display single-quoted chars in docstring

Nowadays you need to escape literal apostrophes in docstrings
like this:

result = some_function_that_takes_arguments(
     \\='a\\=', \\='b\\=', \\='c\\=',
     \\='d\\=', \\='e\\=', \\='f\\='
)

Setting `text-quoting-style' to grave will prevent you from getting
bitten by automated curly-quote substitutions in help buffers (but
of course won't help you to remember to escape things when writing
docstrings).

See also: (info "(elisp)Text Quoting Style")







^ permalink raw reply	[flat|nested] 3+ messages in thread

* bug#55773: Emacs 29.0.50:: allow single-quoted chars in docstring
  2022-06-02 23:25 ` Phil Sainty
@ 2022-06-03  4:00   ` Lars Ingebrigtsen
  0 siblings, 0 replies; 3+ messages in thread
From: Lars Ingebrigtsen @ 2022-06-03  4:00 UTC (permalink / raw)
  To: Phil Sainty; +Cc: 55773, Andreas Röhler

Phil Sainty <psainty@orcon.net.nz> writes:

> See also: (info "(elisp)Text Quoting Style")

So this works as designed, and is what the byte compilation warning says
("use \="), so I'm closing this bug report.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no





^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2022-06-03  4:00 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-06-02 19:49 bug#55773: Emacs 29.0.50:: allow single-quoted chars in docstring Andreas Röhler
2022-06-02 23:25 ` Phil Sainty
2022-06-03  4:00   ` Lars Ingebrigtsen

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).