diff options
| author | dougb <dougb@FreeBSD.org> | 2009-08-25 08:23:34 +0800 |
|---|---|---|
| committer | dougb <dougb@FreeBSD.org> | 2009-08-25 08:23:34 +0800 |
| commit | d492fcdfa4aef24f1574ec426075032eaafbfc9a (patch) | |
| tree | 507d9c920fce2a86bf326d47844caf57386e3bae | |
| parent | e61d62c3e6424a15ff01c6237bc06e11b3d72c83 (diff) | |
| download | freebsd-ports-gnome-d492fcdfa4aef24f1574ec426075032eaafbfc9a.tar.gz freebsd-ports-gnome-d492fcdfa4aef24f1574ec426075032eaafbfc9a.tar.zst freebsd-ports-gnome-d492fcdfa4aef24f1574ec426075032eaafbfc9a.zip | |
1. Add a "quick start" note to the top of the man page that directs
users to the EXAMPLES section.
2. Expand the EXAMPLES with some more commonly used features.
3. Minor tweaks to other texts.
This version will go out with portmaster version 2.11 but the changes
are not specific to that version.
| -rw-r--r-- | ports-mgmt/portmaster/files/portmaster.8 | 31 |
1 files changed, 25 insertions, 6 deletions
diff --git a/ports-mgmt/portmaster/files/portmaster.8 b/ports-mgmt/portmaster/files/portmaster.8 index 4883e8498634..50de4ac7a50b 100644 --- a/ports-mgmt/portmaster/files/portmaster.8 +++ b/ports-mgmt/portmaster/files/portmaster.8 @@ -24,7 +24,7 @@ .\" .\" $FreeBSD$ .\" -.Dd July 29, 2009 +.Dd August 24, 2009 .Dt PORTMASTER 8 .Os .Sh NAME @@ -93,12 +93,18 @@ and/or multiple globs from /var/db/pkg .Fl h|--help .Nm .Fl -version -.Pp +.Sh QUICK START GUIDE +This manual contains a lot of valuable information about +.Nm , +and you should read the entire manual to give you a better +idea about how it works and what choices are available to you. +However in the interests of getting you started quickly +please see the EXAMPLES section at the end of the manual. .Sh DESCRIPTION The .Nm utility is a tool for updating your ports. -It uses no external database to track what you +It does not use an external database to track what you have installed. Rather it uses the existing ports infrastructure, including what is located in @@ -487,7 +493,8 @@ update the port anyway. .Pp .It Pa /var/db/pkg/*/PM_UPGRADE_DONE_FLAG Indicates to a subsequent -.Fl f +.Fl a , +.Fl f , or .Fl r run which includes the @@ -579,11 +586,23 @@ of the .Nm command: .Pp +Update one port: .Dl "portmaster fooport-1.23" .Dl "portmaster fooport" -.Dl "portmaster fooport-1.23 barport-4.56" -.Dl "portmaster -p /usr/ports/foo/fooport" .Dl "portmaster foo/fooport" +.Pp +Update multiple ports: +.Dl "portmaster fooport-1.23 barport baz/blahport" +.Pp +Update all ports that need updating: +.Dl "portmaster -a" +.Pp +Update all ports that need updating, and delete stale +distfiles after the update is done: +.Dl "portmaster -aD" +.Dl "portmaster --clean-distfiles" +.Pp +More complex tasks (please see the details for these options above): .Dl "portmaster -r fooport-1.23" .Dl "portmaster -o emulators/linux_base-fc4 linux_base-8-8.0_15" .Dl "portmaster -x cvsup -f -a" |