~aw/sabayon-template/trunk

« back to all changes in this revision

Viewing changes to help/C/sabayon.xml

  • Committer: Bazaar Package Importer
  • Author(s): Luca Falavigna
  • Date: 2010-03-18 18:01:03 UTC
  • mto: (1.3.1 upstream) (2.1.9 experimental)
  • mto: This revision was merged to the branch mainline in revision 31.
  • Revision ID: james.westby@ubuntu.com-20100318180103-aeurz233o0ujtkw7
Tags: upstream-2.29.92
ImportĀ upstreamĀ versionĀ 2.29.92

Show diffs side-by-side

added added

removed removed

Lines of Context:
6
6
 <!ENTITY manrevision "1.0">
7
7
 <!ENTITY date "November 2009">
8
8
 <!ENTITY app "<application>sabayon</application>">
9
 
 <!ENTITY appname "Sabayon">
 
9
 <!ENTITY appname "<application>Sabayon</application>">
10
10
 <!ENTITY ldquo  "&#147;"> <!-- Left Double Quote -->
11
11
 <!ENTITY rdquo  "&#148;"> <!-- Right Double Quote -->
12
12
]>
47
47
 
48
48
        <revhistory>
49
49
            <revision>
50
 
                <revnumber>&appname; V&manrevision;</revnumber>
 
50
                <revnumber>V&manrevision;</revnumber>
51
51
                <date>&date;</date>
52
52
            </revision>
53
53
        </revhistory>
54
54
 
 
55
<!--
55
56
        <releaseinfo>
56
 
            This manual describes version &appversion; of &appname;.
 
57
            This manual describes.
57
58
        </releaseinfo>
 
59
-->
58
60
 
59
61
        <legalnotice>
60
62
            <title>Feedback</title>
62
64
                To report a bug or make a suggestion regarding the &app;
63
65
                application or this manual, follow the directions in
64
66
                the <ulink url="ghelp:gnome-feedback" type="help">GNOME Feedback
65
 
                    Page</ulink>.
 
67
                Page</ulink>.
66
68
            </para>
67
69
        </legalnotice>
68
70
    </articleinfo>
83
85
                &appname; is a system administration tool to manage GNOME desktop
84
86
                settings. &appname; provides a sane way to edit GConf defaults
85
87
                and GConf mandatory keys: the same way you edit your desktop.
86
 
                &appname; launches profiles in a Xephyr window, which provides
87
 
                an X session within an X session, like Xnest.
 
88
                &appname; launches profiles in a <application>Xephyr</application>
 
89
                                window, which provides an X session within an X session, like
 
90
                                <application>Xnest</application>.
88
91
            </para>
89
92
            <para>
90
 
                Any changes you make in the Xnest window are saved back to
91
 
                the profile file, which can then be applied to user's accounts.
92
 
                Currently &appname; is limited to the creation and update of user
93
 
                preference profiles. It does not deal with the very large
94
 
                problem of actually populating target system with those preferences.
95
 
                    So far &appname; supports complete files and the configuration format for:
 
93
                Any changes you make in the <application>Xnest</application> window
 
94
                                are saved back to the profile file, which can then be applied to
 
95
                                user's accounts. Currently &appname; is limited to the creation and 
 
96
                                update of user preference profiles. It does not deal with the very
 
97
                                large problem of actually populating target system with those
 
98
                                preferences. So far &appname; supports complete files and the
 
99
                                configuration format for:
96
100
            </para>
97
101
            <itemizedlist>
98
102
                <listitem>
143
147
# /usr/sbin/useradd -c "&appname; user" -d /var/sabayon -g nogroup -s /sbin/nologin sabayon
144
148
            </screen>
145
149
            <para>
146
 
                Create the directory /var/sabayon :
 
150
                Create the directory <filename>/var/sabayon</filename> :
147
151
            </para>
148
152
            <screen>
149
153
# mkdir /var/sabayon
195
199
            map out what functions you want your users to have.  If you're a
196
200
            business, you may wish to provide a GNOME top panel with a set of
197
201
            launchers already pre-defined.  A teacher may want to disable the
198
 
            "Administration" and "Preferences" menu items.  These are all
 
202
            <guimenuitem>Administration</guimenuitem> and
 
203
                        <guimenuitem>Preferences</guimenuitem> menu items.  These are all
199
204
            things you can do with &appname;.
200
205
        </para>
201
206
        <sect2>
202
207
            <title>Creating a profile</title>
203
208
            <para>
204
209
                Your first step will be to launch &appname;.  If you've installed
205
 
                Sabyon from your distribution's package manager, it may have an
206
 
                icon available for you under the "Administration" menu.  If
207
 
                you've installed from source, you may need to launch it
208
 
                manually.  Press &lt;alt&gt;&lt;F2&gt;, and type:
 
210
                &appname; from your distribution's package manager, it may have an
 
211
                icon available for you under the <guimenu>Administration</guimenu>
 
212
                                menu.  If you've installed from source, you may need to launch it
 
213
                manually.  Press
 
214
            <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo>, and type:
209
215
            </para>
210
216
            <screen>
211
217
gksu sabayon
212
218
            </screen>
213
219
            <para>
214
 
                and press enter.  After you've authenticated, you should see
215
 
                the main window for &appname;:
 
220
                and press <keycap>Enter</keycap>.  After you've authenticated,
 
221
                                you should see the main window for &appname;:
216
222
            </para>
217
223
            <figure>
