'\" t
.\"     Title: DEB-GVIEW
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 22 April 2008
.\"    Manual: deb-gview manual
.\"    Source: DEB-GVIEW 0.3.7
.\"  Language: English
.\"
.TH "DEB\-GVIEW" "1" "22 April 2008" "DEB-GVIEW 0\&.3\&.7" "deb\-gview manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
deb-gview \- GNOME viewer for \&.deb package files and contents
.SH "DESCRIPTION"
.PP
\fIdeb\-gview\fR
displays Debian control information, devscript details and details of the files that would be installed (names, sizes and locations)\&. Files within the package can be viewed within the package or externally\&.
.PP
\fIdeb\-gview\fR
accepts package files on the command line to support the \*(Aqopen\*(Aq command in various file managers, one window for each package\&. Individual views can be closed independently or simultaneously using \*(AqQuit\*(Aq\&.
.PP
Packages do not need to be installed to be viewed\&. Packages do not need to be suitable for installation, e\&.g\&. a foreign architecture\&.
.PP
Package files and
\&.changes
files can be viewed from local and remote filesystems\&.
.PP
When loading
\&.changes
files,
\fIdeb\-gview\fR
will load each referenced package in a new window\&. When opening a
\&.changes
file from the
\fIdeb\-gview\fR
toolbar, the original window is not changed\&.
.PP
When opening Debian packages files from the
\fIdeb\-gview\fR
toolbar, the package data will replace the current window data\&.
.SS "Usage:"
.PP
deb\-gview [\fIOPTIONS\fR] [\fIfile\fR\&.\&.\&.]
.SS "COMMAND:"
.PP
\fBfile\fR
.RS 4
One or more Debian package files (\&.deb) to preload or a
\&.changes
file referencing various package files\&.
.sp
Individual package files or a set of packages referenced in a
\&.changes
file can be viewed from local and remote filesystems\&.
.RE
.SS "GUI Options:"
.PP
See also
gtk\-options
(7)\&.
.PP
\fB\-\-display\fR=\fIDISPLAY\fR
.RS 4
X display to use
.RE
.SS "Help Options:"
.PP
\-h, \fB\-\-help\fR
.RS 4
Show help options
.RE
.PP
\-v, \fB\-\-version\fR
.RS 4
Show version number
.RE
.SH "FILE PREVIEWS"
.PP
\fIdeb\-gview\fR
has migrated to the XDG specification for config files and uses a dot\-file in your XDG config directory (default:
~/\&.config/deb\-gview/preview) to specify which applications should be used to preview files from the package\&. You are free to edit this file, deb\-gview will not modify it, although the defaults will be replaced if the file is deleted\&.
.PP
Any previous config in
~/\&.deb\-gview/preview
will be moved into the new file but the
~/\&.deb\-gview
directory will be preserved \- feel free to delete it once any other files are moved to the new location\&.
.PP
The first matching pattern will be used, so put the most general wildcards (like *) at the end of this file\&.
.SS "GROUPS"
.PP
The first group contains two
\fIdeb\-gview\fR
default settings\&. \*(Aqterminal\*(Aq determines which application to use for viewers that need a terminal\&. You may want to change this to
\fIgnome\-terminal\fR
or
\fIkonsole\fR
from the rather limited
\fIxterm\fR
default\&. \*(Aqexecute_command\*(Aq specifies the command to pass to the terminal application to load an external command within the terminal\&. Most terminal emulators support \*(Aq\-e\*(Aq for this command\&.
.PP
Subsequent group names need to be unique but have no other meaning to
\fIdeb\-gview\fR\&.
.SS "KEYS"
.PP
\fBpattern\fR: glob\-style pattern to match the location of the file in the package (not the filesystem)\&.
.PP
\fBviewer\fR: the program to call to view the file content (which must exist in your system PATH)\&.
.PP
\fBuse_terminal\fR: whether to start the viewer in a terminal, TRUE or FALSE\&.
.PP
\fBbinary_file\fR: whether the viewer requires the content as a binary file, TRUE or FALSE\&. Typically, image previews require a binary file\&.
.PP
\fBfile_suffix\fR: if the viewer needs a specific suffix, specify it here\&. Note that
\fIdeb\-gview\fR
does not insist that the suffix of the temporary file matches the suffix of the file within the package, it is up to you to ensure that the suffix is suitable for the viewer you want to use\&. Leave blank for no suffix\&.
.SS "DEFAULT VALUES"
.PP
The defaults for file previews are:
.sp
.if n \{\
.RS 4
.\}
.nf
# Your choice of terminal application\&.
#
[deb\-gview]
terminal=xterm

[manual pages]
pattern=\&./usr/share/man/man*/*
viewer=man
use_terminal=true
binary_file=false
file_suffix=

[HTML]
pattern=*\&.html
viewer=sensible\-browser
use_terminal=false
binary_file=false
file_suffix=html

[PNG]
pattern=*\&.png
viewer=qiv
use_terminal=false
binary_file=true
file_suffix=png

[text]
pattern=*
viewer=gedit
use_terminal=false
binary_file=false
file_suffix=

.fi
.if n \{\
.RE
.\}
.SH "AUTHOR"
.PP
\fIdeb\-gview\fR
was written by Neil Williams <linux@codehelp\&.co\&.uk>\&.
.PP
This manual page was written by Neil Williams <linux@codehelp\&.co\&.uk>
.SH "REPORTING BUGS"
.PP
\fIdeb\-gview\fR
is a native Debian package and bugs should be reported using the reportbug tool\&. Reports can be found on the Debian bug tracking system for deb\-gview\&.
.PP
\fI \fR\fI\m[blue]\fBhttp://bugs\&.debian\&.org/cgi\-bin/pkgreport\&.cgi?pkg=deb\-gview\fR\m[]\&\s-2\u[1]\d\s+2\fR\fI \fR
.SH "COPYRIGHT"
.PP
This program 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 2 of the License, or (at your option) any later version\&.
.PP
This program 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\&.
.PP
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc\&., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301, USA\&.
.SH "NOTES"
.IP " 1." 4
http://bugs.debian.org/cgi-bin/pkgreport.cgi?pkg=deb-gview
.RS 4
\%http://bugs.debian.org/cgi-bin/pkgreport.cgi
.RE