1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
|
.\"
.\"
.\" Copyright 2013 Benjamin Eltzner
.\" Copyright 2012 Adam Reichold
.\" Copyright 2012 Michał Trybus
.\"
.\" This file is part of qpdfview.
.\"
.\" qpdfview 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.
.\"
.\" qpdfview 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 qpdfview. If not, see <http://www.gnu.org/licenses/>.
.\"
.\" This file is additionally licensed under the Creative Commons Attribution-ShareAlike 3.0 Unported (CC-BY-SA) license. The full text of the license can be found at https://creativecommons.org/licenses/by-sa/3.0/legalcode
.\"
.\"
.TH QPDFVIEW 1 "July 2012"
.SH NAME
qpdfview \- tabbed PDF viewer
.SH SYNOPSIS
.B qpdfview
.I [options] [file[#page]] [file[#src:name:line:column]] ...
.SH DESCRIPTION
.B qpdfview
is a simple viewer for document files in the portable document format (PDF). It uses the Poppler library for rendering and the Qt toolkit for its interface.
.SH OPTIONS
.IP \-\-unique
If an instance of qpdfview is started with this option, any files that are opened using this option afterwards, are opened as tabs in the original window. If a file is already opened in a tab of the original window, it is merely reloaded.
.IP "\-\-instance name"
Used in combination with the "\-\-unique" option. Sets the name of the opened instance. This allows one to run multiple instances and remotely open and refresh tabs in any of them by passing the instance name.
.IP [file[#page]]
.I file
specifies the file to open. The optional parameter
.I page
opens the file at the given page. Multiple files will be opened in separate tabs.
.IP [file[#src:name:line:column]]
Forward search using SyncTeX is performed using the optional parameters
.I name
which is the name of the source file,
.I line
which is the line number in the source file and
.I column
which is the column number in the source file where the number 0 matches all lines respectively columns.
.SH CONFIGURATION FILE
qpdfview uses a configuration file usually located at
.RS
"~/.config/qpdfview/qpdfview.conf".
.RE
The icon theme used by Qt can be changed by setting the key "iconTheme" in the section "mainWindow". The application-wide Qt style sheet can be changed by setting the key "styleSheet" in the section "mainWindow".
.SH EXAMPLES
.RS
The command
.RE
.B qpdfview foo.pdf#3 bar.pdf
.RS
opens "foo.pdf" in the first tab displaying the third page of the document and "bar.pdf" in the second tab displaying the beginning of the document.
Subsequent execution of the commands
.RE
.B qpdfview \-\-unique foo.pdf bar.pdf
.RS
and
.RE
.B qpdfview \-\-unique foo.pdf#5
.RS
opens "foo.pdf" and "bar.pdf", then reloads "foo.pdf" and displays its fifth page.
Subsequent execution of the commands
.RE
.B qpdfview \-\-unique foo.pdf
.RS
and
.RE
.B qpdfview bar.pdf
.RS
and
.RE
.B qpdfview \-\-unique foo1.pdf bar1.pdf
.RS
opens "foo.pdf" in the first window, "bar.pdf" in a second window and then "foo1.pdf" and "bar1.pdf" in additional tabs in the first window.
Subsequent execution of the commands
.RE
.B qpdfview \-\-unique \-\-instance a foo1.pdf bar1.pdf
.RS
and
.RE
.B qpdfview \-\-unique \-\-instance b foo2.pdf bar2.pdf
.RS
and
.RE
.B qpdfview \-\-unique foo3.pdf bar3.pdf
.RS
and
.RE
.B qpdfview \-\-unique \-\-instance a foo1.pdf#4 bar4.pdf
.RS
opens "foo1.pdf" and "bar1.pdf" in the first window, "foo2.pdf" and "bar2.pdf" in the second window, "foo2.pdf" and "bar2.pdf" in the third window and then reloads "foo1.pdf" and displays its fourth page and opens "bar4.pdf" in an additional tab in the first window.
The command
.RE
.B qpdfview \-\-unique foobar.pdf#src:foobar.tex:42:0
.RS
opens or refreshes "foobar.pdf" jumping to and highlighting the position that corresponds to line 42 of the source file "foobar.tex".
.SH BUGS
If you find a bug, please report it at
.RS
"https://launchpad.net/qpdfview".
.RE
|