From 7e2916f0ea5365454fed9b662217fefccdcddb84 Mon Sep 17 00:00:00 2001 From: Sergio Durigan Junior Date: Fri, 28 Aug 2015 21:47:26 -0400 Subject: [PATCH] Rewrite manpage The old manpage was too simple and did not cover many of the options supported by Midori on the command line. Fixed that by rewriting it almost completely, including many missing options, updating dates and author, and improving the formatting. --- debian/midori.1 | 106 +++++++++++++++++++++++++++++++++++++++++------- 1 file changed, 91 insertions(+), 15 deletions(-) diff --git a/debian/midori.1 b/debian/midori.1 index 915cd6ee..36bff8c8 100644 --- a/debian/midori.1 +++ b/debian/midori.1 @@ -1,46 +1,122 @@ -.TH MIDORI "1" "September 2007" "midori 0.0.6" "User commands" +.TH MIDORI "1" "September 2015" "midori 0.5.11" "User commands" .SH NAME -midori \- fast and lightweight web browser +midori \- fast and lightweight Web Browser. .SH SYNOPSIS + .PP \fBmidori\fR [OPTION...] [URL] .SH DESCRIPTION -\fBmidori\fR is a lightweight web browser. +\fBmidori\fR is a lightweight Web Browser. .SH OPTIONS .IP .SS "Application Options:" + .TP -\fB\-v\fR, \fB\-\-version\fR -Display program version +\fB\-a\fR \fIADDRESS\fR\fR, \fB\-\-app\fR=\fIADDRESS\fR + +Run \fIADDRESS\fR as a web application. + +.TP +\fB\-c\fR \fIFOLDER\fR, \fB\-\-config\fR=\fIFOLDER\fR + +Use \fIFOLDER\fR as configuration folder. + +.TP +\fB\-p\fR, \fB\-\-private\fR + +Run Midori in private mode. No changes are saved in this mode. + +.TP +\fB\-\-plain\fR + +Plain GTK+ window with WebKit, akin to GtkLauncher. + +.TP +\fB\-d\fR, \fB\-\-diagnostic\-dialog\fR + +Show a diagnostic dialog. + +.TP +\fB\-g\fR, \fB\-\-debug\fR + +Run Midori within gdb and save a backtrace on crash. Useful when +reporting bugs against the package. + +.TP +\fB\-r\fR \fIFILE\fR, \fB\-\-run\fR=\fIFILE\fR + +Run \fIFILE\fR as a JavaScript. + +.TP +\fB\-s\fR \fIURI\fR, \fB\-\-snapshot\fR=\fIURI\fR + +Take a snapshot of \fIURI\fR. + +.TP +\fB\-e\fR \fICOMMAND\fR, \fB\-\-execute\fR=\fICOMMAND\fR + +Run the specified \fICOMMAND\fR. To obtain a list of supported +commands, see \fB\-\-help\-execute\fR below. + +.TP +\fB\-\-help\-execute\fR + +Print a list of available commands supported by \fB\-\-execute\fR. + +.TP +\fB\-V\fR, \fB\-\-version\fR + +Print the version of Midori. + +.TP +\fB\-b\fR \fIPATTERN\fR, \fB\-\-block\-uris\fR=\fIPATTERN\fR + +Block URIs according to the regular expression specified in +\fIPATTERN\fR. + +.TP +\fB\-i\fR \fISECONDS\fR, \fB\-\-inactivity\-reset\fR=\fISECONDS\fR + +Reset Midori after \fISECONDS\fR seconds of inactivity. + .TP \fB\-\-display\fR=\fIDISPLAY\fR -X display to use -.SS "Help Options:" +X display to use. + +.SS Help Options: + .TP \-?, \fB\-\-help\fR -Show help options + +Show help options described above. + .TP \fB\-\-help\-all\fR -Show all help options + +Show all help options. + .TP \fB\-\-help\-gtk\fR -Show GTK+ Options + +Show GTK+ Options. .SH REPORTING BUGS -Please report comments, suggestions and bugs to christian@twotoasts.de -.PP -Check for new versions at: http://software.twotoasts.de +Please report bugs using the Debian BTS . .SH AUTHOR \fBMidori\fR is copyright (C) 2007 Christian Dywan. + .PP -This manual page was written by Emanuele Rocca for -the Debian GNU/Linux system (but may be used by others). +This manual page was completely rewritten by Sergio Durigan Junior +, based on the previous version by Emanuele +Rocca . It was written for the Debian GNU/Linux +system but may be used by others. + .PP Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or any later version published