GNOME Bugzilla – Bug 658712
Help documentation needs to be rewritten in Mallard.
Last modified: 2013-02-11 17:03:31 UTC
The Help button in gnome-session-properties points to the old GNOME 2 user guide and therefore doesn't work in GNOME 3. Unless help about configuring Startup Applications is added, the Help button should be removed.
In GNOME 2.32 this opens "Setting Programs to Start Automatically When You Log In", in 3.0 I get an error The URI 'ghelp:user-guide?gosstartsession-2#gosstartsession-2' does not point to a valid page. Grep'ing in gnome-user-docs git master I only get ./gnome-help/C/session-loginsound.page.old so this does not seem to be covered in the user docs (yet). Question is rather there are plans to cover this for 3.2, or to remove the button (UI freeze break in case a screenshot is shown in the user docs).
I think we should add a page about configuring Startup Applications, especially since the command field is not always the easiest thing for a user to figure out.
mpt's proposal to overhaul Startup Applications would be pretty awesome to make this more usable, but yeah at least for a while we're stuck with what we have. https://live.gnome.org/Design/SystemSettings/Proposals/LoginItems
A stub page (startup-applications.page) has been pushed to master: http://git.gnome.org/browse/gnome-user-docs/commit/?id=edf06ec95a5f9f77b762c9567971a5e3f4904fb1 So the steps to fixing this bug are: 1. Fill in the stub page 2. Have it reviewed 3. Add it to /gnome-user-docs/gnome-help/Makefile.am 4. In /gnome-session/capplet/main.c in the gtk_show_uri function, change ghelp:user-guide?gosstartsession-2 to: ghelp:user-help?startup-applications (or maybe it's help:user-help/startup-applications) (I'm not clear about this last point)...
Thanks Tiffany! The link would be help:gnome-help/startup-applications except in Unity on Ubuntu where it's help:ubuntu-help/startup-applications .
I don't see this in GNOME 3.2. Do we even ship this configuration panel by default?
Shaun, I believe it's included but hidden by default presumably because the UI is so bad. (Unity however gives it prominent placement in their system status indicator menu but hides most of the entries since most users shouldn't be disabling the usual services.) You can run gnome-session-properties manually to take a look. http://git.gnome.org/browse/gnome-session/tree/data/session-properties.desktop.in.in
I on 3.2 I brought it up from the command line: gnome-session-properties I assume it was there by default.
(In reply to comment #4) > So the steps to fixing this bug are: > > 1. Fill in the stub page > 2. Have it reviewed > 3. Add it to /gnome-user-docs/gnome-help/Makefile.am > 4. In /gnome-session/capplet/main.c in the gtk_show_uri function, change Feel free to do those last two points whenever you feel it's ready :-)
Since there's been no progress on this can we simply the Help button for the time being; it's really not OK to have Help buttons that go nowhere. http://patch-tracker.debian.org/patch/series/view/gnome-session/3.4.2.1-3/14_hide_session_properties_help.patch would work
commit e9764e3db2696e282521c7f01dd460416f8e6ee0 Author: Matthias Clasen <mclasen@redhat.com> Date: Sat Feb 9 13:15:57 2013 -0500 Hide non-working help button gnome-session-properties has a help button that points to no-longer-exising docs. Hide it until new docs are available. https://bugzilla.gnome.org/show_bug.cgi?id=658712