[Pkg-ocaml-maint-commits] r942 - packages/advi/branches/split/debian/patches
Helge Kreutzmann
kreutzm-guest@costa.debian.org
Mon, 31 Jan 2005 09:39:03 +0100
Author: kreutzm-guest
Date: 2005-01-31 09:39:02 +0100 (Mon, 31 Jan 2005)
New Revision: 942
Added:
packages/advi/branches/split/debian/patches/man_update.dpatch
Log:
Update man page
*Many of the issues of my bug report
*Include mention of zadvi (Debian specific)
Added: packages/advi/branches/split/debian/patches/man_update.dpatch
===================================================================
--- packages/advi/branches/split/debian/patches/man_update.dpatch 2005-01-31 08:37:46 UTC (rev 941)
+++ packages/advi/branches/split/debian/patches/man_update.dpatch 2005-01-31 08:39:02 UTC (rev 942)
@@ -0,0 +1,422 @@
+#! /bin/sh -e
+## man_update.dpatch by <kreutzm@itp.uni-hannover.de>
+##
+## All lines beginning with `## DP:' are a description of the patch.
+## DP: numerous improvements for the man page (though more are possible)
+## DP: including a Debian-specific reference to zadvi
+
+if [ $# -lt 1 ]; then
+ echo "`basename $0`: script expects -patch|-unpatch as argument" >&2
+ exit 1
+fi
+
+[ -f debian/patches/00patch-opts ] && . debian/patches/00patch-opts
+patch_opts="${patch_opts:--f --no-backup-if-mismatch} ${2:+-d $2}"
+
+case "$1" in
+ -patch) patch -p1 ${patch_opts} < $0;;
+ -unpatch) patch -R -p1 ${patch_opts} < $0;;
+ *)
+ echo "`basename $0`: script expects -patch|-unpatch as argument" >&2
+ exit 1;;
+esac
+
+exit 0
+
+@DPATCH@
+--- advi-1.6.0.orig/doc_src/advi.man 2004-10-02 23:10:57.000000000 +0200
++++ advi-1.6.0/doc_src/advi.man 2005-01-29 17:07:54.542277016 +0100
+@@ -2,7 +2,7 @@
+ .\" First parameter, NAME, should be all caps
+ .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+ .\" other parameters are allowed: see man(7), man(1)
+-.TH ADVI 1 "October 02, 2004"
++.TH ADVI 1 "January 29, 2005"
+ .\" Please adjust this date whenever revising the manpage.
+ .\"
+ .\" Some roff macros, for reference:
+@@ -15,11 +15,11 @@
+ .\" .br insert line break
+ .\" .sp <n> insert n+1 empty lines
+ .\" for manpage-specific macros, see man(7)
++.mso www.tmac
+ .SH NAME
+ .B advi
+ \-\- a DVI previewer and presenter
+-.UR http://caml.inria.fr/advi/
+-(http://caml.inria.fr/advi/)
++.\" .URL http://caml.inria.fr/advi/ http://caml.inria.fr/advi/
+ .UE
+ with some eye candy effects for presentation.
+
+@@ -28,13 +28,18 @@
+ .SH SYNOPSIS
+ .B advi
+ .RI [ options ] " dvifile " ...
++
++.B zadvi
++.RI [ options ] " dvifile.gz " ...
+ .SH DESCRIPTION
+ The
+ .B advi
+ program is a viewer for DVI files that also recognizes a new class of
+ special's targeted to presentations via laptop computers: various
+ visual effects can easily be incorporated to the presentation, via a
+-companion advi.sty LaTeX package.
++companion
++.I advi.sty
++LaTeX package.
+
+ .P
+ .B advi
+@@ -47,6 +52,11 @@
+ leading for example to live and/or interactive demos during the
+ presentation.
+
++.P
++Compressed dvi-files (suffix .gz and .bz2) are supported via the
++.B zadvi
++command.
++
+ .SH CURRENTLY SUPPORTED FEATURES:
+
+ \- Encapsulated Postscript File inclusion (using graphics package)
+@@ -55,9 +65,13 @@
+
+ \- Embedded applications for interactive demonstration
+
+-\- Pictures visualization via gpic specials
++\- Pictures visualization via
++.BR gpic (1)
++specials
++
++\- Display of inlined Postscript using
++.BR gs (1)
+
+-\- Display of inlined Postscript using gs
+
+ \- Font antialiasing that takes background colors into account
+
+@@ -96,7 +110,9 @@
+
+ Notice that
+ .B advi
+-needs the `kpsewhich' tool in order to find and
++needs the
++.BR kpsewhich (1)
++tool in order to find and
+ recompile PK fonts. (This program is part of the `kpathsea' library
+ provided by many TeX distributions.)
+
+@@ -113,7 +129,9 @@
+ Ignore background for antialiasing
+ .TP
+ .B \-\-showps
+-Print a copy of Postscript sent to gs to stdout
++Print a copy of Postscript sent to
++.BR gs (1)
++to stdout
+ .TP
+ .B \-\-verbose\-image\-access
+ Change the cursor while loading images
+@@ -138,7 +156,8 @@
+ Command to call the browser (default netscape\-communicator)
+ .TP
+ .B \-cache\-dir STRING
+-Set the cache directory (default /tmp)
++Set the cache directory (default
++.IR /tmp )
+ .TP
+ .B \-click\-turn
+ Turn pages with mouse clicks (see the doc)
+@@ -147,7 +166,7 @@
+ Crop the window to the best size (default)
+ .TP
+ .B \-disable\-image\-anti\-aliasing
+-Disable eps inclusion anti\-aliasing
++Disable EPS inclusion anti\-aliasing
+ .TP
+ .B \-edit
+ Start in edit mode
+@@ -162,7 +181,8 @@
+ Set default foreground color (Named or RGB)
+ .TP
+ .B \-film\-viewer STRING
+-Command to display film files (default mplayer)
++Command to display film files (default
++.BR mplayer (1))
+ .TP
+ .B \-fullwidth
+ Adjust size to width
+@@ -182,7 +202,7 @@
+ .B \-html STRING
+ Make
+ .B advi
+-start at html reference of name STRING
++start at HTML reference of name STRING
+ .TP
+ .B \-image\-viewer STRING
+ Command to display image files (default xv)
+@@ -216,7 +236,11 @@
+ .TP
+ .B \-options\-file STRING
+ Load this file when parsing this option to set up options
+-(to override the options of the default ~/.advirc or ~/.advi/advirc init file).
++(to override the options of the default
++.I ~/.advirc
++or
++.I ~/.advi/advirc
++init file)
+ .TP
+ .B \-page INT
+ Make
+@@ -232,7 +256,7 @@
+ Set the name of the file where
+ .B advi
+ could write the current page number
+-(default is file 'advi\_page\_number' in the cache directory).
++(default is file 'advi\_page\_number' in the cache directory)
+ .TP
+ .B \-pager STRING
+ Command to call the pager (default xterm \-e less)
+@@ -241,19 +265,21 @@
+ Cancel all Active\-DVI effects
+ .TP
+ .B \-pdf\-viewer STRING
+-Command to view PDF files (default xpdf)
++Command to view PDF files (default
++.BR xpdf (1))
+ .TP
+ .B \-ps\-viewer STRING
+-Command to view PS files (default gv)
++Command to view PS files (default
++.BR gv (1))
+ .TP
+ .B \-pstricks
+ Show moveto
+ .TP
+ .B \-resolution REAL
+-Dpi resolution of the screen (min 72.27)))
++DPI resolution of the screen (min. 72.27)))
+ .TP
+ .B \-rv
+-Reverse video is simulated by swapping the foreground and background colors.
++Reverse video is simulated by swapping the foreground and background colors
+ .TP
+ .B \-safer
+ Safer mode: external applications are never launched
+@@ -277,10 +303,10 @@
+ Set the number of thumbname per line and column to INT
+ .TP
+ .B \-thumbnails
+-Create thumbnails for your slides and write them into cachedir.
++Create thumbnails for your slides and write them into cachedir
+ .TP
+ .B \-thumbnails\-size STRING
+-Fix thumbnails size (default 24x32).
++Fix thumbnails size (default 24x32)
+ .TP
+ .B \-v
+ Print the current Active\-DVI version
+@@ -302,7 +328,7 @@
+
+ .P
+ Geometry GEOM is specified in pixels, using the standard format
+-for specifying geometries (i.e: "WIDTHxHEIGHT[+XOFFSET+YOFFSET]").
++for specifying geometries (i.e., "WIDTHxHEIGHT[+XOFFSET+YOFFSET]").
+
+ Dimensions (for options `-hmargin' and `-vmargin') are specified as
+ numbers optionally followed by two letters representing units.
+@@ -326,41 +352,41 @@
+ Advi recognizes the following keystrokes when typed in its window.
+ Some of them may optionally be preceded by a number, called ARG below,
+ whose interpretation is keystroke dependant. If ARG is unset, its
+-value is 1, unless specified otherwise.
++value is 1.
+
+ Advi maintains an history of previously visited pages organized as a stack.
+-Additionnally, the history contains mark pages which are stronger than
++Additionally, the history contains mark pages which are stronger than
+ unmarked pages.
+
+ .RS 2
+ .TP 8
+ .B ?
+-Quick info and key bindings help
++Quick info and key bindings help.
+
+ .TP
+ .B q
+-Quits the program
++Quits the program.
+
+ .TP
+ .B ^X\-^C (Control\-X Control\-C)
+-Quits the program
++Quits the program.
+
+ .TP
+ .B ^X\-^F (Control\-X Control\-F)
+-Turn to full screen mode
++Turn to full screen mode.
+
+ .TP
+ .B ^F (Control\-F)
+-Toggle to switch from full screen to normal mode and converse
++Toggle to switch from full screen to normal mode and converse.
+
+ .TP
+ .B ^<button> (Control + left mouse button)
+-Allow moving the page into the window (useful in full screen mode)
++Allow moving the page into the window (useful in full screen mode).
+
+ .TP
+ .B return
+ If ARG is non zero, push the current page on the history stack, and move
+-forward Arg physical pages.
++forward ARG physical pages.
+
+ .TP
+ .B n
+@@ -381,7 +407,7 @@
+ .TP
+ .B <backspace>
+ Move ARG pages backward according to the history.
+-The history stack is poped, accordingly.
++The history stack is popped, accordingly.
+
+ .TP
+ .B <escape>
+@@ -409,11 +435,11 @@
+
+ .TP
+ .B <
+-Scale the resolution by 1/scalestep (default 1/sqrt (sqrt (sqrt 2.0)))
++Scale the resolution by 1/scalestep (default 1/sqrt (sqrt (sqrt 2.0))).
+
+ .TP
+ .B >
+-Scale the resolution by scalestep (default sqrt (sqrt (sqrt 2.0)))
++Scale the resolution by scalestep (default sqrt (sqrt (sqrt 2.0))).
+
+ .TP
+ .B f
+@@ -436,34 +462,34 @@
+
+ .TP
+ .B C
+-Erase the image cache
++Erase the image cache.
+
+ .TP
+ .B T
+-Process thumbnails (graphical table of contents for the show)
++Process thumbnails (graphical table of contents for the show).
+
+ .TP
+ .B t
+ Display thumbnails if processed or floating table of contents, or do
+-nothing
++nothing.
+
+ .TP
+ .B ^X\-l (Control\-X l)
+-Toggle on or off the laser pointer
++Toggle on or off the laser pointer.
+
+ .TP
+ .B s
+ Turn on the write scratching mode (to interactively write on the
+ slide). When in scratching mode press
+ .B ?
+-to get help
++to get help.
+
+ .TP
+ .B S
+ Turn on the draw scratching mode (to interactively draw on the
+ slide). When in scratching mode press
+ .B ?
+-to get help
++to get help.
+
+ .TP
+ .B ^X\-^S (Control\-X Control\-S)
+@@ -489,19 +515,24 @@
+
+ .SH EYE CANDY MACROS
+
+-Using the LaTeX style advi.sty provided with the package, you can
+-embed some Active dvi specials into your TeX documents.
++Using the LaTeX style
++.I advi.sty
++provided with the package, you can
++embed some Active\-DVI specials into your TeX documents.
+ .B Advi
+ interprets those specials to provide some eye candy features for your
+-presentation. For the casual user, the advi\-slides.sty package gives
+-a truely simple way to write a show for
++presentation. For the casual user, the
++.I advi\-slides.sty
++package gives
++a truly simple way to write a show for
+ .B advi
+ (see in the examples directory or the documentation inside the
+-advi\-slides.sty file for more information).
++.I advi\-slides.sty
++file for more information).
+
+ .TP
+ .B \eadviwait
+-ActiveDvi stops rendering at the point of the document and wait a user key
++Active\-DVI stops rendering at the point of the document and wait a user key
+ stroke.
+
+ .TP
+@@ -529,7 +560,11 @@
+
+ .RE
+ The directory examples contains a lot of presentations.
+-Please look also at test/demo*.{tex|dvi} and test/macros.{tex|dvi} for
++Please look also at
++.I test/demo*.{tex|dvi}
++and
++.I test/macros.{tex|dvi}
++for
+ a rather comprehensive demonstration of Active\-DVI capabilities.
+
+ .SH COPYRIGHT
+@@ -537,22 +572,25 @@
+ .SH SEE ALSO
+ .BR latex (1),
+ .BR kpsewhich (1),
+-.BR The Active-DVI user's manual
+-.UR http://caml.inria.fr/advi/manual.dvi
+-and the FAQ
+-.UR http://caml.inria.fr/advi/faq.html
++the Active\-DVI user's
++.URL http://caml.inria.fr/advi/manual.dvi manual ,
++and the
++.URL http://caml.inria.fr/advi/faq.html FAQ
+ .SH AUTHORS
+ Jun Furuse <Jun.Furuse@inria.fr>
+ Pierre Weis <Pierre.Weis@inria.fr>
+-Didier Remy <Didier.Remy@inria.fr> inlined Postcript, hyperlinks
++Didier Remy <Didier.Remy@inria.fr> inlined Postscript, hyperlinks
+ Roberto Di Cosmo <dicosmo@pauillac.inria.fr>
+-Xavier Leroy <Xavier.Leroy@inria.fr> gpic specials
++Xavier Leroy <Xavier.Leroy@inria.fr>
++.BR gpic (1)
++specials
+ Didier Le Botlan <Didier.Le_Botlan@inria.fr>
+ Alan Schmitt <Alan.Schmitt@inria.fr>
+ Alexandre Miquel <Alexandre.Miquel@inria.fr>
+ .P
+ The original version of this manual page was written by Sven LUTHER
+-<luther@debian.org>, for the Debian GNU/Linux system port of advi
++<luther@debian.org>, for the Debian GNU/Linux system port of
++.B advi
+ version 1.2. This page has then been enhanced and updated for later
+-versions of Active-DVI, and finally rewritten for version 1.6 by
++versions of Active\-DVI, and finally rewritten for version 1.6 by
+ Pierre Weis.
Property changes on: packages/advi/branches/split/debian/patches/man_update.dpatch
___________________________________________________________________
Name: svn:executable
+ *