Add documentation for various port commands

[raimue (Rainer Müller)]

The command port gohome is not documented, neither in the guide nor in the man page.

It was added in r24551.

[blb@…]

I'll attach a diff for port.1 to add documentation for several commands: platform, gohome, usage, work, cd, url, and ed. There are still several not listed in this diff, either because they appear to not be implemented yet (compact and uncompact) or I don't know how they work (submit, mirror, load, and unload).

[ryandesign (Ryan Carsten Schmidt)]

"sudo port load ${port}" is a shortcut for "sudo launchctl load -w /Library/LaunchDaemons/org.macports.${port}.plist". Similarly for "sudo port unload ${port}". Added in r31500.

[blb@…]

Updated diff adding descriptions of load and unload; thanks Ryan.

[raimue (Rainer Müller)]

I think the description for port url is not quite correct.

Displays the MacPorts internal URL for the given portname.

It's the internal what concerns me. The value of port url can be passed as argument to any port action.

See port-url here:

SYNOPSIS
     port [-vdqfonRusbckixpt] [-D portdir] [-F cmdfile] [action] [actionflags]
          [[portname | pseudo-portname | port-url]]
          [[@version] [+/-variant ...] ... [option=value ...]]

I would say:

Displays the URL to the Portfile of the given portname, which can be passed as port-url.

There is no other description for port-url so this could help to clarify it a bit.

[blb@…]

Updating the patch to include raimue@'s improved description for port url (though the URL is the path for the port, not the Portfile itself), and added an initial section for port mirror which probably needs some improvement.

[blb@…]

diff to base/doc/port.1

[raimue (Rainer Müller)]

Committed the patch in r44815.

[(none)]

Milestone Website & Documentation deleted