From 6276360f47edd71de736e153f5dcc82b6d60b3db Mon Sep 17 00:00:00 2001 From: Lu Xu Date: Fri, 24 Jun 2022 13:57:13 +0800 Subject: [PATCH] fbpdf.1: update and improve the manual page --- fbpdf.1 | 215 +++++++++++++++++++++++++++++++++++++++++++--------------------- 1 file changed, 146 insertions(+), 69 deletions(-) rewrite fbpdf.1 (96%) diff --git a/fbpdf.1 b/fbpdf.1 dissimilarity index 96% index 994a649..729d005 100644 --- a/fbpdf.1 +++ b/fbpdf.1 @@ -1,69 +1,146 @@ -.TH "fbpdf" 1 "2018\-01\-05" "" "General Commands Manual" -.SH NAME -.B fbpdf -\- view PDF files on the frame buffer -.SH SYNOPSIS -.PP -.B fbpdf -[\fB\-r\fR \fIrotation\fR] -[\fB\-z\fR \fIzoom_x10\fR] -[\fB\-p\fR \fIpage_number\fR] -.I file.pdf -.SH OPTIONS -.PP -\fB\-r\fR \fIrotation\fR Set rotation to \fIrotation\fR degrees. -.br -\fB\-z\fR \fIzoom_x10\fR Set zoom to ten times \fIzoom_x10\fR percent. -.br -\fB\-p\fR \fIpage_number\fR Open \fIfile.pdf\fR to page \fIpage_number\fR. -.SH DESCRIPTION -.PP -.B fbpdf -is a framebuffer PDF and djvu viewer. The following table lists the -key-bindings available in \fBfbpdf\fR. Most of them accept a numerical prefix; -for instance, \fB^F\fR tells \fBfbpdf\fR to show the next page while \fB5^F\fR -tells it to show the fifth next page. -.TS -aB aB -_ s -a a . -Key Action -^F/J next page -^B/K previous page -G go to page (the last page if no prefix) -o set page number (for 'G' command only) -O set page number and go to current page -z zoom; prefix multiplied by 10 (i.e. '15z' = 150%) -r set rotation in degrees -i print some information -I invert colors -q quit -^[/escape clear the numerical prefix -mx mark page as 'x' (or any other letter) -\&'x jump to the page marked as 'x' -\&`x jump to the page and position marked as 'x' -j scroll down -k scroll up -h scroll left -l scroll right -[ align with the left edge of the page -] align with the right edge of the page -{ align with the leftmost character on the page -} align with the rightmost character on the page -H show page top -M centre the page vertically -L show page bottom -C centre the page horizontally -^D/space page down -^U/^H/backspace page up -^L redraw -e reload current file -f zoom to fit page height -w zoom to fit page width -W zoom to fit page contents horizontally -Z set the default zoom level for 'z' command -d sleep one second before the next command -.TE -.SH "EXIT STATUS" -.PP -\fBfbpdf\fR returns 1 in case of error, 0 otherwise. +.TH FBPDF 1 "JUNE 2022" +.SH NAME +fbpdf \- framebuffer PDF viewer +.SH SYNOPSIS +.B fbpdf +.RB [ -r +.IR rotation ] +.RB [ -z +.IR zoom_x10 ] +.RB [ -p +.IR page_number ] +.IR filename +.SH DESCRIPTION +.P +.B fbpdf +is a small framebuffer PDF viewer which uses the MuPDF backend. +.P +.B fbpdf2 +is similar to fbpdf, but uses poppler as backend. +.P +.B fbdjvu +is a djvu viewer. +.P +The options documented here are available in all three programs. +.SH OPTIONS +.TP +.BI "\-r " rotation +Rotate specified number of degrees +.TP +.BI "\-z " zoom_x10 +Zoom by a multiple of ten +.TP +.BI "\-p " page_number +Go to specified page +.SH KEY BINDINGS +Most of the key bindings accept a numerical prefix. +For instance, '^F' tells fbpdf to show the next page +while '5^F' tells it to show the fifth next page. + +.TP +.B h +Scroll left +.TP +.B j +Scroll down +.TP +.B k +Scroll up +.TP +.B l +Scroll right +.TP +.B ^d | +Page down +.TP +.B ^u | +Page up +.TP +.B ^f | J +Go to next page +.TP +.B ^b | K +Go to previous page +.TP +.B H +Show page top +.TP +.B M +Center the page vertically +.TP +.B L +Show page bottom +.TP +.B C +Center the page horizontally +.TP +.B f +Fit page height +.TP +.B w +Fit page width +.TP +.B W +Fit page contents horizontally +.TP +.B [ +Align with the left edge of the page +.TP +.B ] +Align with the right edge of the page +.TP +.B { +Align with the leftmost character on the page +.TP +.B } +Align with the rightmost character on the page +.TP +.B G +Go to specified page, default to the last page if no prefix +.TP +.B o +Set page number (for 'G' command only) +.TP +.B O +Set page number and go to current page +.TP +.B r +Rotate specified number of degrees +.TP +.B z +Zoom by a multiple of ten in percentage (i.e. '15z' = 150%) +.TP +.B Z +Set the default zoom level for 'z' command +.TP +.B m +Mark page as , could be any letter +.TP +.B ' +Jump to the page marked as +.TP +.B ` +Jump to the page and position marked as +.TP +.B ^[ / +Clear numerical prefix +.TP +.B d +Sleep specified seconds before the next command +.TP +.B I +Invert colors +.TP +.B i +Display file information +.TP +.B e +Reload file +.TP +.B ^l +Redraw screen +.TP +.B q +Quit program +.SH AUTHOR +Written by fbpdf contributors. -- 2.11.4.GIT