.TH MComix 1 "September 2011"

.SH NAME
.B MComix
\- GTK Comic Book Viewer

.SH SYNOPSIS
.B mcomix
.RI [ OPTION... "] [" PATH... ]

.SH DESCRIPTION
.B MComix
is an user-friendly, customizable image viewer. It is specifically designed to
handle comic books, but also serves as a generic viewer. It reads images in
ZIP, RAR, 7Z, LHA or tar archives (also GZIP or BZIP2 compressed) as well as
plain image files.

.SH OPTIONS
.TP
.BR \-h , " \-\-help"
Display the help text and exit.
.TP
.BR \-s , " \-\-slideshow"
Start the application in slideshow mode.
.TP
.BR \-l , " \-\-library"
Show the library on startup.
.TP
.BR \-v , " \-\-version"
Show the version number and exit.
.PP
.B Viewing modes
.TP
.BR \-f , " \-\-fullscreen"
Start the application in fullscreen mode.
.TP
.BR \-m , " \-\-manga"
Start the application in manga mode.
.TP
.BR \-d , " \-\-double\-page"
Start the application in double page mode.
.PP
.B Zoom modes
.TP
.BR \-b , " \-\-zoom\-best"
Start the application with zoom set to best fit mode.
.TP
.BR \-w , " \-\-zoom\-width"
Start the application with zoom set to fit width.
.TP
.BR \-h , " \-\-zoom\-height"
Start the application with zoom set to fit height.
.PP
The zoom modes are mutually exclusive, and if more than one is specified,
the first will be used.

.SH ARGUMENTS
.TP
.I PATH
The path to one or more files or directories to be opened.

.SH DEPENDENCIES
.SS Required:
.B Python
2.5 or later (3.0 and later is not supported).
.PP
.B PyGTK
2.14 or later.
.PP
.B PIL
(Python Imaging Library) 1.1.5 or later.
.PP
.BR Distribute " or " Setuptools .
Distribute supersedes Setuptools on most distributions.
.SS Recommended:
.BR unrar " or " rar
to extract RAR archives.
.PP
.B p7zip
to extract 7Z archives.
.PP
.B lha
to extract LHA archives.
.PP
.B pysqlite
(if not already built into Python).

.SH BUGS
.PD 0
Please report any bugs to the MComix bug tracker at
.PP
.I http://sourceforge.net/projects/mcomix

.SH CONTACT
.PD 0
The MComix home page is
.PP
.I http://mcomix.sourceforge.net