Add documentation for `port gohome`

[raimue@…]

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@…]

"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@…]

diff to base/doc/port.1

[blb@…]

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

[raimue@…]

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.