Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]
Groups > linux.debian.bugs.dist > #914352
| From | Ian Jackson <ijackson@chiark.greenend.org.uk> |
|---|---|
| Newsgroups | linux.debian.bugs.dist, linux.debian.policy |
| Subject | Bug#906949: Clarify documentation location in a Python2-less distribution |
| Date | 2018-08-23 16:50 +0200 |
| Message-ID | <wpZ5U-5f6-11@gated-at.bofh.it> (permalink) |
| References | <wpDf3-Je-5@gated-at.bofh.it> <wpDf3-Je-5@gated-at.bofh.it> |
| Organization | linux.* mail to news gateway |
Cross-posted to 2 groups.
Stuart Prescott writes ("Bug#906949: Clarify documentation location in a Python2-less distribution"):
> b) keep using /usr/share/doc/python-foo: do we stick with
> /usr/share/doc/python-foo as a version-independent path even though no such
> package exists once the Python 2 package is gone? (I think there are
> currently no /usr/share/doc/ paths that don't match /usr/share/doc/$package)
This seems good to me. You could offer a symlink.
There are two reasons for the standardised paths in /usr/share/doc:
1. So that the user can find the right documentation.
2. So that you avoid clashes with other packagkes.
Not moving the docs about assists 1. As does providing a link
/usr/share/doc/python3-foo -> python-foo.
If there is no python[2] package then 2 is also served.
Alternatively, when dropping the python[2] package, move the docs but
leave a symlink the other way:
/usr/share/doc/python-foo -> python3-foo
Both of these mean /usr/share/doc is a bit more cluttered, but people
will be able to find the thing they are looking for, and they will
minimise the impact of the `messiness' of the transition.
What do you think of that idea ?
Ian.
Back to linux.debian.bugs.dist | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread
Bug#906949: Clarify documentation location in a Python2-less distribution Stuart Prescott <stuart@debian.org> - 2018-08-22 17:30 +0200
Bug#906949: Clarify documentation location in a Python2-less distribution Simon McVittie <smcv@debian.org> - 2018-08-22 17:50 +0200
Bug#906949: Clarify documentation location in a Python2-less distribution Ian Jackson <ijackson@chiark.greenend.org.uk> - 2018-08-23 16:50 +0200
Bug#906949: Clarify documentation location in a Python2-less distribution Simon McVittie <smcv@debian.org> - 2018-08-23 19:00 +0200
Bug#906949: Clarify documentation location in a Python2-less distribution Ian Jackson <ijackson@chiark.greenend.org.uk> - 2018-08-23 20:20 +0200
csiph-web