GNOME Bugzilla – Bug 123132
Placeholder for all (potential) documentation changes.
Last modified: 2004-12-22 21:47:04 UTC
I'm opening this bug, and will add numbered comments into in for all the places where we will potentially need changes in the documentation (man pages and online help) for various gcalctool bugs fixes (between GNOME v2.4.0 and GNOME v2.6.0).
1) Bug #118826. The keyboard shortcuts for the six hex. digits are now "A" to "F". The functions that previously used those letters have been reassigned to their lowercase equivalents. These were: Accuracy (now "a") Change Sign (now "c") Double-declining depreciation (now "d") Exponential (now "e") User-defined functions (now "f") Note that left or right shifting 10-15 places now uses the 'A' to 'F' keyboard accelerators (rather than 'a' to 'f').
Created attachment 20252 [details] Patch for gcalctool man pages to adjust for changes in bug #118826.
2) Bug #65806 The "e" in the e^x (e superscript x) label, in scientific mode is not italised. I'm not sure there is much to do here apart from a new screenshot
3/ Bug #123724 Hitting the Escape key will now provide the CE (clear entry) functionality. Control-Back Space will continue to provide this functionality too.
I have submitted Calculator Manual V2.6 to CVS. This updated manual documents the fix for Bug #118826 and Bug #123724. I did not update any screenshots or other references to e^x (Bug #65806). Will check with a colleague to see what changes, if any, are necessary.
e in e^x ========= I checked the e^x question with my colleague Pat, because I felt that the e should not have been italicized in the first place. Here is Pat's response: " This symbol should not be italicized for the following reasons: - In scientific terms e is the base of the natural system of logarithms and is always a mathematical constant, like c, or g, or G, or Avogadro's Constant. None of these notable constants are italicized. - In mathematical terms a variable is, eh, invariably italicized. Base e is the symbol for natural logs, and is therefore shorthand for "Base of Natural Logarithm", and is therefore not a variable. Where the custom of italicizing e might have arisen is that an unknown quantity as a power of e is a variable, for example e^x. In this case, e would be normal text and x would be italicized, because x is a variable, and e is not. Therefore, e should not be italicized in the Help, or for that matter in the GUI, but powers of e should be italicized. " If Rich italicizes the "x" and "y" in e^x, 1/x, x^2, x!, 10^x, and y^x, I'll update the Help accordingly. For more details, see the original bug 65806. e in exponential numbers ======================== I will update the Exponential Numbers section of the Help to clarify how the numeric base determines the value of an exponential number. If Rich changes the exponential notation from "e" to "exp", I'll update the Help accordingly. For more details, see the original bug 65806.
More on bug #65806 w.r.t. "e^x" Breda and Pat's arguments sold me here, so I've made the following changes: For the "1/x", "x^2", "x!", "e^x", "10^x" and "y^x" labels, all occurances of "x" and "y" are now italicized. The "e" in "e^x" is no longer italicized.
4) Bug #125873 This enhancement request add in a new View menu entry called "Show Thousands Separator" that if set, should the thousands seperator character for fixed point numbers displayed in the decimal base.
5) Bug #129496 All occurances of "gradients" need to be replaced with "gradians". I strongly suspect that nobody is using this feature.
Another comment for bug #125873. Actually, bug #130282 really discusses it, but they are related. There will not be a "thousands separator" character if you are using the C locale. The documentation for this feature should reflect this. Thanks.
6) Bug #130078. Label was changed to x^y (really x superscript y). Tooltip label changed to "Raise displayed value to the power of y". Breda mentioned that the online help has this correct, but presumably any screenshots of the scientific mode will need to be adjusted.
Breda, will you have time to integrate the doc changes for the community GNOME 2.6 release?
Yes, that's the plan :)
7) Bug 131303 Remove the section about input methods.
8) bug 131594. The "Insert ASCII View..." menu item and the "Insert" button no longer use the GTK_STOCK_CONVERT stock icon as per the HIG). Many some screenshots need updating...
9/ Bug #132570. Adjusted UI to use spacing to delineate groups rather than frames (per the HIG).
I have submitted Calculator Manual V2.7 to CVS. This updated manual documents the fix for Bug #65806, Bug #125873, Bug #129496, Bug #130078, and Bug #131303. I have also captured new screenshots. Bugs 131594 and 132570 did not require additional documentation changes. Some other software changes suggested in this current bug do not seem to have been made. I will open another bug to keep all of those changes together, and will now close this bug.
Sorry, was having problems logging the bug, hope I haven't done so in duplicate. The new bug is Bug #133764.