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

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

Update to epiphany-3.26.6.
More tags.

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