Page MenuHomeFreeBSD

Add Xfce FAQ in htdocs/ directory

Authored by olivierd on Dec 13 2014, 4:01 PM.


Group Reviewers

This patch add Xfce specific FAQ in order to help users. It was an open task in the latest status report.

In "Resources" section I didn't mention Porter's handbook (section regarding Xfce is outdated), but an update is planned for the next stable release (4.12), after switch to USES= xfce, a draft can be found at D677 (I'm waiting update of multimedia/gstreamer1).

In x11-wm/xfce4 meta port, gdm will be replaced by x11/slim soon.
It's result of GNOME3 import, gdm requires x11/gnome-shell, and especially KMS drivers (PR195325).
SLiM works out of box, Xdm needs patch (explained in question #2). I'm also working on LightDM but I've encountered problem with authentication and I prefer to focus on sysutils/xfce4-power-manager update (with support of brightness through acpi_video).

Question #3 explained how to configure Xfce for our favorite locales.

Question #5 explained howto launch xfdashboard (imported recently).

Question #7 is necessary for new feature, zooming in x11-wm/xfce4-wm (4.11.x and higher)

Question #8 fixes PR 165685.

Question #9 will replace patch in x11-wm/xfce4-wm (PR 194135) and in upstream repository there're fixes for Qt and GTK3 applications.

Diff Detail

Lint Skipped
Unit Tests Skipped

Event Timeline

olivierd retitled this revision from to Add Xfce FAQ in htdocs/ directory.
olivierd updated this object.
olivierd edited the test plan for this revision. (Show Details)
olivierd added reviewers: Doc Committers, xfce.

There are whitespace issues, most of which might not matter with HTML. Normally we would not have whitespace before or after commands. For example,


% xfconf-query -c xfwm4 -p /general/use_compositing -T


would be

<pre>% xfconf-query -c xfwm4 -p /general/use_compositing -T</pre>

to avoid the blank space that appears before and after the command.


These questions are not really sentences. This one could be reworded as "How is Xfce installed?" The next ones:
How is Xfce Started?
What about localization?
How can unified themes be used with GTK3 and GTK2?
How can xfdashboard be launched at startup?
How can keyboard shortcuts be changed for programs like Thunar and xfce4-terminal?
How is compositing enabled?
How can menu items be hidden?
How can the panel be hidden with fullscreen applications?
How can PulseAudio be disabled?


Typo: s/wiht/with/


<strong> is probably not needed.


No comma needed.

More comments. Other than these, the only thing I see is the indent value. Our (FreeBSD doc) standard is two spaces per level, with multiples of 8 replaced with tabs. Sorry if these seems picky.

Thank you for your work with Xfce!

60 ↗(On Diff #2756)

Either "to use the pkg(8) utility" or just "to use pkg(8):".

98 ↗(On Diff #2756)

Please avoid using "you" and "your". Instead:

<p>To use Xdm, apply this <a

99 ↗(On Diff #2756)

Please avoid contractions:

It is a well-known bug (<a

(Should this be "It fixes a well-known bug"?)

112 ↗(On Diff #2756)

Please avoid using "you":

Even if the system has already been <a href="../doc/en_US.ISO8859-1/books/handbook/l10n.html">configure​d for localization</a>, additional localization settings must be added to <tt>.xinitrc</tt> file.</p>

121 ↗(On Diff #2756)

"that" is not needed, just "defined like:"

130 ↗(On Diff #2756)

No comma after encoding, and "define a new variable,".

152 ↗(On Diff #2756)

the value of the

169 ↗(On Diff #2756)

Try to avoid asides:

Or make sure the <tt>autostart/</tt> directory exists, and copy the <tt>xfdashboard-autostart.desktop</tt> file into it.

174 ↗(On Diff #2756)

To avoid "you":

Keyboard shortcuts can now be defined.

194 ↗(On Diff #2756)

When the item menu is active (highlighted), keyboard shortcuts can be directly defined by passing the mouse over it.

203 ↗(On Diff #2756)

the <strong>Compositor</strong>

205 ↗(On Diff #2756)

the value

218 ↗(On Diff #2756)

No need for the aside:

and right-click on one item in the right pane, then select...

226 ↗(On Diff #2756)

Sometimes when applications are in full-screen mode, panels are

227 ↗(On Diff #2756)

Avoid "you":

The value of <tt>disable-struts</tt> can be changed.

238 ↗(On Diff #2756)

Either "the file" or just remove "file"

In <tt>~/.config/pulse/client.conf</tt>, replace these lines:

I agree with Warren's comments here, the rest looks fine.

43 ↗(On Diff #2756)

themes instead of 'thems'.

  • Fix indentation (follow style guide), and sentences
  • Add and rewrite entries

Some new entries will be available with the latest release 4.12 (planned for the end of Frebruary).

In resource section, I did not mention Porter's Handbook, but patch [1] is also available.


Add new question, in order to adopt same behaviour between Thunar and GtkFileChooserDialog widget (usually with GTK3 applications).

Fix also ambiguity, because compositing is enabled by default with Xfce 4.12

Some suggestions...

61 ↗(On Diff #4294)

I'd use "How can we adopt the same behavior as ...".

282 ↗(On Diff #4294)

Add the "the" here as well, and also use behavior (without u) for consistency. ;-)

285 ↗(On Diff #4294)

I think it sounds better to use:
By default, Thunar displays ...

289 ↗(On Diff #4294)

"the" same ...

Add comments from Benedict Reuschling, thanks!

bcr added a reviewer: bcr.

Looks good to me. Thanks for working on it!

This revision is now accepted and ready to land.Mar 20 2015, 6:41 PM
olivierd edited edge metadata.

Fix sentences (spelling and rewrite).

This revision now requires review to proceed.Apr 1 2015, 7:42 PM
222 ↗(On Diff #4579)

s/new/a new/

olivierd edited edge metadata.

Add an indefinite article (line 222), comment from Warren.

4 ↗(On Diff #4591)

Sorry, I didn't see this before: should that be "called"?

New update:

  • Fix indentation and spelling
  • Add 2 spaces between each sentence
  • Add 2 new questions (#09 and #15)
  • Re-use 'os' and 'url.doc.base' entities

I think FAQ is now complete. Power-manager is also planned, but I prefer to write specific page, because there're changes with sysutils/polkit >= 0.106 (I submitted PR in order to update sysutils/polkit).

I've found some language nits and provided suggestions on fixing them.

31 ↗(On Diff #7290)

address -> addressed

134 ↗(On Diff #7290)

environments -> environment

180 ↗(On Diff #7290)

hightlighted -> highlighted

184 ↗(On Diff #7290)

settings -> setting (only one)

5 ↗(On Diff #7290)

Duplicating several existing entities here seems like it could cause problems in the future when the originals change. It should be possible to include the existing URL entities. (I can make suggestions on that later.)

10 ↗(On Diff #7290)

These two forum entities are only used once in the text and might as well be a literal link.

11 ↗(On Diff #7290)

This is only used once, so does not seem to need the overhead of making it an entity.

12 ↗(On Diff #7290)

If possible, add to existing url entities and import them. If not, at least use the same naming conventions, for url.xfce.

13 ↗(On Diff #7290)

These two Gnome entities are only used once in the text. Might as well be a literal link.

Hmmm ... this review has been open for a loooong time. Is it deprecated or should this be updated to reflect review comments?

Hmmm ... this review has been open for a loooong time. Is it deprecated or should this be updated to reflect review comments?

Just waiting for a minor update, I think.

Huh ... I saw this review and noted that its still open. Is this still under evaluation?

This revision is now accepted and ready to land.Sep 27 2017, 6:51 PM

bump. @olivierd Do you intend to commit this or do you need a doc committer to finish this off?