Bug#852166: Contains a large number of auto-generated stub manpages

[Michael Stapelberg]

Package: liblapack-doc-man
Version: 3.7.0-1
Severity: normal

liblapack-doc-man installs 10770 files into /usr/share/man/man3, all of which 
seem to be generated by Doxygen if I understand correctly.

Of these 10770 files, 5902 are symlinks and 4868 are regular files.
Of the 4868 regular files:
• 2057 files consist of 19 lines (documenting a function)
• 2550 files consist of 25 lines (documenting a file)

Notably, these files do not contain anything but the function prototype.

261 files with actual content worth looking at remain.

The large number of files without substantial content is unfortunate for a few 
different reasons:

• On manpages.debian.org, liblapack-doc-man consumes 1GB of disk space per 
  Debian version. The next biggest consumer is linux-manual-4.8 with 51 MB.

• liblapack-doc-man consumes about 10000 inodes on user’s root file systems for 
  no good reason. Even when plenty of inodes are available, remember that many 
  backup programs do not scale well when presented with a large number of tiny 
  files.
  
• I haven’t verified it, but I assume that the man database and similar tools 
  will degrade in performance when presented with such a large corpus of 
  manpages.
  
Could you change the package so that it only contains the 261 files with actual
content please? Thank you!


-- System Information:
Debian Release: 9.0
  APT prefers testing
  APT policy: (990, 'testing'), (500, 'unstable-debug'), (500, 'testing-debug'), (500, 'unstable')
Architecture: amd64 (x86_64)
Foreign Architectures: i386, armel, mipsel

Kernel: Linux 4.8.0-2-amd64 (SMP w/8 CPU cores)
Locale: LANG=de_DE.UTF-8, LC_CTYPE=de_DE.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)