Package: asciidoc Version: 8.6.4-1 Severity: normal Usertag: duplicate-docs
While playing around with the tool hardlink, I noticed that python-fuse contains the quite some files twice under /usr/share/doc/asciidoc/: [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/up.png to /usr/share/doc/asciidoc/examples/website/images/icons/up.png (-1.29 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/faq.txt to /usr/share/doc/asciidoc/examples/website/faq.txt (-36.54 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/tip.png to /usr/share/doc/asciidoc/examples/website/images/icons/tip.png (-2.65 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/callouts/2.png to /usr/share/doc/asciidoc/examples/website/images/icons/callouts/2.png (-353 bytes) [DryRun] Linking /usr/share/doc/asciidoc/doc/a2x.1.txt to /usr/share/doc/asciidoc/examples/website/a2x.1.txt (-8.67 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/asciidoc.txt to /usr/share/doc/asciidoc/examples/website/userguide.txt (-202.10 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/asciimathml.txt to /usr/share/doc/asciidoc/examples/website/asciimathml.txt (-2.33 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/testasciidoc.txt to /usr/share/doc/asciidoc/examples/website/testasciidoc.txt (-7.94 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/home.png to /usr/share/doc/asciidoc/examples/website/images/icons/home.png (-1.31 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/callouts/7.png to /usr/share/doc/asciidoc/examples/website/images/icons/callouts/7.png (-344 bytes) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/README to /usr/share/doc/asciidoc/examples/website/images/icons/README (-226 bytes) [DryRun] Linking /usr/share/doc/asciidoc/doc/customers.csv to /usr/share/doc/asciidoc/examples/website/customers.csv (-837 bytes) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/callouts/15.png to /usr/share/doc/asciidoc/examples/website/images/icons/callouts/15.png (-640 bytes) [DryRun] Linking /usr/share/doc/asciidoc/doc/latex-backend.txt to /usr/share/doc/asciidoc/examples/website/latex-backend.txt (-11.48 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/callouts/11.png to /usr/share/doc/asciidoc/examples/website/images/icons/callouts/11.png (-565 bytes) [DryRun] Linking /usr/share/doc/asciidoc/doc/asciidoc.1.txt to /usr/share/doc/asciidoc/examples/website/manpage.txt (-4.98 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/note.png to /usr/share/doc/asciidoc/examples/website/images/icons/note.png (-2.44 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/important.png to /usr/share/doc/asciidoc/examples/website/images/icons/important.png (-2.91 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/callouts/1.png to /usr/share/doc/asciidoc/examples/website/images/icons/callouts/1.png (-329 bytes) [DryRun] Linking /usr/share/doc/asciidoc/doc/slidy.txt to /usr/share/doc/asciidoc/examples/website/slidy.txt (-4.04 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/asciidocapi.txt to /usr/share/doc/asciidoc/examples/website/asciidocapi.txt (-6.34 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/callouts/10.png to /usr/share/doc/asciidoc/examples/website/images/icons/callouts/10.png (-361 bytes) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/highlighter.png to /usr/share/doc/asciidoc/examples/website/images/highlighter.png (-125.14 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/latex-bugs.txt to /usr/share/doc/asciidoc/examples/website/latex-bugs.txt (-4.16 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/callouts/8.png to /usr/share/doc/asciidoc/examples/website/images/icons/callouts/8.png (-357 bytes) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/callouts/9.png to /usr/share/doc/asciidoc/examples/website/images/icons/callouts/9.png (-357 bytes) [DryRun] Linking /usr/share/doc/asciidoc/doc/epub-notes.txt to /usr/share/doc/asciidoc/examples/website/epub-notes.txt (-8.01 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/callouts/3.png to /usr/share/doc/asciidoc/examples/website/images/icons/callouts/3.png (-350 bytes) [DryRun] Linking /usr/share/doc/asciidoc/doc/source-highlight-filter.txt to /usr/share/doc/asciidoc/examples/website/source-highlight-filter.txt (-6.21 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/latex-filter.txt to /usr/share/doc/asciidoc/examples/website/latex-filter.txt (-5.20 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/callouts/6.png to /usr/share/doc/asciidoc/examples/website/images/icons/callouts/6.png (-355 bytes) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/example.png to /usr/share/doc/asciidoc/examples/website/images/icons/example.png (-2.54 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/callouts/4.png to /usr/share/doc/asciidoc/examples/website/images/icons/callouts/4.png (-345 bytes) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/callouts/14.png to /usr/share/doc/asciidoc/examples/website/images/icons/callouts/14.png (-411 bytes) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/callouts/13.png to /usr/share/doc/asciidoc/examples/website/images/icons/callouts/13.png (-623 bytes) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/next.png to /usr/share/doc/asciidoc/examples/website/images/icons/next.png (-1.27 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/latexmathml.txt to /usr/share/doc/asciidoc/examples/website/latexmathml.txt (-1.34 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/music-filter.txt to /usr/share/doc/asciidoc/examples/website/music-filter.txt (-5.01 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/callouts/5.png to /usr/share/doc/asciidoc/examples/website/images/icons/callouts/5.png (-348 bytes) [DryRun] Linking /usr/share/doc/asciidoc/doc/publishing-ebooks-with-asciidoc.txt to /usr/share/doc/asciidoc/examples/website/publishing-ebooks-with-asciidoc.txt (-13.06 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/callouts/12.png to /usr/share/doc/asciidoc/examples/website/images/icons/callouts/12.png (-617 bytes) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/smallnew.png to /usr/share/doc/asciidoc/examples/website/images/smallnew.png (-292 bytes) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/warning.png to /usr/share/doc/asciidoc/examples/website/images/icons/warning.png (-3.14 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/caution.png to /usr/share/doc/asciidoc/examples/website/images/icons/caution.png (-2.67 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/slidy-example.txt to /usr/share/doc/asciidoc/examples/website/slidy-example.txt (-3.91 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/tiger.png to /usr/share/doc/asciidoc/examples/website/images/tiger.png (-6.36 KiB) [DryRun] Linking /usr/share/doc/asciidoc/doc/images/icons/prev.png to /usr/share/doc/asciidoc/examples/website/images/icons/prev.png (-1.32 KiB) Mode: dry-run Files: 139 Linked: 47 files Compared: 49 files Saved: 491.89 KiB Duration: 0.87 seconds As an example, here are the details for the two biggest files: -rw-r--r-- 1 root root 206954 Feb 20 00:11 /usr/share/doc/asciidoc/doc/asciidoc.txt -rw-r--r-- 1 root root 206954 Feb 20 00:11 /usr/share/doc/asciidoc/examples/website/userguide.txt -rw-r--r-- 1 root root 128142 Jan 25 21:47 /usr/share/doc/asciidoc/doc/images/highlighter.png -rw-r--r-- 1 root root 128142 Jan 25 21:47 /usr/share/doc/asciidoc/examples/website/images/highlighter.png 100e856f49be93eec2a9fd0a9d9028e4 /usr/share/doc/asciidoc/doc/asciidoc.txt 100e856f49be93eec2a9fd0a9d9028e4 /usr/share/doc/asciidoc/examples/website/userguide.txt 99c57c2c306c4223f35f1dbb1929ef7b /usr/share/doc/asciidoc/doc/images/highlighter.png 99c57c2c306c4223f35f1dbb1929ef7b /usr/share/doc/asciidoc/examples/website/images/highlighter.png I see that always one of these files is part of the website included under /usr/share/doc/asciidoc/examples/website/. I see several solutions, of which some can also be combined: * Symlink identical files * Offload the 1MB under /usr/share/doc/asciidoc/examples into an asciidoc-examples and/or asciidoc-doc package so not everyone has to install it since I don't think everyone needs 1MB of examples and 1MB of other docs: $ du -sh /usr/share/doc/asciidoc/examples/ /usr/share/doc/asciidoc/ 1020K /usr/share/doc/asciidoc/examples/ 2.0M /usr/share/doc/asciidoc/ * Compress all or at least the bigger *.txt files (and > 200kB is definitely big for a text file) under /usr/share/doc/asciidoc/. See Debian Policy, section 12.3 [1] for details. (Thus severity normal and not minor.) Applying this solution to the examples directory would probably reopen http://bugs.debian.org/592423, so I recommend to split of the examples into their own package without compression and to compress to duplicate docs which would then still be part of the asciidoc package. [1] http://www.debian.org/doc/debian-policy/ch-docs.html#s12.3 -- System Information: Debian Release: wheezy/sid APT prefers unstable APT policy: (990, 'unstable'), (600, 'testing'), (400, 'stable'), (110, 'experimental') Architecture: amd64 (x86_64) Kernel: Linux 2.6.26-2-xen-amd64 (SMP w/1 CPU core) Locale: LANG=en_US.ISO-8859-15, LC_CTYPE=en_US.ISO-8859-15 (charmap=ISO-8859-15) Shell: /bin/sh linked to /bin/dash Versions of packages asciidoc depends on: ii python 2.6.6-3+squeeze5 interactive high-level object-orie Versions of packages asciidoc recommends: ii dblatex 0.3-2 Produces DVI, PostScript, PDF docu pn docbook-utils <none> (no description available) ii libxml2-utils 2.7.8.dfsg-2 XML utilities pn xmlto <none> (no description available) Versions of packages asciidoc suggests: pn source-highlight <none> (no description available) pn vim-addon-manager <none> (no description available) -- no debconf information -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
