Package: impressive
Version: 0.10.2r-2
Severity: wishlist
Tags: patch
Hello,
I found the impressive-gettransition a little under-documented, and had to read
its code to understand how to put it dedicated markup in my LaTeX/Beamer
documents.
As it is a very useful tool, I completed its manpage. Here is the patch, I hope
it will be some help.
Regards,
--
Tanguy Ortolo
-- System Information:
Debian Release: squeeze/sid
APT prefers testing
APT policy: (990, 'testing'), (500, 'unstable'), (500, 'stable'), (1,
'experimental')
Architecture: i386 (i686)
Kernel: Linux 2.6.30-2-686 (SMP w/1 CPU core)
Locale: LANG=fr_FR.UTF-8, LC_CTYPE=fr_FR.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Versions of packages impressive depends on:
ii perl 5.10.1-8 Larry Wall's Practical Extraction
ii poppler-utils 0.12.2-2 PDF utilitites (based on libpopple
ii python 2.5.4-5 An interactive high-level object-o
ii python-imaging 1.1.7-1 Python Imaging Library
ii python-opengl 3.0.0~c1-1 Python bindings to OpenGL
ii python-pygame 1.8.1release-1.1 SDL bindings for games development
ii python-support 1.0.6 automated rebuilding support for P
ii xpdf-reader 3.02-1.4+lenny1 Portable Document Format (PDF) sui
Versions of packages impressive recommends:
ii ghostscript-x 8.70~dfsg-2 The GPL Ghostscript PostScript/PDF
ii pdftk 1.41+dfsg-4 tool for manipulating PDF document
Versions of packages impressive suggests:
ii latex-beamer 3.07-2 LaTeX class to produce presentatio
-- no debconf information
--- impressive-gettransitions.pod.old 2010-01-11 21:03:19.000000000 +0100
+++ impressive-gettransitions.pod 2010-01-11 21:35:16.000000000 +0100
@@ -2,7 +2,7 @@
=head1 NAME
-impressive-gettransitions - PDF presentation tool with eye candies
+impressive-gettransitions - Generate Impressive info scripts for LaTeX
presentations
=head1 SYNOPSIS
@@ -11,10 +11,38 @@
=head1 DESCRIPTION
A simple script to produce a .info file for use with Impressive, using
-special comments in a LaTeX file. I<FILE.tex> is a file to be parsed
+special comments in a LaTeX/Beamer file. I<FILE.tex> is a file to be parsed
into .info file. For each /fullpath/blah.tex /fullpath/blah.pdf.info
gets produced.
+=head1 SYNTAX
+
+In the LaTeX document, B<impressive-gettransitions> counts the pages to
+determine the PDF slide number of each one.
+
+The simpler page changes are automatically detected, that is:
+ \begin{frame}
+and:
+ \pause
+
+Other, more elaborated page changes must be noted with a C<%O> comment:
+ \item<1-> Foo
+ \item<2-> Bar %O
+
+The transition to apply can be specified in a C<%O> comment:
+ \begin{frame} %O SlideUp
+
+=head1 OPERATION
+
+When the .info file corresponding to the LaTeX document already exist,
+B<impressive-gettransitions> does not clear it, but only adds the transitions
+if finds to it.
+
+Thus, if you modified your document in a way that requires to completely
+replace the transitions, manually clear the I<PageProps> section of the .info
+file. This can be done by running the following B<sed> command:
+ sed -i -e "/^PageProps = {/,/^}/d" I<FILE.info>
+
=head1 SEE ALSO
impressive(1)
@@ -24,6 +52,6 @@
impressive-gettransitions (originally gettransitions) has been written
by Rob Reid.
-This manpage has been written by Yaroslav Halchenko <[email protected]>.
+This manpage has been originally written by Yaroslav Halchenko
<[email protected]>.
=cut
