[issue37256] urllib.request.Request documentation erroneously refers to the "final two"

2019-06-12 Thread Alan De Smet


Alan De Smet  added the comment:

Oops, used to GitHub/GitLab, where Markdown is fair game. Sorry about that. :-)

--

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



[issue37256] urllib.request.Request documentation erroneously refers to the "final two"

2019-06-12 Thread Alan De Smet


New submission from Alan De Smet :

In Doc/library/urllib.request.rst, in the documentation for the class 
`Request`, it says

```
   The final two arguments are only of interest for correct handling
   of third-party HTTP cookies:
```

However, three arguments follow, not two, and the last is not necessarily 
related to third-party cookie handling.

I believe replacing "final" with "next" will correct the sentence:

```
   The next two arguments are only of interest for correct handling
   of third-party HTTP cookies:
```

Verified present in the source releases for CPython 3.5.7, 3.6.8, 3.7.3, 
3.8.0b1. It is _not_ present in 2.7.16 (as the third parameter didn't yet 
exist, so the existing phrasing is correct.)

--
assignee: docs@python
components: Documentation
messages: 345403
nosy: Alan De Smet, docs@python
priority: normal
severity: normal
status: open
title: urllib.request.Request documentation erroneously refers to the "final 
two"
type: enhancement
versions: Python 3.5, Python 3.6, Python 3.7, Python 3.8, Python 3.9

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