218
224
                <title>Main Window</title>
233
239
                </mediaobject>
234
240
            </figure>
235
241
            <para>
236
 
                To create a new profile, just click on the "Add" button.
237
 
                You'll see a window, called "Add Profile", where you can name the profile, and
238
 
                optionally, select an existing profile which will be the basis,
239
 
                or starting point of this profile:
 
242
                To create a new profile, just click on the <guibutton>Add</guibutton>
 
243
                                button. You'll see a window, called <guilabel>Add Profile</guilabel>,
 
244
                                where you can name the profile, and optionally, select an existing
 
245
                                profile which will be the basis, or starting point of this profile:
240
246
            </para>
241
247
            <figure>
242
248
                <title>Add Profile</title>
257
263
            </figure>
258
264
            <para>
259
265
               Now that you've created the profile, you will want to edit it.
260
 
               Select the profile name, and click on Edit button:
 
266
               Select the profile name, and click on the <guibutton>Edit</guibutton>
 
267
                           button:
261
268
            </para>
262
269
            <figure>
263
270
                <title>Main window - Edit</title>
305
312
            <para>
306
313
                When you are done, you may want to look at what changes to the
307
314
                default session that &appname; has detected you've made.  You may
308
 
                do this by clicking on the "Edit" menu, and selecting
309
 
                "Changes".  You should see a screen that looks like the
310
 
                following:
 
315
                do this by clicking on the <guimenu>Edit</guimenu> menu, and selecting
 
316
                <guibutton>Changes</guibutton>.  You should see a screen that looks
 
317
                                like the following:
311
318
            </para>
312
319
            <figure>
313
320
                <title>Changes window</title>
335
342
                <listitem>
336
343
                    <para>
337
344
                        If you want &appname; to ignore a setting that's been
338
 
                        made, check the "Ignore" checkbox for that item.
 
345
                        made, check the <guibutton>Ignore</guibutton> checkbox for                                                      that item.
339
346
                   </para>
340
347
                </listitem>
341
348
                <listitem>
348
355
                </listitem>
349
356
                <listitem>
350
357
                    <para>
351
 
                        To have a gconf key set as a "manditory" setting,
 
358
                        To have a gconf key set as a "mandatory" setting,
352
359
                        click on it once to turn it into a
353
360
                        <emphasis>iron</emphasis> shield.
354
361
                    </para>
355
362
                </listitem>
356
363
            </orderedlist>
357
364
            <para>
358
 
                Then save the profile by selecting Profile -&gt; Save
359
 
                The profile is saved in /etc/sabayon/profiles, as a .zip file
360
 
                with the name you selected for the profile.
 
365
                Then save the profile by selecting <menuchoice><guimenu>Profile
 
366
                                </guimenu><guimenuitem>Save The Profile</guimenuitem>
 
367
                </menuchoice> is saved in <filename>/etc/sabayon/profiles</filename>,
 
368
                                as a <emphasis>.zip</emphasis> file with the name you selected
 
369
                                for the profile.
361
370
            </para>
362
371
         </sect2>
363
372
         <sect2>
364
373
             <title>Lockdown Editor</title>
365
374
             <para>
366
375
                 GNOME also includes the lockdown features of
367
 
                 <filename>Pessulus</filename>, which allow you to do things
 
376
                 <application>Pessulus</application>, which allow you to do things
368
377
                 like prevent users from modifying their panels, opening a
369
 
                 "Run Application" dialogue, etc.
 
378
                 <guilabel>Run Application</guilabel> dialogue, etc.
370
379
             </para>
371
380
             <para>
372
 
                 You can use the lockdown editor by selecting Edit -&gt;
373
 
                 Lockdown on the Desktop editor window.
 
381
                 You can use the lockdown editor by selecting <menuchoice>
 
382
                             <guimenu>Edit</guimenu><guimenuitem>Lockdown</guimenuitem>
 
383
                 </menuchoice> on the <guilabel>Desktop editor</guilabel> window.
374
384
             </para>
375
385
            <figure>
376
386
                <title>Lockdown editor</title>
399
409
               Important: it is advisable to create a new user to test the profile.
400
410
           </para>
401
411
           <para>
402
 
               Select the profile that you want to apply and click on Users :
403
 
               Then, select the users that you want to apply the profile.
404
 
               In this example Eleve1 and Eleve 2 will have the profile
405
 
               my_profile.
 
412
               Select the profile that you want to apply and click on
 
413
                           <guibutton>Users</guibutton> : Then, select the users that you
 
414
                           want to apply the profile. In this example <emphasis>Eleve1
 
415
                           </emphasis> and <emphasis>Eleve 2</emphasis> will have the profile
 
416
                           <filename>my_profile</filename>.
406
417
            </para>
407
418
            <figure>
408
419
                <title>Apply profile by user</title>
432
443
            <sect3>
433
444
                <title>Via the gui</title>
434
445
                <para>
435
 
                    Simply use the simply sabayon-apply script above, but
436
 
                    within the gui tool, select the 'Group' button, and check
437
 
                    off which groups you wish to apply the profile to.
 
446
                    Simply use the simply <command>sabayon-apply</command> script,
 
447
                                        which is shipped with &appname; by default, but within the gui
 
448
                                        tool, select the <guibutton>Group</guibutton> button, and check
 
449
                                        off which groups you wish to apply the profile to.
438
450
                </para>
439
451
                <figure>
440
452
                    <title>Apply profile by group</title>