source: xsoft/other/rox-filer.xml@ fd42347a

10.0 10.1 11.0 7.10 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since fd42347a was fd42347a, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

Comment out sddm from systemd version of the book.
Finish all tags.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@17736 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 10.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY rox-filer-download-http
8 "&sourceforge-repo;/rox/rox-filer-&rox-filer-version;.tar.bz2">
9 <!ENTITY rox-filer-download-ftp " ">
10 <!ENTITY rox-filer-md5sum "0eebf05a67f7932367750ebf9faf215d">
11 <!ENTITY rox-filer-size "1.8 MB">
12 <!ENTITY rox-filer-buildsize "19 MB">
13 <!ENTITY rox-filer-time "0.3 SBU">
14]>
15
16<sect1 id="rox-filer" xreflabel="Rox-Filer-&rox-filer-version;">
17 <?dbhtml filename="rox-filer.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date> </date>
22 </sect1info>
23
24 <title>Rox-Filer-&rox-filer-version;</title>
25
26 <indexterm zone="rox-filer">
27 <primary sortas="a-rox-filer">rox-filer</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Rox-Filer</title>
32
33 <para>
34 <application>rox-filer</application> is a fast, lightweight, gtk2 file
35 manager.
36 </para>
37
38 &lfs7a_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&rox-filer-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&rox-filer-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &rox-filer-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &rox-filer-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &rox-filer-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &rox-filer-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect3">rox-filer Dependencies</bridgehead>
75
76 <bridgehead renderas="sect4">Required</bridgehead>
77 <para role="required">
78 <xref linkend="libglade"/> and
79 <xref linkend="shared-mime-info"/>
80 </para>
81
82 <para condition="html" role="usernotes">
83 User Notes: <ulink url="&blfs-wiki;/rox-filer"/>
84 </para>
85 </sect2>
86
87 <sect2 role="kernel" id="rox-filer-kernel">
88 <title>Kernel Configuration</title>
89
90 <para>
91 If you want <application>rox-filer</application> to be able to update
92 the contents of a directory when changes are made to the files by other
93 applications (eg, if a script is running) you will need to enable
94 dnotify support in your kernel. In <command>make menuconfig</command>:
95 </para>
96
97<screen><literal>File systems ---&gt;
98 [*] Dnotify support [CONFIG_DNOTIFY]</literal></screen>
99
100 <para>
101 Save the new <filename>.config</filename> and then compile the kernel.
102 </para>
103
104 <indexterm zone="rox-filer rox-filer-kernel">
105 <primary sortas="d-rox-filer">rox-filer</primary>
106 </indexterm>
107 </sect2>
108
109 <sect2 role="installation">
110 <title>Installation of Rox-Filer</title>
111
112 <para>
113 Compile <application>rox-filer</application> with the following commands:
114 </para>
115
116<screen><userinput>cd ROX-Filer &amp;&amp;
117sed -i 's:g_strdup(getenv("APP_DIR")):"/usr/share/rox":' src/main.c &amp;&amp;
118
119mkdir build &amp;&amp;
120pushd build &amp;&amp;
121 ../src/configure LIBS="-lm -ldl" &amp;&amp;
122 make &amp;&amp;
123popd</userinput></screen>
124
125 <para>
126 Now install it as the <systemitem class="username">root</systemitem> user:
127 </para>
128
129<screen role="root"><userinput>mkdir -p /usr/share/rox &amp;&amp;
130cp -av Help Messages Options.xml ROX images style.css .DirIcon /usr/share/rox &amp;&amp;
131
132cp -av ../rox.1 /usr/share/man/man1 &amp;&amp;
133cp -v ROX-Filer /usr/bin/rox &amp;&amp;
134chown -Rv root:root /usr/bin/rox /usr/share/rox &amp;&amp;
135
136cd /usr/share/rox/ROX/MIME &amp;&amp;
137ln -sv text-x-{diff,patch}.png &amp;&amp;
138ln -sv application-x-font-{afm,type1}.png &amp;&amp;
139ln -sv application-xml{,-dtd}.png &amp;&amp;
140ln -sv application-xml{,-external-parsed-entity}.png &amp;&amp;
141ln -sv application-{,rdf+}xml.png &amp;&amp;
142ln -sv application-x{ml,-xbel}.png &amp;&amp;
143ln -sv application-{x-shell,java}script.png &amp;&amp;
144ln -sv application-x-{bzip,xz}-compressed-tar.png &amp;&amp;
145ln -sv application-x-{bzip,lzma}-compressed-tar.png &amp;&amp;
146ln -sv application-x-{bzip-compressed-tar,lzo}.png &amp;&amp;
147ln -sv application-x-{bzip,xz}.png &amp;&amp;
148ln -sv application-x-{gzip,lzma}.png &amp;&amp;
149ln -sv application-{msword,rtf}.png</userinput></screen>
150 </sect2>
151
152 <sect2 role="commands">
153 <title>Command Explanations</title>
154
155 <para>
156 <command>sed -i 's:g_strdup(getenv("APP_DIR")):"/usr/share/rox":'
157 src/main.c</command>: This command hard codes /usr/share/rox as the
158 directory for <application>rox-filer</application>'s private files.
159 Without this sed rox needs the environment variable ${APP_DIR} to be set.
160 </para>
161
162 <para>
163 <command>ln -sv application-...</command>: These commands duplicate the
164 icons for some common mime types. Without these links
165 <application>rox-filer</application> would just display the default
166 "unknown binary blob" icon.
167 </para>
168 </sect2>
169
170 <sect2 role="configuration">
171 <title>Configuring RoxFiler</title>
172
173 <sect3><title>Configuration Information</title>
174
175 <para>
176 Most of the configuration of <application>rox-filer</application> is
177 achieved by right clicking on a <application>rox-filer</application>
178 window and choosing "Options" from the menu. It stores its settings in
179 <filename class="directory">~/.config/rox.sourceforge.net</filename>.
180 </para>
181
182 <para>
183 A <application>rox-filer</application> feature is that if there is an
184 executable file called <filename>AppRun</filename> in a directory
185 <application>rox-filer</application> will first run
186 <command>AppRun</command> before it opens the folder.
187 </para>
188
189 <para>
190 As an example of how this may be used, if you have ssh access to another
191 computer (perhaps another computer on you local network) with ssh
192 configured for passwordless logins and you have
193 <xref linkend="sshfs-fuse"/> installed you can use AppRun to mount the
194 remote computer in a local folder using <command>sshfs</command>. For
195 this example AppRun script to work the folder must have the same name as
196 the hostname of the remote computer:
197 </para>
198
199<screen><userinput>cat &gt; /path/to/hostname/AppRun &lt;&lt; "HERE_DOC"
200#!/bin/bash
201
202MOUNT_PATH="${0%/*}"
203HOST=${MOUNT_PATH##*/}
204export MOUNT_PATH HOST
205sshfs -o nonempty ${HOST}:/ ${MOUNT_PATH}
206rox -x ${MOUNT_PATH}
207HERE_DOC
208
209chmod 755 /path/to/hostname/AppRun</userinput></screen>
210
211 <para>
212 That works fine for mounting, but to unmount it the
213 command <command>fusermount -u ${MOUNTPOINT}</command> is ran. You could set
214 that as your default umount command in your rox preferences, but you
215 would then be unable to unmount any normal mountpoints (that need
216 umount). A script is needed that will unmount a Fuse mountpoint
217 with <command>fusermount -u ${MOUNTPOINT}</command> and everything else
218 with <command>umount</command>. As the
219 <systemitem class="username">root</systemitem> user:
220 </para>
221
222<screen role="root"><userinput>cat &gt; /usr/bin/myumount &lt;&lt; "HERE_DOC" &amp;&amp;
223#!/bin/bash
224sync
225if mount | grep "${@}" | grep -q fuse
226then fusermount -u "${@}"
227else umount "${@}"
228fi
229HERE_DOC
230
231chmod 755 /usr/bin/myumount</userinput></screen>
232
233 <para>
234 Now, to make Rox use this simple script, open a Rox window, right click
235 on it and choose Options from the menu. In the left hand list choose
236 "Action windows" and then on the right hand side, where it says
237 "Unmount command" change <command>umount</command> to
238 <command>myumount</command>.
239 </para>
240
241 <para>
242 If you use a desktop environment like
243 <application>Gnome</application> or <application>KDE</application> you
244 may like to create a <filename>rox.desktop</filename> file so that
245 <application>rox-filer</application> appears in the panel's menus. As
246 the <systemitem class="username">root</systemitem> user:
247 </para>
248
249<screen role="root"><userinput>ln -s ../rox/.DirIcon /usr/share/pixmaps/rox.png &amp;&amp;
250mkdir -p /usr/share/applications &amp;&amp;
251
252cat &gt; /usr/share/applications/rox.desktop &lt;&lt; "HERE_DOC"
253[Desktop Entry]
254Encoding=UTF-8
255Type=Application
256Name=Rox
257Comment=The Rox File Manager
258Icon=rox
259Exec=rox
260Categories=GTK;Utility;Application;System;Core;
261StartupNotify=true
262Terminal=false
263HERE_DOC</userinput></screen>
264 </sect3>
265 </sect2>
266
267 <sect2 role="content">
268 <title>Contents</title>
269
270 <segmentedlist>
271 <segtitle>Installed Programs</segtitle>
272 <segtitle>Installed Libraries</segtitle>
273 <segtitle>Installed Directories</segtitle>
274
275 <seglistitem>
276 <seg>rox</seg>
277 <seg>None</seg>
278 <seg>/usr/share/rox</seg>
279 </seglistitem>
280 </segmentedlist>
281
282 <variablelist>
283 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
284 <?dbfo list-presentation="list"?>
285 <?dbhtml list-presentation="table"?>
286
287 <varlistentry id="rox-filer-prog">
288 <term><command>rox</command></term>
289 <listitem>
290 <para>
291 is the rox file manager.
292 </para>
293 <indexterm zone="rox-filer rox-filer-prog">
294 <primary sortas="b-rox-filer">rox-filer</primary>
295 </indexterm>
296 </listitem>
297 </varlistentry>
298 </variablelist>
299 </sect2>
300</sect1>
Note: See TracBrowser for help on using the repository browser.