After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 327636 - Budget GUI lacks help text
Budget GUI lacks help text
Status: RESOLVED OBSOLETE
Product: GnuCash
Classification: Other
Component: Budgets
git-master
Other Linux
: Normal normal
: ---
Assigned To: gnucash-documentation-maint
gnucash-core-maint
Depends on:
Blocks:
 
 
Reported: 2006-01-19 00:42 UTC by Josh Sled
Modified: 2018-06-29 20:55 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description Josh Sled 2006-01-19 00:42:20 UTC
(From GNOME2_STATUS)
Comment 1 Carsten Rinke 2014-08-07 18:54:33 UTC
What was this bug about?
Comment 2 John Ralls 2014-08-10 18:35:41 UTC
Just what the subject says: It's documenting the fact that there's no help text for the budget GUI. 

Candidate files for adding the help text are
src/gnome/gnc-budget-view.c
src/gnome/gnc-budget-view.h
src/gnome/gnc-plugin-budget.c
src/gnome/gnc-plugin-budget.h
src/gnome/gnc-plugin-page-budget.c
src/gnome/gnc-plugin-page-budget.h
src/gnome/gtkbuilder/gnc-plugin-page-budget.glade
src/gnome/ui/gnc-plugin-budget-ui.xml
src/gnome/ui/gnc-plugin-page-budget-ui.xml
src/gnome-utils/gnc-tree-model-budget.c
src/gnome-utils/gnc-tree-model-budget.h
Comment 3 Carsten Rinke 2014-08-11 04:26:24 UTC
Is there a good place within GnuCash to look at to get an idea how help text should be applied?

I guess my real question is:
Is this a pure Budget GUI bug or a general GnuCash GUI bug?
Comment 4 John Ralls 2014-08-11 14:06:27 UTC
Take a look at src/register/ledger-core/split-register-model.c or its Register2 twin src/gnome-utils/gnc-tree-view-split-reg.c. Note the strings assigned to the variable "help" and the display mechanism, which will be more explicit in split-register-model.c because all of the display code is present; in Reg2 a lot of it is handled by the GtkTreeView class.
Comment 5 Carsten Rinke 2014-08-11 21:14:32 UTC
Thanks for hint - that did the trick and now I know what to look at.
Comment 6 Frank H. Ellenberger 2014-09-06 13:56:38 UTC
While in gnucash-docs we have guide/C/ch_budgets.xml there is none in help/C/. And it is hard to assign, if there is no text with anchors.

IMHO it should be assigned to gnucash-documentation-maint@gnome.bugs - like a bunch of other older documentation bugs.
Comment 7 Frank H. Ellenberger 2014-09-06 14:39:49 UTC
Who ever will write the help (I don't use budgets), a few hints:

jsled wrote the budgets module and chris some documentation. Seach the mailing list archive for more information.

Perhaps one could use the current guide/c/ch_budgets.xml by adding a few more "id="s to the sections as help/c/ch_budgets.xml
Comment 8 Frank H. Ellenberger 2014-09-06 17:41:05 UTC
Sorry for mixing this:
<warlord> fell: no, chris shoemaker wrote the budgets.  jsled did SX
Comment 9 Matt 2015-12-26 01:44:54 UTC
I'm a tad confused about what the original bug is looking for - in terms of what benefit will be realised.

The help text as per the column splits is quite useful - i.e. it guides you through what each column is for (when you look down the bottom of the screen). E.g. What is 'num' column for? Oh wait, down the bottom is a useful little message that tells me the kind of thing I can use it for...
For the current budget gui, there is pretty much just time period columns (which are pretty obviously the relevant time period) and rows (which are pretty obviously the account of interest).

Can anyone advise specifically what kind of help messages they would be interested in seeing for any given column/row in the budget gui? Or have I completely misunderstood what this bug is looking for.

I'm happy to take the lead in implementing these little help messages in the code, but don't see much of a use at this point.
Comment 10 John Ralls 2015-12-26 23:45:46 UTC
There are two ways "online" help is provided: Tooltips, those little messages that sometimes pop up when you hover over a control, and the more complete description of the controls with screenshots and a big-picture explanation that's presented when you select the help menu or in some places click the help button. This bug is about the latter, and it goes in the gnucash-docs repo rather than the gnucash repo.

It's not clear to me from looking at a budget page that tooltips are going to be very helpful in this case.
Comment 11 John Ralls 2018-06-29 20:55:39 UTC
GnuCash bug tracking has moved to a new Bugzilla host. The new URL for this bug is https://bugs.gnucash.org/show_bug.cgi?id=327636. Please continue processing the bug there and please update any external references or bookmarks.