port: add page

[personalnadir]

Proposed page for mac ports port cli.

---

• The page (if new), does not already exist in the repo.

• The page (if new), has been added to the correct platform folder:
  common/ if it's common to all platforms, linux/ if it's Linux-specific, and so on.

• The page has 8 or fewer examples.

• The PR is appropriately titled:
  <command name>: add page for new pages, or <command name>: <description of changes> for pages being edited

• The page follows the contributing guidelines

[CLAassistant]

All committers have signed the CLA.

[tldr-bot]

The build for this PR has failed with the following error(s):

pages/osx/port.md:3: TLDR003 Descriptions should start with a capital letter
pages/osx/port.md:3: TLDR004 Command descriptions should end in a period

Please fix the error(s) and push again.

[agnivade]

"a" package

[agnivade]

"a" package

[agnivade]

Might be better to remove "tree". How about -

Update `port` to the latest version

[personalnadir]

That's a good point. I think it still needs to refer to the update to the tree in some form though as that's its most common use-case. How about something like:

Update port and fetch latest list of available packages

[agnivade]

Maybe I don't understand clearly, what exactly do you mean by "tree" here ?

[personalnadir]

The port tree is what Mac Ports refers to the list of packages as. From their documentation for this command: "The local ports tree is a collection of files that contain information on which packages are available through MacPorts and how they can be installed. You should regularly update your ports tree to get access to updated versions of software and bug fixes. To do that, use selfupdate"

port selfupdate also upgrades the port program as well if a new version is available. The output looks something like:

MacPorts base version 2.4.1 installed,
MacPorts base version 2.4.1 downloaded.
--->  Updating the ports tree
--->  MacPorts base is already the latest version

The ports tree has been updated. To upgrade your installed ports, you should run
  port upgrade outdated

[agnivade]

Ah, got it. Then I think its better to avoid jargon and go with simple words. Your suggestion works fine -

Update port and fetch latest list of available packages

[sbrl]

So port is macOS's primary package manager?

[personalnadir]

No, there's also Homebrew which has its brew command already in the TLDR pages. I took that line directly from the brew page. I think port is the more venerable of the two.

[sbrl]

Ah, ok 😺

[personalnadir]

Sorry, forgot I hadn't made that change, just added it now

[sbrl]

What does inactive mean in this context?

[personalnadir]

port does not remove older versions of installed packages after an upgrade, so in case an update goes wrong you can revert to the already installed versions. These older versions are referred to as inactive by the command.

Perhaps obsolete or superseded might be clearer? Or something like:

- Remove old versions of installed packages

[sbrl]

Ah, I see. Yeah, that's a much better way of putting it 😺

[stale]

Hi all! This thread has not had any recent activity. Are there any updates? Thanks!

[sbrl]

Thanks, @personalnadir 😺