[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Debian packages now split off documentation



Le mercredi 25 janvier 2006 à 23:33 -0600, Kenneth Pronovici a écrit :
> The Debian packages for Cedar Backup now split off the documentation
> into cedar-backup2-doc rather than putting them in cedar-backup2.  This
> makes the software package itself much smaller, for users who don't need
> the documentation on every one of their machines.  
> 
> This change was prompted by a Debian bug report originally asking me not
> to distribute both the HTML and PDF versions of the documentation.  I
> rejected this request, under the premise that the two forms of the
> documentation are both useful for different purposes (HTML for online
> browsing, PDF for printing).  However, I was convinced that it was worth
> splitting the documentation off into a separate package so you don't
> have to download the documentation if you don't want to.
For the track, this is #344474.
There are two issues (in no particular order):
- generating this documentation including the screenshots requires a
non-free utility. So, the documentation should probably go into contrib
until a solution is found. If the documentation is in the same package
as the program, the full program should go into contrib.
- documentation is really huge (to download and on disk space) in
comparison to the program itself, and not everybody would like to have
the documentation on all its servers while it can be only at one place.
Especially because the documentation is available in several formats,
which multiplies the size.

Later on, we could even think in splitting the documentation binary
packages, one for each format.

> The upshot is that, after upgrading to 2.7.2-2, you will need to install
> cedar-backup2-doc if you still want the documentation on your system.
> (It's Recommended, so package managers like aptitude may pull it along
> by default.)
If it's done this way, it is usually not a problem at all.

Thanks a lot for your change.

> Let me know if you have any questions or comments.
> 
> KEN
> 
> -- 
> Kenneth J. Pronovici <pronovic@ieee.org>
> http://www.cedar-solutions.com/




--
To unsubscribe, send mail to cedar-backup-users-unsubscribe@cedar-solutions.com.