Attachment 159212 Details for Bug 201870 – Patch to add Xfce-specific FAQ

[patch] Patch to add Xfce-specific FAQ

projects.diff (text/plain), 15.72 KB, created by Olivier Duchateau on 2015-07-25 12:46:28 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Olivier Duchateau

Created: 2015-07-25 12:46:28 UTC

Size: 15.72 KB

patch

obsolete

>Index: htdocs/Makefile
>===================================================================
>--- htdocs/Makefile	(revision 47076)
>+++ htdocs/Makefile	(working copy)
>@@ -71,6 +71,7 @@
> SUBDIR+= security
> SUBDIR+= snapshots
> SUBDIR+= support
>+SUBDIR+= xfce
> .if !defined(WEB_ONLY) || empty(WEB_ONLY)
> SUBDIR+= doc
> SUBDIR+= ports
>Index: htdocs/projects/projects.xml
>===================================================================
>--- htdocs/projects/projects.xml	(revision 47076)
>+++ htdocs/projects/projects.xml	(working copy)
>@@ -99,6 +99,10 @@
> OpenOffice.org on FreeBSD</a>:
> Information about the various OpenOffice.org ports.</li>
> 
>+<li><a name="xfce" href="../xfce/index.html">Xfce on &os;</a>:
>+This contains information on how to install, run it and FAQ covering
>+&os;-specific Xfce issues.</li>
>+
> <li><a href="../ports/index.html">FreeBSD Ports Collection</a>:
> The FreeBSD Ports Collection provides an easy way to compile and
> install a wide range of applications with a minimum amount of effort.
>
>Property changes on: htdocs/projects/projects.xml
>___________________________________________________________________
>Modified: svn:mime-type
>## -1 +1 ##
>-text/sgml
>\ No newline at end of property
>+text/xml
>\ No newline at end of property
>Index: htdocs/xfce/Makefile
>===================================================================
>--- htdocs/xfce/Makefile	(revision 0)
>+++ htdocs/xfce/Makefile	(working copy)
>@@ -0,0 +1,12 @@
>+# $FreeBSD$
>+
>+.if exists(../Makefile.conf)
>+.include "../Makefile.conf"
>+.endif
>+.if exists(../Makefile.inc)
>+.include "../Makefile.inc"
>+.endif
>+
>+DOCS+=  index.xml
>+
>+.include "${DOC_PREFIX}/share/mk/web.site.mk"
>Index: htdocs/xfce/Makefile.inc
>===================================================================
>--- htdocs/xfce/Makefile.inc	(revision 0)
>+++ htdocs/xfce/Makefile.inc	(working copy)
>@@ -0,0 +1,4 @@
>+# $FreeBSD$
>+
>+WEBBASE?=	/data/xfce
>+DOC_PREFIX?=	${.CURDIR}/../../../..
>Index: htdocs/xfce/dot.xinitrc.diff
>===================================================================
>--- htdocs/xfce/dot.xinitrc.diff	(revision 0)
>+++ htdocs/xfce/dot.xinitrc.diff	(working copy)
>@@ -0,0 +1,38 @@
>+--- .xinitrc.orig
>++++ .xinitrc
>+@@ -87,6 +87,17 @@
>+ # load local modmap
>+ test -r $HOME/.Xmodmap && xmodmap $HOME/.Xmodmap
>+ 
>++# Use dbus-launch if installed.
>++if test x"$DBUS_SESSION_BUS_ADDRESS" = x""; then
>++  if which dbus-launch >/dev/null 2>&1; then
>++    eval `dbus-launch --sh-syntax --exit-with-session`
>++    # some older versions of dbus don't export the var properly
>++    export DBUS_SESSION_BUS_ADDRESS
>++  else
>++    echo "Could not find dbus-launch; Xfce will not work properly" >&2
>++    fi
>++fi
>++
>+ # run xfce4-session if installed
>+ if which xfce4-session >/dev/null 2>&1; then
>+ 
>+@@ -124,17 +135,6 @@
>+ 
>+ ##################
>+ 
>+-# Use dbus-launch if installed.
>+-if test x"$DBUS_SESSION_BUS_ADDRESS" = x""; then
>+-  if which dbus-launch >/dev/null 2>&1; then
>+-    eval `dbus-launch --sh-syntax --exit-with-session`
>+-    # some older versions of dbus don't export the var properly
>+-    export DBUS_SESSION_BUS_ADDRESS
>+-  else
>+-    echo "Could not find dbus-launch; Xfce will not work properly" >&2
>+-    fi
>+-fi
>+-
>+ # this is only necessary when running w/o xfce4-session
>+ xsetroot -solid black -cursor_name watch
>+ 
>Index: htdocs/xfce/index.xml
>===================================================================
>--- htdocs/xfce/index.xml	(revision 0)
>+++ htdocs/xfce/index.xml	(working copy)
>@@ -0,0 +1,365 @@
>+<?xml version="1.0" encoding="iso-8859-1"?>
>+<!DOCTYPE html PUBLIC "-//FreeBSD//DTD XHTML 1.0 Transitional-Based Extension//EN"
>+"http://www.FreeBSD.org/XML/share/xml/xhtml10-freebsd.dtd" [
>+
>+<!ENTITY url.books.handbook "..&url.doc.base;/books/handbook">
>+<!ENTITY a.mailman.listinfo
>+"http://lists.FreeBSD.org/mailman/listinfo">
>+<!ENTITY a.xfce.url "&a.mailman.listinfo;/freebsd-xfce">
>+<!ENTITY forums.wm "forums/other-window-managers.31/">
>+<!ENTITY forums.url "https://forums.freebsd.org/&forums.wm;">
>+<!ENTITY title "The &os; Xfce Project">
>+<!ENTITY xfce.url "http://www.xfce.org/">
>+<!ENTITY gnome.developer "https://developer.gnome.org/">
>+<!ENTITY clutter.desaturate.effect "&gnome.developer;clutter/stable/ClutterDesaturateEffect.html">
>+]>
>+
>+<html xmlns="http://www.w3.org/1999/xhtml">
>+  <head>
>+    <title>&title;</title>
>+
>+    <cvs:keyword xmlns:cvs="http://www.FreeBSD.org/XML/CVS">
>+			$FreeBSD$
>+		</cvs:keyword>
>+  </head>
>+
>+  <body class="navinclude.developers">
>+    <p><a href="&xfce.url;">Xfce</a> is a complete graphical desktop
>+      environment based ont the GTK+ toolkit.  It aims to be fast,
>+      lightweight and easy-to-use.</p>
>+
>+    <p>Any questions regarding Xfce on &os; should be address to
>+      the <a href="&a.xfce.url;">freebsd-xfce</a> mailing list, or
>+      <a href="&forums.url;">&os; forums</a>
>+      (<em>Other Window Manager</em> subforum).</p>
>+
>+    <h2>Resources</h2>
>+    <ul>
>+      <li><a href="http://www.xfce.org/">Xfce project</a></li>
>+      <li><a href="../ports/xfce.html">Available ports...</a></li>
>+      <li><a href="https://wiki.freebsd.org/Xfce">The &os; Xfce
>+      wiki page</a></li>
>+    </ul>
>+
>+    <h2>Frequently Asked Questions</h2>
>+    <h3>Contents</h3>
>+    <ol>
>+      <li><a href="#q01">How is Xfce installed?</a></li>
>+      <li><a href="#q02">How is Xfce started?</a></li>
>+      <li><a href="#q03">What about localization?</a></li>
>+      <li><a href="#q04">How can unified themes be used with
>+				GTK3 and GTK2?</a></li>
>+      <li><a href="#q05">How can keyboard shortcuts be changed
>+				in GTK2 applications?</a></li>
>+      <li><a href="#q06">How can menu items be hidden?</a></li>
>+      <li><a href="#q07">How can the panel be hidden with
>+				fullscreen applications?</a></li>
>+      <li><a href="#q08">How can double title bars be removed in
>+				some applications?</a></li>
>+      <li><a href="#q09">How can shadows be removed in additional
>+				panels</a></li>
>+      <li><a href="#q10">How is windows preview displayed in
>+				TabWin widget?</a></li>
>+      <li><a href="#q11">How are elements displayed in TabWin
>+				widget?</a></li>
>+      <li><a href="#q12">How is zoom effect enabled?</a></li>
>+      <li><a href="#q13">How can we adopt the same behavior as
>+				Thunar in GtkFileChooserDialog widget?</a></li>
>+      <li><a href="#q14">How can xfdashboard be lauched at
>+				startup?</a></li>
>+      <li><a href="#q15">How can grayscale colors of quicklaunch
>+				icons be changed in xfdashboard?</a></li>
>+      <li><a href="#q16">How can PulseAudio be disabled?</a></li>
>+    </ol>
>+
>+    <h3>Full text</h3>
>+		<ol>
>+			<li>
>+				<a name="q01"></a>
>+				<h4>How is Xfce installed?</h4>
>+
>+				<p>There are two ways to install Xfce.  Using pkg(8):</p>
>+				<pre># pkg install xfce</pre>
>+
>+				<p>More information is available in the <a
>+				  href="&url.books.handbook;/pkgng-intro.html">&os;
>+				  Handbook</a>.</p>
>+
>+				<p>The other way is to use <a
>+				  href="&url.books.handbook;/ports-using.html">ports</a>:</p>
>+				<pre># cd /usr/ports/x11-wm/xfce4
>+# make clean-depends</pre>
>+			</li>
>+
>+			<li>
>+				<a name="q02"></a>
>+				<h4>How is Xfce started?</h4>
>+
>+				<p>There are several different ways to start Xfce:</p>
>+				<ul>
>+					<li>Using <tt>startx</tt> from a text console.</li>
>+					<li>Using display manager (e.g., SLiM, Xdm, ...)</li>
>+				</ul>
>+				<p>Firstly, <tt>.xinitrc</tt> file must be created.</p>
>+
>+				<p><strong>Note:</strong> <tt>x11-wm/xfce4-session</tt>
>+					provides this file.</p>
>+				<pre>% cp /usr/local/etc/xdg/xfce4/xinitrc ~/.xinitrc</pre>
>+
>+				<p>Using <tt>startx</tt> or Xdm, <tt>.xsession</tt> file is
>+					also required.</p>
>+				<pre>% ln -sf ~/.xinitrc ~/.xsession</pre>
>+
>+				<p>To use Xdm, apply the following <a
>+					href="dot.xinitrc.diff">patch</a>.  It fixes a well-known bug <a
>+					href="https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=191296">
>+					PR191296</a>.</p>
>+				<pre>% patch --posix &lt; dot.xinitrc.diff</pre>
>+			</li>
>+
>+			<li>
>+				<a name="q03"></a>
>+				<h4>What about localization?</h4>
>+
>+				<p>Xfce supports different languages (internationalization).
>+					Even if the system has already been <a
>+					href="&url.books.handbook;/l10n.html">configured for
>+					localization</a>, additional settings must be added to
>+					<tt>.xinitrc</tt>.</p>
>+
>+				<p>The variables, <tt>LANG</tt> and <tt>LC_CTYPE</tt> control
>+					locale settings.</p>
>+
>+				<p>For instance, for French users using latin-9 encoding, these
>+					environments variables will be defined like:</p>
>+				<pre>#!/bin/sh
>+
>+export LANG="fr_FR.ISO8859-15"
>+export LC_CTYPE="fr_FR.ISO8859-15"
>+[...]</pre>
>+
>+				<p>Users with no UTF-8 encoding must also define new variable
>+					<tt>G_FILENAME_ENCODING</tt> (avoid warning in some GTK
>+					applications).</p>
>+
>+				<p>Add following lines in <tt>.xinitrc</tt>.</p>
>+				<pre>[...]
>+# set $G_FILENAME_ENCODING to @locale and/or UTF-8.
>+if test "x$G_FILENAME_ENCODING" = "x"; then
>+  G_FILENAME_ENCODING="@locale,UTF-8"
>+  export G_FILENAME_ENCODING
>+fi
>+[...]</pre>
>+			</li>
>+
>+			<li>
>+				<a name="q04"></a>
>+				<h4>How can unified themes be used with GTK3 and GTK2?</h4>
>+
>+				<p>Install <tt>x11-themes/gnome-themes-standard</tt>, and change
>+					the value of <tt>/Net/ThemeName</tt> property:</p>
>+				<pre>% xfconf-query -c xsettings -p /Net/ThemeName -t string -s Adwaita</pre>
>+
>+				<p>Or use <tt>xfce4-appearance-settings</tt>.</p>
>+			</li>
>+
>+			<li>
>+				<a name="q05"></a>
>+				<h4>How can keyboard shortcuts be changed in GTK2
>+					applications?</h4>
>+
>+				<p><tt>/Gtk/CanChangeAccels</tt> must be enabled.</p>
>+
>+				<p>To check its value:</p>
>+				<pre>% xfconf-query -c xsettings -p /Gtk/CanChangeAccels</pre>
>+
>+				<p>If it is <strong>false</strong>, the value must be
>+					changed.</p>
>+				<pre>% xfconf-query -c xsettings -p /Gtk/CanChangeAccels -T</pre>
>+
>+				<p>When the item menu is active (hightlighted), keyboard
>+					shortcut can be directly changed by pressing the desired key
>+					combination.</p>
>+
>+				<p><strong>Note:</strong> This settings is deprecated since
>+					GTK >= 3.10.</p>
>+			</li>
>+
>+			<li>
>+				<a name="q06"></a>
>+				<h4>How can menu items be hidden?</h4>
>+
>+				<p>Launch <tt>xfce4-appfinder</tt> and right-click on one
>+					item in the right pane, then select
>+					<strong>Hidden</strong>.</p>
>+			</li>
>+
>+			<li>
>+				<a name="q07"></a>
>+				<h4>How can the panel be hidden with fullscreen
>+					applications?</h4>
>+
>+				<p>Sometimes when applications are in full-screen mode, panels
>+					are not hidden.  The value of <tt>autohide-behavior</tt> can
>+					be changed.</p>
>+
>+				<p>Possible values are:</p>
>+				<ul>
>+					<li>0 &rarr; never hide</li>
>+					<li>1 &rarr; intelligently autohide</li>
>+					<li>2 &rarr; autohide</li>
>+				</ul>
>+
>+				<p>For example:</p>
>+				<pre>% xfconf-query -c xfce4-panel -p /panels/panels-<em>id</em>/autohide-behavior -n -t int -s 1</pre>
>+
>+				<p>Where <em>id</em> is integer, it represents panel number.</p>
>+
>+				<p>Or go to <strong>Panel Preferences</strong>.</p>
>+			</li>
>+
>+			<li>
>+				<a name="q08"></a>
>+				<h4>How can double title bars be removed in some
>+					applications?</h4>
>+
>+				<p>They appear often with GTK3 applications, because they use
>+					a new method for decorating windows, calls
>+					<acronym title="Client-Side Decorations">CSD</acronym>.</p>
>+
>+				<p>To avoid this artifact, compositing must be enabled.</p>
>+
>+				<p>Launch <tt>xfwm4-teaks-settings</tt>, and go to the
>+					<strong>Compositor</strong> tab.</p>
>+
>+				<p>Or change the value of
>+					<tt>/general/use_compositing</tt>:</p>
>+				<pre>% xfconf-query -c xfwm4 -p /general/use_compositing -n -t bool -s true</pre>
>+			</li>
>+
>+			<li>
>+				<a name="q09"></a>
>+				<h4>How can shadows be removed in additional panels?</h4>
>+
>+				<p>With some additional panels like <tt>deskutils/cairo-dock</tt>,
>+					<tt>x11/tint</tt>, or <tt>x11/plank</tt> shadows appear.</p>
>+
>+				<p>Launch <tt>xfwm4-tweaks-settings</tt> and go to
>+					<strong>Compositor</strong> tab, uncheck <strong>Show shadows
>+					under dock windows</strong> option.</p>
>+
>+				<p>Or</p>
>+				<pre>% xfconf-query -c xfwm4 -p /general/show_dock_shadow -n -t bool -s false</pre>
>+			</li>
>+
>+			<li>
>+				<a name="q10"></a>
>+				<h4>How is windows preview displayed in TabWin widget?</h4>
>+
>+				<p>TabWin widget is little window which appears, when we
>+					toggle between open applications (Alt+Tab).</p>
>+
>+				<p>The value of <tt>/general/cycle_preview</tt> can be
>+					changed, if compositing is enabled.</p>
>+				<pre>% xfconf-query -c xfwm4 -p /general/cycle_preview -T</pre>
>+
>+				<p><strong>Note:</strong> If the value of
>+					<tt>/general/cycle_tabwin_mode</tt> is <strong>1</strong>
>+					previews are not displayed.</p>
>+			</li>
>+
>+			<li>
>+				<a name="q11"></a>
>+				<h4>How are elements displayed in TabWin widget?</h4>
>+
>+				<p>By default in TabWin widget, open applications are
>+					symbolized by previews list.</p>
>+
>+				<p>Another view is also possible (like in Xfce &lt;= 4.10).</p>
>+				<pre>% xfconf-query -c xfwm4 -p /general/cycle_tabwin_mode -n -t int -s 1</pre>
>+
>+				<p>Possible values are:</p>
>+				<ul>
>+					<li>0 &rarr; previews list</li>
>+					<li>1 &rarr; grid (icons)</li>
>+				</ul>
>+			</li>
>+
>+			<li>
>+				<a name="q12"></a>
>+				<h4>How is zoom effect enabled?</h4>
>+
>+				<p>If compositing is enabled and the value of
>+					<tt>/general/zoom_desktop</tt> is <strong>true</strong>.
>+					Zoom effect is active.</p>
>+				<pre>% xfconf-query -c xfwm4 -p /general/zoom_desktop</pre>
>+
>+				<p>Alt+Scroll-wheel to zoom in/out anywhere inside desktop.</p>
>+			</li>
>+
>+			<li>
>+				<a name="q13"></a>
>+				<h4>How can we adopt the same behavior as Thunar in
>+					GtkFileChooserDialog widget?</h4>
>+
>+				<p>By default, Thunar displays directories first, then
>+					files.  This behaviour is managed by
>+					<tt>/misc-folders-first</tt> property.</p>
>+
>+				<p>To adopt the same behavior when GTK3 applications use
>+					GtkFileChooserDialog widget, the value of
>+					<tt>sort-directories-first</tt> must be changed.</p>
>+				<pre>% gsettings set org.gtk.Settings.FileChooser sort.directories-first true</pre>
>+			</li>
>+
>+			<li>
>+				<a name="q14"></a>
>+				<h4>How can xfdashboard be launched at startup?</h4>
>+
>+				<p>Launch <tt>xfce4-session-settings</tt>, and go to
>+					<strong>Application Autostart</strong> tab.  Select
>+					<tt>xfdashboard</tt>.</p>
>+
>+				<p>To define keyboard shortcuts, launch
>+					<tt>xfce4-keyboard-settings</tt>, and go to
>+					<strong>Application Shortcuts</strong> tab.</p>
>+			</li>
>+
>+			<li>
>+				<a name="q15"></a>
>+				<h4>How can grayscale colors of quicklaunch icons be changed
>+					in xfdashboard?</h4>
>+
>+				<p>Since 0.3.2 release, a new feature was introduced, based on <a
>+					href="&clutter.desaturate.effect;">ClutterDesaturateEffect</a>.</p>
>+
>+				<p>Launch <tt>xfdashboard-settings</tt> and go to
>+					<strong>Themes</strong> tab.  Select one among list.</p>
>+
>+				<p>To display current theme:</p>
>+				<pre>% xfconf-query -c xfdashboard -p /theme</pre>
>+
>+				<p>For example, if it is <tt>xfdashboard-blue</tt>.  Copy
>+					its content into <tt>~/.themes/xfdashboard-blue/</tt>.</p>
>+				<pre>% cp -R /usr/local/share/themes/xfdashboard-blue/* ~/.themes/xfdashboard-blue/</pre>
>+				
>+				<p>Edit <tt>effects.xml</tt>, and change the value
>+					(between 0.0 and 1.0) of factor property.</p>
>+			</li>
>+
>+			<li>
>+				<a name="q16"></a>
>+				<h4>How can PulseAudio be disabled?</h4>
>+
>+				<p>In <tt>~/.config/pulse/client.conf</tt> replace these
>+					lines:</p>
>+				<pre>; autospawn = yes
>+; daemon-binary = /usr/local/bin/pulseaudio</pre>
>+
>+				<p>by</p>
>+				<pre>autospawn = no
>+daemon-binary =</pre>
>+			</li>
>+		</ol>
>+  </body>
>+</html>
>
>Property changes on: htdocs/xfce/index.xml
>___________________________________________________________________
>Added: svn:mime-type
>## -0,0 +1 ##
>+text/xml
>\ No newline at end of property

Actions: View | Diff

Attachments on bug 201870: 159212