FS#11097 - add gnucash-docs to gnucash package

Attached to Project: Arch Linux
Opened by Marq Schneider (queueRAM) - Saturday, 02 August 2008, 23:44 GMT
Last edited by Eric Belanger (Snowman) - Sunday, 22 March 2009, 05:42 GMT
Task Type Feature Request
Category Packages: Extra
Status Closed
Assigned To Aaron Griffin (phrakture)
Architecture All
Severity Very Low
Priority Normal
Reported Version None
Due in Version Undecided
Due Date Undecided
Percent Complete 100%
Votes 1
Private No

Details

Description:
The gnucash devs split the documentation into a separate source tarball (gnucash-docs). Currently, the Arch Linux gnucash package does not include this documentation which makes the Help menu rather useless. I had created a gnucash-docs package in AUR to mitigate the problem, but i think it would better belong with the base gnucash package itself. The documentation package size is 9.3MB.

Additional info:
Docs tarball:
http://dl.sourceforge.net/sourceforge/gnucash/gnucash-docs-2.2.0.tar.gz
AUR package:
http://aur.archlinux.org/packages.php?ID=12567
This task depends upon

Closed by  Eric Belanger (Snowman)
Sunday, 22 March 2009, 05:42 GMT
Reason for closing:  Fixed
Comment by Aaron Griffin (phrakture) - Tuesday, 05 August 2008, 18:49 GMT
Hmm, can't seem to decide on this one... this would increase the package size by 150%...

Could we get some gnucash users to 'vote' on this one?
Comment by Marq Schneider (queueRAM) - Tuesday, 05 August 2008, 22:24 GMT
The size was one of the reasons I decided to create a separate package, however, I've come to realize that size shouldn't drive everything, especially if it removes functionality. Now, there are few things that come to play here.

If we want to match upstream as much as possible, then having separate gnucash-docs and gnucash packages make sense. If we want to minimize the size of the packages during an update, then it makes sense to keep the two separate. If we want to make sure the core functionality exists (Help->Context menu), then we should merge the two.

Honestly, it makes more sense to split them, since the docs really haven't changed at every minor revision number bump. (docs are the same for 2.2.6 as they were for 2.2.0). But there is no visibility to this fact if a user tries to use the Help menu. There is a warning dialog that appears saying "try installing the gnucash-docs package". Perhaps we should just move gnucash-docs to the extra repository, so users don't need to go hunting through AUR.
Comment by . (vilefridge) - Friday, 05 December 2008, 11:42 GMT
From a software engineering standpoint, the user documentation definitely belongs with the software. I vote for inclusion in the base package.
At the very least, a note after installing gnucash with pacman that there is a gnucash-docs package available would be nice. I recall that openoffice-base used to suggest openoffice-spell-en (now deprecated) in this very manner.

Loading...