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

10.0 10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 9214104 was 9214104, checked in by Pierre Labastie <pieere@…>, 19 months ago

Last fixes for GCC 10:

  • patch boost to help libreoffice
  • patch libreoffice
  • fix multiple def in rox-filer
  • fix implicit type cas in vsftpd (sed by thomas)

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

  • Property mode set to 100644
File size: 10.3 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 &lfs91_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;
117sed -i 's/gboolean/extern &amp;/' src/session.h &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>sed -i 's/gboolean/extern &amp;/' src/session.h</command>:
164 This command fixes a multiple definition flagged as an error
165 by GCC 10 and higher.
166 </para>
167
168 <para>
169 <command>ln -sv application-...</command>: These commands duplicate the
170 icons for some common mime types. Without these links
171 <application>rox-filer</application> would just display the default
172 "unknown binary blob" icon.
173 </para>
174 </sect2>
175
176 <sect2 role="configuration">
177 <title>Configuring RoxFiler</title>
178
179 <sect3><title>Configuration Information</title>
180
181 <para>
182 Most of the configuration of <application>rox-filer</application> is
183 achieved by right clicking on a <application>rox-filer</application>
184 window and choosing "Options" from the menu. It stores its settings in
185 <filename class="directory">~/.config/rox.sourceforge.net</filename>.
186 </para>
187
188 <para>
189 A <application>rox-filer</application> feature is that if there is an
190 executable file called <filename>AppRun</filename> in a directory
191 <application>rox-filer</application> will first run
192 <command>AppRun</command> before it opens the folder.
193 </para>
194
195 <para>
196 As an example of how this may be used, if you have ssh access to another
197 computer (perhaps another computer on your local network) with ssh
198 configured for passwordless logins and you have
199 <xref linkend="sshfs"/> installed you can use AppRun to mount the
200 remote computer in a local folder using <command>sshfs</command>. For
201 this example AppRun script to work the folder must have the same name as
202 the hostname of the remote computer:
203 </para>
204
205<screen role="nodump"><userinput>cat &gt; /path/to/hostname/AppRun &lt;&lt; "HERE_DOC"
206#!/bin/bash
207
208MOUNT_PATH="${0%/*}"
209HOST=${MOUNT_PATH##*/}
210export MOUNT_PATH HOST
211sshfs -o nonempty ${HOST}:/ ${MOUNT_PATH}
212rox -x ${MOUNT_PATH}
213HERE_DOC
214
215chmod 755 /path/to/hostname/AppRun</userinput></screen>
216
217 <para>
218 That works fine for mounting, but to unmount it the
219 command <command>fusermount -u ${MOUNTPOINT}</command> is ran. You could set
220 that as your default umount command in your rox preferences, but you
221 would then be unable to unmount any normal mountpoints (that need
222 umount). A script is needed that will unmount a Fuse mountpoint
223 with <command>fusermount -u ${MOUNTPOINT}</command> and everything else
224 with <command>umount</command>. As the
225 <systemitem class="username">root</systemitem> user:
226 </para>
227
228<screen role="root"><userinput>cat &gt; /usr/bin/myumount &lt;&lt; "HERE_DOC" &amp;&amp;
229#!/bin/bash
230sync
231if mount | grep "${@}" | grep -q fuse
232then fusermount -u "${@}"
233else umount "${@}"
234fi
235HERE_DOC
236
237chmod 755 /usr/bin/myumount</userinput></screen>
238
239 <para>
240 Now, to make Rox use this simple script, open a Rox window, right click
241 on it and choose Options from the menu. In the left hand list choose
242 "Action windows" and then on the right hand side, where it says
243 "Unmount command" change <command>umount</command> to
244 <command>myumount</command>.
245 </para>
246
247 <para>
248 If you use a desktop environment like
249 <application>Gnome</application> or <application>KDE</application> you
250 may like to create a <filename>rox.desktop</filename> file so that
251 <application>rox-filer</application> appears in the panel's menus. As
252 the <systemitem class="username">root</systemitem> user:
253 </para>
254
255<screen role="root"><userinput>ln -s ../rox/.DirIcon /usr/share/pixmaps/rox.png &amp;&amp;
256mkdir -p /usr/share/applications &amp;&amp;
257
258cat &gt; /usr/share/applications/rox.desktop &lt;&lt; "HERE_DOC"
259[Desktop Entry]
260Encoding=UTF-8
261Type=Application
262Name=Rox
263Comment=The Rox File Manager
264Icon=rox
265Exec=rox
266Categories=GTK;Utility;Application;System;Core;
267StartupNotify=true
268Terminal=false
269HERE_DOC</userinput></screen>
270 </sect3>
271 </sect2>
272
273 <sect2 role="content">
274 <title>Contents</title>
275
276 <segmentedlist>
277 <segtitle>Installed Programs</segtitle>
278 <segtitle>Installed Libraries</segtitle>
279 <segtitle>Installed Directories</segtitle>
280
281 <seglistitem>
282 <seg>rox</seg>
283 <seg>None</seg>
284 <seg>/usr/share/rox</seg>
285 </seglistitem>
286 </segmentedlist>
287
288 <variablelist>
289 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
290 <?dbfo list-presentation="list"?>
291 <?dbhtml list-presentation="table"?>
292
293 <varlistentry id="rox-filer-prog">
294 <term><command>rox</command></term>
295 <listitem>
296 <para>
297 is the rox file manager.
298 </para>
299 <indexterm zone="rox-filer rox-filer-prog">
300 <primary sortas="b-rox-filer">rox-filer</primary>
301 </indexterm>
302 </listitem>
303 </varlistentry>
304 </variablelist>
305 </sect2>
306</sect1>
Note: See TracBrowser for help on using the repository browser.