Bug#341395: seperate api docs and configuration samples

[Tzafrir Cohen]

Package: asterisk
Version: 1.2.0-1

Thanks to Caio Begotti for pointing this out. Submitting this in a
separate bug report.

Asterisk's main configuration reference is the configs/ directory. While
officially labeled "confiugration examples", it basically contains
a rather well-anotated and rather well set of configuration files.
Those files are around 

So this is rather essential documentation ot every admin trying to
configure an Asterisk system.

OTOH, the API documentation are a huge pile of html files and graphs.
They may be of some use for developers, but not for most sysadmins. The
dedicated work of the asterisk documentation team has inflated the size
of the API directory to ~75MB . The deb itself is 13MB. 

$ du /usr/share/doc/asterisk-doc/
74911   /usr/share/doc/asterisk-doc/api/html
74911   /usr/share/doc/asterisk-doc/api
8       /usr/share/doc/asterisk-doc/contrib/utils
93      /usr/share/doc/asterisk-doc/contrib/scripts
40      /usr/share/doc/asterisk-doc/contrib/firmware/iax
40      /usr/share/doc/asterisk-doc/contrib/firmware
8       /usr/share/doc/asterisk-doc/contrib/thirdparty
24      /usr/share/doc/asterisk-doc/contrib/init.d
221     /usr/share/doc/asterisk-doc/contrib
210     /usr/share/doc/asterisk-doc/examples
75675   /usr/share/doc/asterisk-doc/

I believe that the stuff in the contrib directory is of rather limited
use. I haven't examined yet the files in root of /usr/share/asterisk/

-- 
Tzafrir Cohen     icq#16849755  +972-50-7952406
tzafrir.cohen at xorcom.com  http://www.xorcom.com