home *** CD-ROM | disk | FTP | other *** search
- <HTML>
-
- <HEAD>
- <TITLE>Perl Package Manager</TITLE>
- <META name="GENERATOR" charset="iso-8859-1" content="Microsoft FrontPage 4.0">
- <META name="ProgId" content="FrontPage.Editor.Document">
- <LINK rel="STYLESHEET" href="../Active.css" type="text/css">
- </HEAD>
-
- <BODY bgcolor="#ffffff">
-
- <TABLE border="0" cellpadding="0" cellspacing="0" width="100%">
- <TR>
- <TD class="block" valign="MIDDLE" width="100%" bgcolor="#cccccc"><STRONG>
- <P class="block"> PPM</P>
- </STRONG></TD>
- </TR>
- </TABLE>
- <UL>
- <LI><A href="#what_is_ppm">What is the Perl Package Manager (PPM)?</A>
- <LI><A href="#how_do_i_install_ppm">How do I install PPM?</A>
- <LI><A href="#running_ppm">How do I run PPM?</A>
- <LI><A href="#using_ppm">How do I use PPM?</A>
- </UL>
- <HR>
- <H1><A name="what_is_ppm">What is the Perl Package Manager (PPM)?</A></H1>
- <P>The Perl Package Manager (PPM) provides a command line interface for managing Perl modules and
- extensions (packages). PPM allows you to access package repositories, install and remove packages
- from your system, and update packages you previously installed using PPM with the latest versions.</P>
- <HR>
- <H1><A name="how_do_i_install_ppm">How do I install PPM?</A></H1>
- <P>PPM is installed when you install ActivePerl.</P>
- <HR>
- <H1><A name="running_ppm">How do I run PPM?</A></H1>
- <P>Before you run PPM, you should be connected to the Internet. If your Internet connection is via a
- firewall or proxy, you should set the environment variable 'HTTP_proxy' to the name of this proxy
- server. If your proxy server requires a username and password, the environment variables 'HTTP_proxy_user'
- and 'HTTP_proxy_pass' should be set to these values.</P>
- <P>PPM can then be run by typing 'ppm' in a command prompt window.</P>
- <HR>
- <H1><A name="using_ppm">How do I use PPM?</A></H1>
- <P>Quick start: at the PPM command prompt, type '<CODE>search</CODE>' to get a listing of all
- available packages, then type '<CODE>install <packagename></CODE>', where <CODE><packagename></CODE>
- is the name of a package displayed by the '<CODE>search</CODE>' command. To list the packages you
- have previously installed using PPM, use the '<CODE>query</CODE>' command.</P>
- <P>If you find the listing of packages scrolls by too quickly, you may want to use the command '<CODE>set
- more <number></CODE>' to pause the listing after <number> packages have been displayed.
- Use the '<CODE>set save</CODE>' command to save this configuration for future PPM sessions.</P>
- <P>By default, PPM will use the ActiveState package repository, but this too can be configured using
- the '<CODE>set</CODE>' command.</P>
- <P>Below is a listing of key PPM commands (you can type '<CODE>help <command></CODE>' at the
- PPM prompt for usage details for a particular <command>). Items in [brackets] are optional.</P>
- <TABLE cellpadding="5">
- <TR>
- <TD bgcolor="#454545"><FONT color="#FFFFFF"><B>Command</B></FONT></TD>
- <TD bgcolor="#454545"><FONT color="#FFFFFF"><B>Function</B></FONT></TD>
- </TR>
- <TR>
- <TD bgcolor="#D4F4A0"><B>genconfig</B></TD>
- <TD bgcolor="#E5E4F0">prints a minimal PPM configuration file to STDOUT</TD>
- </TR>
- <TR>
- <TD bgcolor="#D4F4A0"><B>help [command]</B></TD>
- <TD bgcolor="#E5E4F0">lists available commands, or help on 'command'.</TD>
- </TR>
- <TR>
- <TD bgcolor="#D4F4A0"><B>info [package1...]</B></TD>
- <TD bgcolor="#E5E4F0">prints a summary of installed packages.</TD>
- </TR>
- <TR>
- <TD bgcolor="#D4F4A0"><B>install package1 [package2...]</B></TD>
- <TD bgcolor="#E5E4F0">installs specified packages.</TD>
- <TR>
- <TD bgcolor="#D4F4A0"><B>quit</B></TD>
- <TD bgcolor="#E5E4F0">exits the program.</TD>
- <TR>
- <TD bgcolor="#D4F4A0"><B>query [pattern]</B></TD>
- <TD bgcolor="#E5E4F0">lists installed packages, or packages containing <CODE>pattern</CODE>.</TD>
- </TR>
- <TR>
- <TD bgcolor="#D4F4A0"><B>query /abstract [pattern]</B></TD>
- <TD bgcolor="#E5E4F0">lists descriptions of installed packages, or package descriptions
- containing <CODE>pattern</CODE>.</TD>
- </TR>
- <TR>
- <TD bgcolor="#D4F4A0"><B>remove package1 [package2...]</B></TD>
- <TD bgcolor="#E5E4F0">removes the specified packages from the system.</TD>
- </TR>
- <TR>
- <TD bgcolor="#D4F4A0"><B>search [pattern]</B></TD>
- <TD bgcolor="#E5E4F0">lists available packages, or packages containing <CODE>pattern</CODE>.</TD>
- </TR>
- <TR>
- <TD bgcolor="#D4F4A0"><B>search /abstract [pattern]</B></TD>
- <TD bgcolor="#E5E4F0">lists descriptions of available packages, or package descriptions
- containing <CODE>pattern</CODE>.</TD>
- </TR>
- <TR>
- <TD bgcolor="#D4F4A0"><B>set</B></TD>
- <TD bgcolor="#E5E4F0">set/display current options.</TD>
- </TR>
- <TR>
- <TD bgcolor="#D4F4A0"><B>set save</B></TD>
- <TD bgcolor="#E5E4F0">save current options.</TD>
- </TR>
- <TR>
- <TD bgcolor="#D4F4A0"><B>summary [package1...]</B></TD>
- <TD bgcolor="#E5E4F0">prints a summary of available packages.</TD>
- </TR>
- <TR>
- <TD bgcolor="#D4F4A0"><B>verify [package1...]</B></TD>
- <TD bgcolor="#E5E4F0">verifies currently installed packages are up to date.</TD>
- </TR>
- <TR>
- <TD bgcolor="#D4F4A0"><B>verify /upgrade [package1...]</B></TD>
- <TD bgcolor="#E5E4F0">installs available package upgrades.</TD>
- </TABLE>
- <P> </P>
- <TABLE border="0" cellpadding="0" cellspacing="0" width="100%">
- <TR>
- <TD class="block" valign="MIDDLE" width="100%" bgcolor="#cccccc"><STRONG>
- <P class="block"> PPM</P>
- </STRONG></TD>
- </TR>
- </TABLE>
-
- </BODY>
-