source: xsoft/other/rox-filer.xml@ 2fa7a3f7

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY rox-filer-download-http
  "&sourceforge-repo;/rox/rox-filer-&rox-filer-version;.tar.bz2">
  <!ENTITY rox-filer-download-ftp  " ">
  <!ENTITY rox-filer-md5sum        "28e8494c9af783258ff86c830f8f0062">
  <!ENTITY rox-filer-size          "1.8 MB">
  <!ENTITY rox-filer-buildsize     "3.7 MB">
  <!ENTITY rox-filer-time          "0.3 SBU">
]>

<sect1 id="rox-filer" xreflabel="Rox-&rox-filer-version;">
  <?dbhtml filename="rox-filer.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date> </date>
  </sect1info>

  <title>Rox-&rox-filer-version;</title>

  <indexterm zone="rox-filer">
    <primary sortas="a-rox-filer">rox-filer</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to Rox</title>

    <para><application>Rox</application> is a fast, lightweight, gtk2 file 
    manager.</para>

    &lfs70_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Download (HTTP): <ulink url="&rox-filer-download-http;"/></para>
      </listitem>
      <listitem>
        <para>Download (FTP): <ulink url="&rox-filer-download-ftp;"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sum: &rox-filer-md5sum;</para>
      </listitem>
      <listitem>
        <para>Download size: &rox-filer-size;</para>
      </listitem>
      <listitem>
        <para>Estimated disk space required: &rox-filer-buildsize;</para>
      </listitem>
      <listitem>
        <para>Estimated build time: &rox-filer-time;</para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">rox-filer Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
    <xref linkend="libglade"/> and
    <xref linkend="shared-mime-info"/></para>

    <para condition="html" role="usernotes">User Notes:
    <ulink url="&blfs-wiki;/rox-filer"/></para>
  </sect2>

  <sect2 role="kernel" id="rox-filer-kernel">
    <title>Kernel Configuration</title>

      <para>If you want <application>Rox</application> to be able to update the
      contents of a directory when changes are made to the files by other
      applications (eg, if a script is running) you will need to enable dnotify
      support in your kernel. In <command>make menuconfig</command>:</para>

<screen><literal>Filesystems -&#45;-&gt;
  [*] Dnotify support</literal></screen>

    <para>Save the new <filename>.config</filename> and then compile the
    kernel.</para>

    <indexterm zone="rox-filer rox-filer-kernel">
      <primary sortas="d-rox-filer">rox-filer</primary>
    </indexterm>
  </sect2>

  <sect2 role="installation">
    <title>Installation of Rox</title>

    <para>Compile <application>Rox</application> with the following
    commands:</para>

<screen><userinput>cd ROX-Filer &amp;&amp;
sed -i 's:g_strdup(getenv("APP_DIR")):"/usr/share/rox":' src/main.c &amp;&amp;
mkdir build &amp;&amp;
cd build &amp;&amp;
../src/configure &amp;&amp;
make</userinput></screen>

    <para>Now install it as the <systemitem class="username">root</systemitem>
    user:</para>

