gqviewarc 0.1 - an archive handler for GQview

Copyright (C) 2008  Kenny Wai-ip Lam
waiiplam@yahoo.com.hk

gqviewarc is an LD_PRELOAD module that makes applications, GQview in
particular, treat archives as directories.


Installation
------------

Run "make" to compile the module.

Copy "gqviewarc.so" to the directory of your choice (e.g.,
"/usr/local/lib/").


Usage
-----

Set the LD_PRELOAD environment variable to the path to "gqviewarc.so"
before running the application that needs transparent archive read access.
For example:

	LD_PRELOAD=/usr/local/lib/gqviewarc.so gqview


Description
-----------

This module invokes external de-archivers, namely, "unzip" and "unrar", to
extract data from archives. You may change their behavior by setting
relevant environment variables.

From the view of an application:

  All archives with one of the recognized extensions (e.g., .zip, .rar)
  appear as directories.

  All files in an archive appears to be in the same directory, regardless
  of the hierarchy in the archive. The path of archived files, including
  directory separator '/', becomes part of file names.

  A number followed by a tab character is inserted at the beginning the
  name of an archived file. The number is used to group files by their
  directory locations in the archive. It prevents GQview from mixing files
  from different directories in performing sorting.


Copyright
---------

gqviewarc is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

gqviewarc is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with gqviewarc.  If not, see <http://www.gnu.org/licenses/>.

