mpm(6) [plan9 man page]

MPM(6)								   Games Manual 							    MPM(6)

NAME

       mpm, mspe - macros for page makeup

SYNOPSIS

       troff -mpm file ...

       troff -mspe file ...

DESCRIPTION

       These  troff(1)	macros, largely compatible with ms(6), make better pages.  They silently invoke and provide information to a postprocessor
       that moves floating figures, avoids widows, and justifies pages vertically by stretching vertical spaces that result from  .PP,	.LP,  .IP,
       .QP, .SH, .NH, .DS/.DE, .EQ/.EN, .TS/.TE, .PS/.PE, .P1/.P2, and .QS/.QE.  The packages support different styles:

       -mpm   generic

       -mspe  Software--Practice and Experience

       The following macros are different from or not part of -ms.  Values denoted n have default value 1v.

       .BP    Begin a new page.
       .FL    Flush: force out previous keeps.
       .FC    Finish a two-column region and start a new one.
       .KF m  Floating keep, with preferred center at vertical position m.  Special values (default) and are permitted.
       .NE n  Start new page if remaining vertical space on this page is less than n.
       .P1    Begin a program display (constant width font).
       .P2    End a program display.
       .P3    Insert optional break point in program display.
       .SP n exactly
       .SP n  Insert vertical space of height n, stretchable unless exactly is present.
       .Tm text
	      Place page number and text on the standard error output.
       .X text
	      Present text to the hidden page-makeup program as part of a device-dependent output sequence x X text.  Equivalent to X'text'.

       Useful number registers:
       HM     Header margin; default 1 inch.
       FM     Footer margin; default 1 inch.
       FO     Footer position; default 10 inches.
       %#     Page number of current page.
       dP,dV  Shrinkage of point size and vertical spacing for .P1, in points.

       Useful strings:
       %e,%o  Even and odd page title commands, as .tl ''''.

FILES

       /sys/lib/tmac/tmac.pm
       /$cputype/bin/aux/pm

SOURCE

       /sys/src/cmd/pm

SEE ALSO

       ms(6), troff(1)
       B. W. Kernighan and C. J. Van Wyk, ``The -mpm Macro Package'', Unix Research System Programmer's Manual, Tenth Edition, Volume 2.

BUGS

       These features of -ms are missing:

	      Document styles other than the default .RP.
	      Space between front matter and first paragraph.  Recover it with .SP 2.
	      Separating rule above footnotes.
	      Keeps assigned to a separate page.
	      Pages with more than two columns.

       Troff option -o doesn't work with -mpm because only the postprocessor knows the page numbers.

																	    MPM(6)

Check Out this Related Man Page

apache_mod_perl-108~358::mod_perl-2.0.7::docs::api::ApacUser:Contributed Perl Dapache_mod_perl-108~358::mod_perl-2.0.7::docs::api::Apache2::MPM(3)

NAME

       Apache2::MPM - Perl API for accessing Apache MPM information

Synopsis
	 use Apache2::MPM ();

	 # check whether Apache MPM is threaded
	 if (Apache2::MPM->is_threaded) { do_something() }

	 # which mpm is used
	 my $mpm = lc Apache2::MPM->show;

	 # query mpm properties
	 use Apache2::Const -compile => qw(:mpmq);
	 if (Apache2::MPM->query(Apache2::Const::MPMQ_STATIC)) { ... }

Description
       "Apache2::MPM" provides the Perl API for accessing Apache MPM information.

API

       "Apache2::MPM" provides the following functions and/or methods:

   "query"
       Query various attributes of the MPM

	 my $query = Apache2::MPM->query($const);

       obj: $class ( "Apache2::MPM class" )
	   the class name

       arg1: $const ( "Apache2::Const :mpmq group constant" )
	   The MPM attribute to query.

       ret: $query ( boolean )
	   the result of the query

       since: 2.0.00

       For example to test whether the mpm is static:

	 use Apache2::Const -compile => qw(MPMQ_STATIC);
	 if (Apache2::MPM->query(Apache2::Const::MPMQ_STATIC)) { ... }

   "is_threaded"
       Check whether the running Apache MPM is threaded.

	 my $is_threaded = Apache2::MPM->is_threaded;

       obj: $class ( "Apache2::MPM class" )
	   the class name

       ret: $is_threaded ( boolean )
	   threaded or not

       since: 2.0.00

       Note that this functionality is just a shortcut for:

	 use Apache2::Const -compile => qw(MPMQ_IS_THREADED);
	 my $is_threaded = Apache2::MPM->query(Apache2::Const::MPMQ_IS_THREADED);

   "show"
       What mpm is used

	 my $mpm = Apache2::MPM->show();

       obj: $class ( "Apache2::MPM class" )
	   the class name

       ret: $mpm ( string )
	   the name of the MPM. e.g., "Prefork".

       since: 2.0.00

See Also
       mod_perl 2.0 documentation.

Copyright
       mod_perl 2.0 and its core modules are copyrighted under The Apache Software License, Version 2.0.

Authors
       The mod_perl development team and numerous contributors.

perl v5.16.2							    2011-02-07 apache_mod_perl-108~358::mod_perl-2.0.7::docs::api::Apache2::MPM(3)

Linux and UNIX Man Pages

mpm(6) [plan9 man page]

Check Out this Related Man Page