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 697857 - New topic to start applications automatically on login
New topic to start applications automatically on login
Status: RESOLVED OBSOLETE
Product: gnome-user-docs
Classification: Core
Component: gnome-help
3.8.x
Other Linux
: Normal normal
: ---
Assigned To: Maintainers of Gnome user documentation
Maintainers of Gnome user documentation
Depends on:
Blocks:
 
 
Reported: 2013-04-12 09:55 UTC by Aruna Sankaranarayanan
Modified: 2018-03-26 14:30 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
New topic shell-apps-auto-start.page (79.46 KB, patch)
2013-04-12 09:55 UTC, Aruna Sankaranarayanan
needs-work Details | Review
Changes after review (5.19 KB, patch)
2013-04-13 13:39 UTC, Aruna Sankaranarayanan
needs-work Details | Review

Description Aruna Sankaranarayanan 2013-04-12 09:55:41 UTC
Created attachment 241332 [details] [review]
New topic shell-apps-auto-start.page

We need a topic page to explain how users can configure gnome-session-rpoperties to have certain applications start up automatically on login. I have attached a patch for the same.
Comment 1 Kat 2013-04-12 12:18:45 UTC
Review of attachment 241332 [details] [review]:

::: gnome-help/C/shell-apps-auto-start.page
@@ +1,3 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="topic" style="task"
+      id="auto-start-apps">

Match the ID to the page title.

@@ +5,3 @@
+    <link type="guide" xref="index" group="user" />
+
+    <revision version="0.1" date="2013-04-07" status="draft"/>

You're missing the pkgversion.

@@ +14,3 @@
+    </credit>
+
+    <desc>Use <sys>gnome-session-properties</sys> to have multiple

It's also possible to use this to auto-launch only one application as well. The page should not be about using gnome-session-properties, but about adding more applications to launch on login.

@@ +22,3 @@
+  <p>GNOME automatically runs a set of applications in the background when you
+  login. These are mostly important processes, applications or
+  <link href="man:daemon">daemons</link>. You can have other applications

Probably a bit too technical for the average user. Maybe just say that they're things needed for everything to work?

@@ +23,3 @@
+  login. These are mostly important processes, applications or
+  <link href="man:daemon">daemons</link>. You can have other applications
+  of your choice like web-browsers or the <app>Terminal</app> start

Web browser is not hyphenated. Use a couple of commas around the example. I prefer to use "such as" instead of "like".

@@ +27,3 @@
+
+<section id="start">
+  <title>Start <sys>gnome-session-properties</sys></title>

I doubt the average user is interested in starting gnome-session-properties :) Make the page into more of a "task that the user wants to achieve and here is how to do it" style. In other words, there should probably be only one steps list for starting up the application and updating the auto-lauch list.

@@ +51,3 @@
+
+  <media type="image" src="figures/shell-apps-auto-start-add.png"
+  style=" floatend"/>

Why are you using an image here?

@@ +129,3 @@
+      <p>When you choose to remove an item from the list, you will not be
+      prompted for confirmation. An item once removed from the list cannot be
+      restored.</p>

Can it not be added back? :)

::: system-admin-guide/C/automatic-applications.page
@@ -1,1 @@
-<page xmlns="http://projectmallard.org/1.0/"

This page is not in the repository :)

::: system-admin-guide/Makefile.am
@@ -11,2 @@
 HELP_FILES = \
-	automatic-applications.page	\

This isn't in the repository.
Comment 2 Aruna Sankaranarayanan 2013-04-13 13:39:25 UTC
Created attachment 241450 [details] [review]
Changes after review

I have removed the sections to edit and remove applications since that's about using gnome-session-properties and not about adding applications. I have condensed editing and removing to fit into a note by removing the steps for those sections. Is this okay?

I have deleted both the screenshots since they don't add much and will probably cause troubles during translation. :)

The page was actually written for the sys-admin-guide, and I accidentally committed on the same branch. Sorry about that. :)

Thanks for the review. :)
Comment 3 André Klapper 2014-03-22 10:16:53 UTC
Comment on attachment 241450 [details] [review]
Changes after review

>+    <desc>Use <sys>gnome-session-properties</sys> to start applications
>+    automatically on login.</desc>

Still not sure if the technical name of some binary should be exposed in the <desc>. In the end users want to find out how to start applications automatically on login, and not how it's implemented.

>+  <p>When you login, GNOME automatically starts some applications and runs
>+  them in the background. These are usually important programs that help your
>+  session to run smoothly.

Somehow the phrasing made me think of all those funny computer magazines "300 tools to make your Windows run smoother and faster!". Proposal (but would like to get feedback by others):
When you login, GNOME automatically starts some applications and runs them in the background. These are helper programs needed to run your session.

>+  <title>Add an application to <sys>gnome-session-properties</sys></title>

Hmm, this still doesn't describe what the user is after, right? What I would like to achieve is making an application run on start, not adding an application to some-name-with-dashes.

>+    <item>
>+      <p>To start <sys>gnome-session-properties</sys>, press
>+      <keyseq><key>Alt</key><key>F2</key></keyseq> and type
>+      <input>gnome-session-properties</input> and press <key>Enter</key>. You
>+      will see a list of applications that are started automatically on
>+      login.</p>
>+    </item>
>+    <item>
>+      <p>Click <gui style="button">Add</gui> to add an application of your
>+      choice to the list.</p>
>+    </item>
>+    <item>
>+      <p>In the <gui>Name</gui> field, type the name of the application. If
>+      you leave this field blank, the application name will be identified by
>+      your entry in the <gui>Command</gui> field.</p>
>+    </item>
>+    <item>
>+      <p>In the <gui>Command</gui> field, type the command used to run the
>+      application. Alternatively, you can click on
>+      <gui style="button">Browse</gui> and choose the executable file for the
>+      application. These executable files are usually found in
>+      <file>/usr/share/applications</file>.</p>

On Fedora 20, /usr/share/applications has .desktop files but no executable files.
/usr/bin has the executables, so either "executable file" or the folder is wrong?

>+      <p>If you wish, you can also add a comment about the application in
>+      the <gui>Comment</gui> field.</p>

...which will be displayed in the list of startup programs (or so)?

>+      <p>Click <gui style="button">Add</gui> to add your application. You will
>+      now be able to see the name of the application you added, in the list.

"You will now see the application that you added in the list." or so?

>+  <note style="tip">
>+    <p>You can edit the details of an application in the list, by selecting it

I'd drop the comma here.

>+    from the list and clicking <gui style="button">Edit</gui>. You can also
>+    remove applications from the list by selecting them and clicking
>+    <gui style="button">Remove</gui></p>

Is that non-obvious enough to explain it here? 
The latter sentence basically says "Click remove to remove", right?
Comment 4 GNOME Infrastructure Team 2018-03-26 14:30:51 UTC
-- GitLab Migration Automatic Message --

This bug has been migrated to GNOME's GitLab instance and has been closed from further activity.

You can subscribe and participate further through the new bug through this link to our GitLab instance: https://gitlab.gnome.org/GNOME/gnome-user-docs/issues/5.