Added section "Additional features" to README.md

This commit is contained in:
Bert 2011-09-08 16:02:46 +02:00
parent fdbc5cf76b
commit 348707a366

View file

@ -8,7 +8,7 @@ Its code base should be kept small and clean to make it easy for you to dig
into it and customize it for your needs. into it and customize it for your needs.
Installation Installation
------------ ============
sxiv is built using the commands: sxiv is built using the commands:
$ make $ make
@ -21,13 +21,40 @@ of the executable will be "/usr/local/bin/sxiv".
You can install it into a directory of your choice by changing the second You can install it into a directory of your choice by changing the second
command to: command to:
# PREFIX="/your/dir" make install # make PREFIX="/your/dir" install
All build-time specific settings can be found in the file "config.h". Please All build-time specific settings can be found in the file "config.h". Please
check and change them, so that they fit your needs. check and change them, so that they fit your needs.
Additional features
-------------------
The XFLAGS and XLIBS macros/environment variables control which additional
features (i.e. non-default compile-time features) should be enabled and
included during compilation.
The following table lists the available additional features--the column
*Requires* indicates, which libraries need to be installed for a feature; the
columns *XFLAGS* and *XLIBS* show, what needs to be added to these environment
variables to enable the corresponding feature:
Feature | Requires | XFLAGS | XLIBS
----------------------------------+----------+----------------+--------
GIF support: Load all frames and | giflib | -DGIF_SUPPORT | -lgif
play animations of GIF files | | |
----------------------------------+----------+----------------+--------
EXIF support: auto-orientate JPEG | libexif | -DEXIF_SUPPORT | -lexif
files according to their EXIF tag | | |
For instance, to enable GIF support, the giflib library needs to be installed
on your system and you need to execute the following shell commands before
running make:
$ export XFLAGS=-DGIF_SUPPORT
$ export XLIBS=-lgif
Usage Usage
----- =====
sxiv has two modes of operation: image and thumbnail mode. The default is image sxiv has two modes of operation: image and thumbnail mode. The default is image
mode, in which only the current image is shown. In thumbnail mode a grid of mode, in which only the current image is shown. In thumbnail mode a grid of
small previews is displayed, making it easy to choose an image to open. small previews is displayed, making it easy to choose an image to open.