Package: apvlv
Version: 0.0.8.1-1
Severity: wishlist
Tags: patch

The English in the manpage isn't always correct and it is formatted in a
(IMHO) unusual way, leading to suboptimal output when viewing it on a
small terminal (like "MANWIDTH=80 man apvlv").

I rewrote the manual with the -mdoc macros and tried to fix some weird
english sentences and add some more explanations where neccessary.

I hope this doesn't break any developer workflow (since it seems to me
that the manual was created from apvlv's Startup.pdf) ;-)


-- System Information:
Debian Release: squeeze/sid
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: i386 (i686)

Kernel: Linux 2.6.31 (SMP w/2 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages apvlv depends on:
ii  libatk1.0-0                   1.28.0-1   The ATK accessibility toolkit
ii  libc6                         2.10.2-2   GNU C Library: Shared libraries
ii  libcairo2                     1.8.8-2    The Cairo 2D vector graphics libra
ii  libfontconfig1                2.6.0-4.2  generic font configuration library
ii  libfreetype6                  2.3.11-1   FreeType 2 font engine, shared lib
ii  libgcc1                       1:4.4.2-6  GCC support library
ii  libglib2.0-0                  2.22.3-1   The GLib library of C routines
ii  libgtk2.0-0                   2.18.5-1   The GTK+ graphical user interface 
ii  libpango1.0-0                 1.26.2-1   Layout and rendering of internatio
ii  libpoppler-glib4              0.12.2-2   PDF rendering library (GLib-based 
ii  libstdc++6                    4.4.2-6    The GNU Standard C++ Library v3

apvlv recommends no packages.

apvlv suggests no packages.

-- no debconf information
..Dd December 24, 2009
..Dt apvlv 1
..Os
..Sh NAME
..Nm apvlv
..Nd PDF viewer with vim-like behaviour
..Sh SYNOPSIS
..Nm
..Op options
..Op file
..Sh DESCRIPTION
apvlv is a PDF viewer, which behaves like vim.
..Sh OPTIONS
..Bl -tag -width "v"
..It Fl c Ar file
Load configuration from
..Ar file
instead of the default
..Pa ~/.apvlvrc
..It Fl h
Show help message and exit
..It Fl v
Show version and exit
..El
..Sh COMMANDS
The following command keys can be used inside apvlv.
Some of them may be prefixed by a number (as in pressing "13G"),
this is indicated by a
..Ar count
in their description.  Unless noted otherwise, the default value for the
number is 1.
..Bl -tag -width "indent"
..It o
Display file chooser to open a PDF file
..It O
Select a directory to display
..It R
Reload the current file
..It r
Rotate the document clockwise by 90 degrees
..It G
Show page number
..Ar count
..It gt
Show next tab
..It gT
Show previous tab
..It PageDown, C-f
Go forward
..Ar count
pages
..It PageUp, C-b
Go backward
..Ar count
pages
..It C-d
Go forward
..Ar count
half pages
..It C-u
Go backward
..Ar count
half pages
..It H
Scroll to page head
..It M
Scroll to page middle
..It L
Scroll to page bottom
..It C-p, Up, k
Scroll up
..Ar count
units
..It C-n, Down, h
Scroll down
..Ar count
units
..It Backspace, Left, h
Scroll left
..Ar count
units
..It Space, Right, l
Scroll right
..Ar count
units
..It / Ar string
Search forwards for
..Ar string
..It ? Ar string
Search backwards for
..Ar string
..It f
Toggle between fullscreen and window mode
..It zi
Zoom in
..It zo
Zoom out
..It zw
Zoom to fit window width
..It zh
Zoom to fit window height
..It m Ar char
Mark the current position to
..Ar char ,
so that it can be recalled by pressing
..Ar char
..It q
Close the current window
..El
..Sh SETTINGS
These can be set in ~/.apvlvrc with
..Qq set Ar setting Op = Ar value .
..Bl -tag -width "indent"
..It fullscreen = yes/no
Enable/Disable fullscreen
..It width = Ar int
Default window width
..It height = Ar int
Default window height
..It defaultdir = Ar path
Default directory for the open dialogue
..It zoom = Ar mode
Set default zoom level
..Bl -tag -width "indent"
..It normal
The application sets the default zoom value
..It fitwidth
Fit pages to window width
..It fitheight
Fit pages to window height
..It Ar float
1.0 for 100%, 2.0 for 200%, etc.
..El
..It content = yes/no
Show content view first
..It continuous = yes/no
Show PDF pages continuously or not.
..It continuouspad = Ar int
Padding betwen pages for continuous = yes
..It autoscrollpage = yes/no
Enable/Disable scrolling the pages when hitting a page tail/head
..It noinfo = yes/no
Disable/Enable the usage of ~/.apvlvinfo
..It pdfcache = Ar int
Set pdf cache size
..It [no]cache
Disable/Enable cache
..El
..Sh PROMPT
Like the COMMANDS, but prefixed with a colon:
..Bl -tag -width "indent"
..It :h[elp]
Display the help document
..It :h[elp] info
Display the help document (section "introduction")
..It :h[elp] command
Display the help document (section "command")
..It :h[elp] setting
Display the help document (section "setting")
..It :h[elp] prompt
Display the help document (section "prompt")
..It :q[uit]
Close the current window
..It :o[pen] Ar file
Open
..Ar file
..It :doc Ar file
Load
..Ar file
into the current window
..It :TOtext Op Ar file
Translate
..Ar file
(or the current page) to a text file
..It :pr[int]
Print the current document
..It :tabnew
Create a new tab
..It :sp
Horizontally split the current window
..It :vsp
Vertically split the current window
..It :fp, :forwardpage Op Ar int
Go forward
..Ar int
pages (1 by default)
..It :bp, :prewardpage Op Ar int
Go backward
..Ar int
pages (1 by default)
..It :g, :goto Ar int
Go to page
..Ar int
..It :z[oom] Ar mode
Set zoom to
..Ar mode
(see "set zoom" in SETTINGS)
..It : Ns Ar int
Go to page
..Ar int
..El
..Sh AUTHORS
apvlv was written by Alf <naihe2...@gmail.com>.
..Pp
This manual page was originally written by Stefan Ritter <x...@thehappy.de>
for the Debian project (but may be used by others).

Reply via email to