Re: Bug#943666: python3: Update Python Policy for removal of the Python 2 stack
Le mer. 6 nov. 2019 à 23:49, Matthias Klose a écrit : > > On 06.11.19 22:04, Nicholas D Steeves wrote: > > Brian May writes: > >> Or maybe even expand as two bullet points: > >> > >> - Do not remove python-foo-doc. > >> - Do not rename it to python3-foo-doc. > >> > >> I think this makes it very explicit what was intended. > > > > please could one of you open an issue with a patch to track the change? As we were discussing about sentences in https://wiki.debian.org/Python/2Removal, I only modified the page according to Brian's last proposal. -- Stéphane
Re: Bug#943666: python3: Update Python Policy for removal of the Python 2 stack
On 06.11.19 22:04, Nicholas D Steeves wrote: Brian May writes: Stéphane Blondon writes: Perhaps there is a doubt how to read it? - do not (remove python-foo-doc or rename it to python3-foo-doc) - (do not remove python-foo-doc) or (rename it to python3-foo-doc) Would it be better if we remove the indentation and use this sentence(?): if documentation is in python-foo-doc, do not move it Myself, I read it as the first option. I would personally use: - Do not remove python-foo-doc and do not rename it to python3-foo-doc. Or maybe even expand as two bullet points: - Do not remove python-foo-doc. - Do not rename it to python3-foo-doc. I think this makes it very explicit what was intended. +1. I also read it as (do (not (remove python-foo-doc) or (not (rename to python3-foo-doc. In natural language that "or" should be a "nor", but breaking it into two negated bullet points may be clearer to those whose first language doesn't possess a negative list operator. please could one of you open an issue with a patch to track the change? Thanks, Matthias
Re: Bug#943666: python3: Update Python Policy for removal of the Python 2 stack
Brian May writes: > Stéphane Blondon writes: > >> Perhaps there is a doubt how to read it? >> - do not (remove python-foo-doc or rename it to python3-foo-doc) >> - (do not remove python-foo-doc) or (rename it to python3-foo-doc) >> >> Would it be better if we remove the indentation and use this sentence(?): >> if documentation is in python-foo-doc, do not move it > > Myself, I read it as the first option. > > I would personally use: > > - Do not remove python-foo-doc and do not rename it to python3-foo-doc. > > Or maybe even expand as two bullet points: > > - Do not remove python-foo-doc. > - Do not rename it to python3-foo-doc. > > I think this makes it very explicit what was intended. +1. I also read it as (do (not (remove python-foo-doc) or (not (rename to python3-foo-doc. In natural language that "or" should be a "nor", but breaking it into two negated bullet points may be clearer to those whose first language doesn't possess a negative list operator. Cheers, Nicholas signature.asc Description: PGP signature
Re: Bug#943666: python3: Update Python Policy for removal of the Python 2 stack
Stéphane Blondon writes: > Perhaps there is a doubt how to read it? > - do not (remove python-foo-doc or rename it to python3-foo-doc) > - (do not remove python-foo-doc) or (rename it to python3-foo-doc) > > Would it be better if we remove the indentation and use this sentence(?): > if documentation is in python-foo-doc, do not move it Myself, I read it as the first option. I would personally use: - Do not remove python-foo-doc and do not rename it to python3-foo-doc. Or maybe even expand as two bullet points: - Do not remove python-foo-doc. - Do not rename it to python3-foo-doc. I think this makes it very explicit what was intended. -- Brian May
Re: Bug#943666: python3: Update Python Policy for removal of the Python 2 stack
On 03/11/2019 15:16, Matthias Klose wrote: > On 03.11.19 15:09, Neil Williams wrote: >> * do not remove python-foo-doc or rename it to python3-foo-doc > > yes, but this tells you not to rename it to python3-foo-doc. Perhaps there is a doubt how to read it? - do not (remove python-foo-doc or rename it to python3-foo-doc) - (do not remove python-foo-doc) or (rename it to python3-foo-doc) Would it be better if we remove the indentation and use this sentence(?): if documentation is in python-foo-doc, do not move it Stéphane signature.asc Description: OpenPGP digital signature
Re: Bug#943666: python3: Update Python Policy for removal of the Python 2 stack
On 03.11.19 15:09, Neil Williams wrote: On Sun, 3 Nov 2019 15:00:17 +0100 Matthias Klose wrote: [discussing this outside the bug report on the ML] On 03.11.19 14:39, Neil Williams wrote: Actually, that's a good catch. I was mixing up the defaults package with the general advice on python3 migration to not remove python-foo-doc just to rename it to python3-foo-doc. where did you read that? IMO we don't want to rename the -doc packages. https://wiki.debian.org/Python/2Removal Check list * if documentation was in python-foo - move it to python3-foo or python-foo-doc * if it was automatically placed there by dh_installdocs, it will automatically move to python-foo-doc: you don't need to do anything, unless you had links to it that need un-breaking * do not remove python-foo-doc or rename it to python3-foo-doc yes, but this tells you not to rename it to python3-foo-doc.
Re: Bug#943666: python3: Update Python Policy for removal of the Python 2 stack
On Sun, 3 Nov 2019 15:00:17 +0100 Matthias Klose wrote: > [discussing this outside the bug report on the ML] > > On 03.11.19 14:39, Neil Williams wrote: > > Actually, that's a good catch. I was mixing up the defaults package > > with the general advice on python3 migration to not remove > > python-foo-doc just to rename it to python3-foo-doc. > > where did you read that? IMO we don't want to rename the -doc > packages. https://wiki.debian.org/Python/2Removal Check list * if documentation was in python-foo - move it to python3-foo or python-foo-doc * if it was automatically placed there by dh_installdocs, it will automatically move to python-foo-doc: you don't need to do anything, unless you had links to it that need un-breaking * do not remove python-foo-doc or rename it to python3-foo-doc > > > Removing the defaults package python-doc seems right to me. I've > > updated that paragraph. -- Neil Williams = http://www.linux.codehelp.co.uk/ pgpofohEowY0B.pgp Description: OpenPGP digital signature
Re: Bug#943666: python3: Update Python Policy for removal of the Python 2 stack
[discussing this outside the bug report on the ML] On 03.11.19 14:39, Neil Williams wrote: Actually, that's a good catch. I was mixing up the defaults package with the general advice on python3 migration to not remove python-foo-doc just to rename it to python3-foo-doc. where did you read that? IMO we don't want to rename the -doc packages. Removing the defaults package python-doc seems right to me. I've updated that paragraph.
Bug#943666: python3: Update Python Policy for removal of the Python 2 stack
Package: python3 Version: 3.7.5-1 Severity: normal As discussed on IRC and alongside the post to debian-devel-announce, please review and include this amendment to the Debian Python Policy to cover the removal of the Python 2 stack as outlined at https://wiki.debian.org/Python/2Removal https://salsa.debian.org/codehelp/python3-defaults/commit/9b1dabbdc7105486e8a2132a100066e4c225a874 Thanks.