Discussion:
Bug#998160: Stop using /usr/share/doc/debian
(too old to reply)
Joost van Baal-Ilić
2021-10-31 10:10:01 UTC
Permalink
Source: debian-faq
Version: 10.1
Severity: minor
When DDP was started, those people had big plan. But in reality, scope
has been scaled back.
Since there is no big pile of Debian document and most (Policy,
DevRef,...) now uses their own doc directory, I think it's about time
for FAQ to be in line with others.
This should help people to find this document easily since doc-base
support is scant and rarely used by newbies.
I agree.

But how about the doc-debian package? That one now installs :

/usr/share/doc/debian/bug-log-access.txt
/usr/share/doc/debian/bug-*.txt.gz
/usr/share/doc/debian/bug-reporting.txt.gz
/usr/share/doc/debian/constitution.*txt.gz
/usr/share/doc/debian/debian-manifesto.gz
/usr/share/doc/debian/mailing-lists.txt.gz
/usr/share/doc/debian/social-contract.*txt.gz
/usr/share/doc/debian/source-unpack.txt

If those documents get moved, we can get rid of /usr/share/doc/debian/ .

However, I myself am not quite sure if moving these documents is the right
thing to do. Opinions?

Bye,

Joost
Osamu Aoki
2021-11-01 10:50:01 UTC
Permalink
Hi,
Post by Joost van Baal-Ilić
Source: debian-faq
Version: 10.1
Severity: minor
When DDP was started, those people had big plan. But in reality, scope
has been scaled back.
Since there is no big pile of Debian document and most (Policy,
DevRef,...) now uses their own doc directory, I think it's about time
for FAQ to be in line with others.
This should help people to find this document easily since doc-base
support is scant and rarely used by newbies.
I agree.
/usr/share/doc/debian/bug-log-access.txt
/usr/share/doc/debian/bug-*.txt.gz
/usr/share/doc/debian/bug-reporting.txt.gz
/usr/share/doc/debian/constitution.*txt.gz
/usr/share/doc/debian/debian-manifesto.gz
/usr/share/doc/debian/mailing-lists.txt.gz
/usr/share/doc/debian/social-contract.*txt.gz
/usr/share/doc/debian/source-unpack.txt
If those documents get moved, we can get rid of /usr/share/doc/debian/ .
However, I myself am not quite sure if moving these documents is the right
thing to do. Opinions?
Good catch. True.

I think it is good idea but its worth thinking.

If we do this, we need to update debwww cron script.

Before then, we should stop using FTP servive in cron script.
Osamu
RL
2021-11-21 18:30:02 UTC
Permalink
Post by Joost van Baal-Ilić
Source: debian-faq
/usr/share/doc/debian/bug-log-access.txt
/usr/share/doc/debian/bug-*.txt.gz
/usr/share/doc/debian/bug-reporting.txt.gz
/usr/share/doc/debian/constitution.*txt.gz
/usr/share/doc/debian/debian-manifesto.gz
/usr/share/doc/debian/mailing-lists.txt.gz
/usr/share/doc/debian/social-contract.*txt.gz
/usr/share/doc/debian/source-unpack.txt
If those documents get moved, we can get rid of /usr/share/doc/debian/ .
However, I myself am not quite sure if moving these documents is the right
thing to do. Opinions?
No-one replied, so here is my opinion as a user
- packages should put their docs in /usr/share/doc/<package>
very few people will expect to look in /usr/share/doc/debian
unlesss they installed a 'debian' package
- some of those documents look old/out of date
- who is the intended user of versions of files
older than the current one? these should be on the website
or mail-archive.com only
- not sure the ones starting 'bug-' are useful - why so many and
isnt the same info in 'man bts'?
- source-unpack.txt doesnt seem to belong with the others, and
shouldnt it be merged with the man-page of dpkg-source?

Loading...