Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  PP2LATEX (1)

.ds Aq ’


pp2latex - PerlPoint to LaTeX converter



This man page describes $Revision: 1.14 $ from PerlPoint::Converters Package 1.0205


  pp2latex --help
  pp2latex [@options_file] [options] slide_text


pp2latex creates a LaTeX file from a PerlPoint input file.

SYNTAX of PerlPoint Files

For a detailed description of the PerlPoint language please refer to the excellent POD documentation of the <B>PerlPoint::ParserB> Module by Jochen Stenzel. There you will find everything you ever wanted to know about PerlPoint ;-)


--section-sequence=chapter This option may (and should) be specified more than once. For each level of headline a corresponding LaTeX section can be specified: The following sequence of options yields the assignment shown below:


 =Healine Level 0             --->  \section{Headline Level 0}
 ==Healine Level 1            --->  \subsection{Headline Level 1}
 ===Healine Level 2           --->  \subsubsection{Headline Level 2}
 ====Healine Level 3          --->  \paragraph{Headline Level 3}
 =====Healine Level 4, 5, ... --->  \textbf{Headline Level 4, 5, ...}

<B>Note:B> --section-sequence=chapter can only be use if the document class is report or book.

--filter=regexp This specifies a regular expression regexp which should match all allowed languages for EMBEDed code. The expression is evaluated caseinsensitively.

Example: --filter=perl|latex

--prolog=filename Specifies a file which must contain the LaTeX Declarations for the document. \documentclass and \begin{document} must be defined there.
--activeContents PerlPoint sources can embed Perl code which is evaluated while the source is parsed. For reasons of security this feature is deactivated by default. Set this option to active it. You can use --safeOpcode to fine tune which operations shall be permitted.
--double_lines This option has the effect that all horizontal Lines in Tables are doubled.
--cache parsing of one and the same document several times can be accelerated by activating the PerlPoint parser cache by this option. The performance boost depends on your document structure.

Cache files are written besides the source and named .<source file>.ppcache.

It can be useful to (temporarily) deactivate the cache to get correct line numbers in parser error messages (currently numbers cannot always reported correctly with activated cache because of a special perl behaviour).

--cacheCleanup PerlPoint parser cache files grow (with every modified version of a source parsed) because they store expressions for every parsed variant of a paragraph. This is usually uncritical but you may wish to clean up the cache occasionally. Use this option to perform the task (or remove the cache file manually).
-nocopyright suppresses the copyright message;
-noinfo supresses runtime informations;
--nowarn supresses warnings;
--quiet a shortcut for --nocopyright --noinfo --nowarn: all non critical runtime messages are suppressed;
--safeOpcode <opcode> If active contents is enabled (--activeContents), Perl code embedded into the translated PerlPoint sources will be evaluated. To keep security this is done via an object of class <B>SafeB> which restricts code to permitted operations. By this option you can declare which opcode (or opcode tag) is permitted. Please see the <B>SafeB> and <B>OpcodeB> manual pages for further details. (These modules come with perl.)

This option can be used multiply.

You may want to store these options in default option files, see below for details.

For the examples used in ppdoc.pp you should use

 --safeOpcode=:filesys_open --safeOpcode=:still_to_be_decided --safeOpcode=:browse

--set <flag> This option allows you to pass certain settings - of your choice - to active contents (like conditions) where it can be accessed via the $PerlPoint hash reference. For example, your PerlPoint code could contain a condition like

  ? $PerlPoint->{userSettings}{special}

  Special part.

  ? 1

. The special part enclosed by the two conditions would then be processed only if you call pp2html with

  --set special

- and if active contents was enabled by -active, of course.

This option can be used multiply.

--trace [<level>] activates traces of the specified level. You may use the environment variable SCRIPTDEBUG alternatively (but an option overwrites environment settings). The following levels are defined (use the numeric values) - if a description sounds cryptic to you, just ignore the setting:
--help Output of usage.
--version Output of version information.


Configuration file $HOME/.pp2latex


The following environment variables have influence on the program:
SCRIPTDEBUG may be set to a numeric value to activate certain trace levels. You can use option -trace alternatively (note that a used option overwrites an environment setting). The several levels are described with this option.




Lorenz Domke (, 2001. All rights reserved.
Search for    or go to Top of page |  Section 1 |  Main Index

perl v5.20.3 PP2LATEX (1) 2016-03-17

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.