[Xfce4-commits] <xfce4-docs:xfce4-panel-master> Review preferences.page.
Nick Schermer
noreply at xfce.org
Sat Apr 16 15:34:05 CEST 2011
Updating branch refs/heads/xfce4-panel-master
to e65bd30410568f07f8da1a0bf410d9e9b84b6ef6 (commit)
from b9a2588439833e8fd851e0a777dc38d43450c7c9 (commit)
commit e65bd30410568f07f8da1a0bf410d9e9b84b6ef6
Author: Nick Schermer <nick at xfce.org>
Date: Sat Apr 16 15:24:14 2011 +0200
Review preferences.page.
preferences.page | 152 +++++++++++++++++++++++++++++++++++++----------------
1 files changed, 106 insertions(+), 46 deletions(-)
diff --git a/preferences.page b/preferences.page
index df4d435..ea68c95 100644
--- a/preferences.page
+++ b/preferences.page
@@ -18,10 +18,10 @@
<title>Preferences</title>
<p>
- The Xfce panel preferences dialog gives you the ability
- to customize your panel. You can change the size, appearance,
- and orentation of your panels. You can also add or remove extra
- panels on your desktop.
+ The Xfce panel preferences dialog gives you the ability
+ to customize your panel. You can change the size, appearance,
+ and orientation of your panels. You can also add or remove extra
+ panels on your desktop.
</p>
<figure>
@@ -33,12 +33,12 @@
<title>Accessing Panel Preferences</title>
<p>
- The panel preferences can be opened by going to <guiseq>
- <gui>Settings</gui><gui>Panel</gui></guiseq> in your applications menu.
- You can also access panel preferences by right clicking on your panel
- and going to <gui>Panel Settings</gui>. If you right click on space occupied by a
- panel plugin, you can access panel preferences by going to <guiseq><gui>Panel</gui>
- <gui>Panel Settings</gui></guiseq>.
+ The panel preferences can be opened by going to <guiseq>
+ <gui>Settings</gui><gui>Panel</gui></guiseq> in your applications menu.
+ You can also access panel preferences by right clicking on your panel
+ and going to <gui>Panel Settings</gui>. If you right click on space occupied by a
+ panel plugin, you can access panel preferences by going to <guiseq><gui>Panel</gui>
+ <gui>Panel Preferences...</gui></guiseq>.
</p>
</section>
@@ -46,13 +46,13 @@
<title>Selecting a panel</title>
<p>
- You can select a panel from the dropdown list at the top of the dialog.
+ You can select a panel from the drop down list at the top of the dialog.
Next to this are two buttons that can be used to remove (-) the currently
selected panel or add (+) a new empty panel.
</p>
<p>
- The panel selected in the dialog should also show a slection around
+ The panel selected in the dialog should also show a selection around
the panel, so it is clear which panel you are editing.
</p>
</section>
@@ -89,9 +89,9 @@
<p>
If you have multiple monitors connected to the computer, this
option will appear in the properties dialog. This will tell the panel
- to stretch across multiple monitors instead of only being restricted to
- one monitor. This tells the panel to look at the total screen size instead
- of the size of an individual monitor.
+ to stretch across multiple monitors instead of only being restricted to
+ one monitor. It look at the total screen size instead of the size of
+ an individual monitor.
</p>
</item>
@@ -100,8 +100,8 @@
<p>
Don't show the handles on the panel which allow you to move
the panel. When this option is disabled, you can drag the panel
- anywhere you want on your screen. The panel will also snap to the
- edges of your screen.
+ anywhere you want on your screen. The panel will also snap to the
+ edges of your screen.
</p>
</item>
@@ -160,46 +160,57 @@
<terms>
<item>
<title><gui>Style</gui></title>
- <p>
- This allows you to change the transparency, color, and background
- image of the panel. You have three options to choose from.
- </p>
-
- <terms>
- <item>
- <title><gui>None (user system style)</gui></title>
+
<p>
- The panel inherits colors from the currently selected GTK+
- theme. You can view and change the current GTK+ theme by going to
- <guiseq><gui>Settings</gui><gui>Appearance</gui></guiseq>.
+ This allows you to change the transparency, color, and background
+ image of the panel. You have three options to choose from.
</p>
- </item>
- <item>
- <title><gui>Solid Color</gui></title>
- <p>
- You can select a color using the provided color picker.
- The color you select will be applied to the panel.
- </p>
- </item>
-
- <item>
- <title><gui>Background Image</gui></title>
- <p>
- Select a background for your panel.
- </p>
- </item>
- </terms>
+ <terms>
+ <item>
+ <title><gui>None (user system style)</gui></title>
+ <p>
+ The panel inherits colors from the currently selected GTK+
+ theme. You can view and change the current GTK+ theme by going to
+ <guiseq><gui>Settings</gui><gui>Appearance</gui></guiseq>.
+ </p>
+ </item>
+
+ <item>
+ <title><gui>Solid Color</gui></title>
+ <p>
+ You can select a color using the provided color picker.
+ The color you select will be applied to the panel.
+ </p>
+ </item>
+
+ <item>
+ <title><gui>Background Image</gui></title>
+ <p>
+ Select a background for your panel.
+ </p>
+ </item>
+ </terms>
</item>
<item>
<title><gui>Alpha</gui></title>
<p>
Change the alpha transparency of the panel.
- Some panel plugins may still retain a non-transparent backgound.
+ Some panel plugins may still retain a non-transparent background.
This option is only available if your panel style is set to <gui>None</gui>
or <gui>Solid Color</gui>.
</p>
+
+ <note>
+ <p>
+ The opacity and alpha settings are only available if the X server supports
+ compositing and this is enabled in the window manager. To enabled this in Xfwm4
+ activate <guiseq><gui>Settings</gui><gui>Window Manager Tweaks</gui>
+ <gui>Compositor</gui><gui>Enable display compositing</gui></guiseq>
+ from the applications menu.
+ </p>
+ </note>
</item>
<item>
@@ -225,7 +236,9 @@
<section>
<title>Opacity</title>
+ <p>
These options set the transparency of the entire panel.
+ </p>
<terms>
<item>
<title><gui>Enter</gui></title>
@@ -280,9 +293,56 @@
</p>
<p>
- Only limition in this dialog, compared to mouse handling, is that
+ Only limitation in this dialog, compared to mouse handling, is that
you cannot move items between panels and access custom menu items
a plugin can add in the item menu.
</p>
</section>
+
+ <section>
+ <title>Hidden Properties</title>
+
+ <terms>
+ <item>
+ <title>disable-struts</title>
+ <p>
+ When the panel is snapped to a monitor edge and it is not between
+ two monitors on the same screen, it will avoid windows from overlapping
+ the panel (ie. the window manager will reserve space for the panel).
+ </p>
+
+ <p>
+ This behavior can be disabled per-panel with the xfconf property
+ <var>disable-struts</var>. This can be changed with <app>xfconf-query</app>
+ like the command below. Remember to replace <var>panel-0</var> with the
+ appropriate panel number, which is the number of the panel in the preferences
+ dialog minus one.
+ </p>
+
+ <p>
+ <cmd>xfconf-query -c xfce4-panel -p /panels/panel-0/disable-struts -t bool -n -s true</cmd>
+ </p>
+ </item>
+ </terms>
+ </section>
+
+ <section>
+ <title>Style Settings</title>
+
+ <terms>
+ <item>
+ <title>Class <em>PanelWindow</em></title>
+ <terms>
+ <item>
+ <title><var>popup-delay</var></title>
+ <p>Control the popup delay of a hidden panel in milliseconds. Defaults to 225.</p>
+ </item>
+ <item>
+ <title><var>popdown-delay</var></title>
+ <p>Control the popdown delay of a hidden panel in milliseconds. Defaults to 350.</p>
+ </item>
+ </terms>
+ </item>
+ </terms>
+ </section>
</page>
More information about the Xfce4-commits
mailing list