[issue35962] Slight error in words in [ 2.4.1. String and Bytes literals ]

[Nick Coghlan]

Nick Coghlan  added the comment:

I agree the current text is ambiguous given how often folks refer to the 
newline escape sequence as a "newline", but it isn't wrong - it's just talking 
about escaping literal newlines in your source code like:

>>> "This is a \
... single-line string"
'This is a single-line string'

When this paragraph is being updated, it would be good to add a cross-reference 
down to the table of escape sequences later in the section.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue35962] Slight error in words in [ 2.4.1. String and Bytes literals ]

[SilentGhost]

Change by SilentGhost :


--
nosy: +remi.lapeyre

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue35962] Slight error in words in [ 2.4.1. String and Bytes literals ]

[SilentGhost]

SilentGhost  added the comment:

I don't think that's what the sentence say at all. It says, that a backslash 
can be used to escape a newline character (not "n"). This refers only to 
triple-quoted literals and is described in the first row of the table of escape 
sequences below.

--
nosy: +SilentGhost -remi.lapeyre

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue35962] Slight error in words in [ 2.4.1. String and Bytes literals ]

[Rémi Lapeyre]

Rémi Lapeyre  added the comment:

You will find the line you want to change in 
`Doc/reference/lexical_analysis.rst`

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue35962] Slight error in words in [ 2.4.1. String and Bytes literals ]

[Rémi Lapeyre]

Rémi Lapeyre  added the comment:

Hi Magnien, if you have already used Git, everything should be familiar.

You have to clone the whole project, but the documentation leaves in the `Doc` 
folder. There is a lot of information that you can get at 
https://devguide.python.org/documenting/

If you get lost, please open the PR and tag me in the discussion, I will try 
and help you.

--
nosy: +remi.lapeyre

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue35962] Slight error in words in [ 2.4.1. String and Bytes literals ]

[Magnien Sebastien]

Magnien Sebastien  added the comment:

I'm all up for it; however I only ever worked on small solo projects. I don't 
really know where to start. Must I clone the whole python repo, or is there 
maybe a doc repo?

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue35962] Slight error in words in [ 2.4.1. String and Bytes literals ]

[Lisa Roach]

Lisa Roach  added the comment:

The updated line sounds good to me, please make a PR.

--
nosy: +lisroach

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue35962] Slight error in words in [ 2.4.1. String and Bytes literals ]

[Cheryl Sabella]

Change by Cheryl Sabella :


--
nosy: +ncoghlan
versions: +Python 3.8

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue35962] Slight error in words in [ 2.4.1. String and Bytes literals ]

[Magnien Sebastien]

New submission from Magnien Sebastien :

The documentation reads :

" The backslash (\) character is used to escape characters that otherwise have 
a special meaning, such as newline, backslash itself, or the quote character. "

However, 'n' does not "otherwise have a special meaning", nor does it represent 
a new line.

The backslash character does in fact do two different things :

1) It removes special meanings from characters that have one (\\).
2) It assigns a special meaning to normal characters (\n).

A better description would therefore be :

" The backslash (\) character is used to either escape characters that have a 
special meaning, such as backslash itself, or the quote character - or give 
special meaning to characters that do not have one, such as 'n', whose 
escapment '\n' means 'newline'. "

--
assignee: docs@python
components: Documentation
messages: 335205
nosy: Magnien Sebastien, docs@python
priority: normal
severity: normal
status: open
title: Slight error in words in [ 2.4.1. String and Bytes literals ]
type: enhancement
versions: Python 2.7, Python 3.7

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com