<screen role="root"><userinput>mkdir /usr/share/rox &amp;&amp;
mv ../{Help,images,Messages,Options.xml,ROX,style.css,.DirIcon} /usr/share/rox &amp;&amp;
mv ../../rox.1 /usr/share/man/man1 &amp;&amp;
mv ../ROX-Filer /usr/bin/rox &amp;&amp;
chown -R root:root /usr/{bin,share}/rox &amp;&amp;
cd /usr/share/rox/ROX/MIME &amp;&amp;
ln -sv text-x-{diff,patch}.png &amp;&amp;
ln -sv application-x-font-{afm,type1}.png &amp;&amp;
ln -sv application-xml{,-dtd}.png &amp;&amp;
ln -sv application-xml{,-external-parsed-entity}.png &amp;&amp;
ln -sv application-{,rdf+}xml.png &amp;&amp;
ln -sv application-x{ml,-xbel}.png &amp;&amp;
ln -sv application-{x-shell,java}script.png &amp;&amp;
ln -sv application-x-{bzip,xz}-compressed-tar.png &amp;&amp;
ln -sv application-x-{bzip,lzma}-compressed-tar.png &amp;&amp;
ln -sv application-x-{bzip-compressed-tar,lzo}.png &amp;&amp;
ln -sv application-x-{bzip,xz}.png &amp;&amp;
ln -sv application-x-{gzip,lzma}.png &amp;&amp;
ln -sv application-{msword,rtf}.png</userinput></screen>
  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para><command>sed -i 's:g_strdup(getenv("APP_DIR")):"/usr/share/rox":'
    src/main.c</command>: This command hard codes /usr/share/rox as the
    directory for <application>Rox</application>'s private files. Without
    this sed rox needs the environment variable ${APP_DIR} to be set.</para>

    <para><command>ln -sv application-...</command>: These commands duplicate 
    the icons for some common mime types. Without these links 
    <application>Rox</application> would just display the default "unknown 
    binary blob" icon.</para>
  </sect2>

  <sect2 role="configuration">
    <title>Configuring Rox</title>

    <sect3><title>Configuration Information</title>

      <para>Most of the configuration of <application>Rox</application> is
      achieved by right clicking on a <application>Rox</application> window
      and choosing "Options" from the menu. It stores its settings in <filename
      class="directory">~/.config/rox.sourceforge.net</filename>.</para>

      <para>A <application>Rox</application> feature is that if there is an
      executable file called <filename>AppRun</filename> in a directory
      <application>Rox</application> will first run <command>AppRun</command>
      before it opens the folder.</para>

      <!-- <para>As an example of how this may be used, if you have
      <application>ssh<application> access to another computer (perhaps another
      computer on you local network) with <application>ssh</application>
      configured for passwordless logins and you have
      <ulink url="http://fuse.sourceforge.net/sshfs.html">sshfs</ulink>
      installed you can use <command>AppRun<command> to mount the remote
      computer in a local folder using <command>sshfs</command>. If the
      folder has the same name as the hostname of the remote computer:</para>

<screen><userinput>cat &gt; /path/to/hostname/AppRun &lt;&lt; "HERE_DOC"
#!/bin/bash
 
MOUNT_PATH="$(dirname ${0})"
HOST="$(basename ${MOUNT_PATH})"
echo ${HOST}:/ ${MOUNT_PATH}
sshfs -o nonempty ${HOST}:/ ${MOUNT_PATH}
rox -x ${MOUNT_PATH}
HERE_DOC
chmod 755 /path/to/hostname/AppRun</userinput></screen> -->

      <para>If you use a desktop environment like
      <application>Gnome</application> or <application>KDE</application> you may
      like to create a <filename>rox.desktop</filename> file so that
      <application>Rox</application> appears in the panel's menus. As the
      <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>ln -s ../rox/.DirIcon /usr/share/pixmaps/rox.png &amp;&amp;
cat &gt; /usr/share/applications/rox.desktop &lt;&lt; "HERE_DOC"
[Desktop Entry]
Encoding=UTF-8
Type=Application
Name=Rox
Comment=The Rox File Manager
Icon=rox
Exec=rox
Categories=GTK;Utility;Application;System;Core;
StartupNotify=true
Terminal=false
HERE_DOC</userinput></screen>
    </sect3>
  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>rox</seg>
        <seg>/usr/share/rox</seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="rox-filer-prog">
        <term><command>rox</command></term>
        <listitem>
          <para>is the rox file manager.</para>
          <indexterm zone="rox-filer rox-filer-prog">
            <primary sortas="b-rox-filer">rox-filer</primary>
          </indexterm>
        </listitem>
      </varlistentry>
    </variablelist>
  </sect2>
</sect1>