========================================================================
portmanager help:
------------------------------------------------------------------------

commands: These must be first item on the command line

        -s or --status		status of installed ports

        -u or --upgrade		upgrade installed ports

        -sl or --show-leaves	show ports that are not run dependencies
				of another port, AKA "leaves"

        -slid or --show-leaves-interactive-delete
				interactivly and safely delete leaf ports

        -v or --version		portmanager VERSION information

	{port category directory}/{port name}

switches:  These must follow a command if used

	-l or --log		enable limited logging, output goes to
				/var/log/portmanager.log

	-f or --fix		force building of all dependencies in
				single update mode, see examples

	-bu or --back-up	Make packages for updated ports

        -ip ( ignore port )

	-ui or --upgrade-interactive
				upgrade interactively

	-y or --yes		assume yes to everything

	--resume		is you quit portmanager in the middle of
				a forced update, you may be able to resume
				instead of starting from the beggining by
				trying this option

	-p or --pristine	Updates a port if any dependency in it's
				/var/db/pkg/{port name}/+CONTENTS does not
				match what is installed. The effect is when a
				port is updated, any port who uses the updated
				port in it's dependency chain, no matter how
				deep, are rebuilt. Normally only ports one
				level up are rebuilt. 

	--verbose		Extra verbosity to aid in portmanager source
				trouble shooting

	examples:
	
	to add or update a single port with logging:

		portmanager x11/gnome2 --log
    
	to add/update/repair a single port with logging by forcing all
	of it's dependencies to be rebuilt

		portmanager x11/gnome2 --log --fix
    
        to upgrade everything except nedit, open office and ports that 
	dependend on them

		portmanager -u -ip editors/nedit editors/openoffice

	rebuild  all installed ports
	
		portmanager -u -f

	resume after the above halted to make repairs for example,
	avoids starting from scratch
	
		portmanager -u -f --resume

        see portmanager(1),  or http://portmanager.sunsite.dk
        for more information.
------------------------------------------------------------------------
