<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body>
<p><font face="Times New Roman">From a general usability and
documentation standpoint (without attention beyond the average
user, as confronting that error seems to be from the other
conversation), the MacPorts Guide addresses this quite well:</font></p>
<ul>
<li><font face="Times New Roman"><a class="moz-txt-link-freetext" href="https://guide.macports.org/#using.common-tasks.upgrading">https://guide.macports.org/#using.common-tasks.upgrading</a></font></li>
<li><font face="Times New Roman"><a class="moz-txt-link-freetext" href="https://guide.macports.org/#using.port.upgrade">https://guide.macports.org/#using.port.upgrade</a></font></li>
</ul>
<p><font face="Times New Roman">The guide has been indispensable in
easily creating my regular install maintenance scripts and
workflows.</font><br>
</p>
<div class="moz-signature">Thomas R. Murphy
(<a class="moz-txt-link-abbreviated" href="mailto:thomas.russell.murphy@case.edu">thomas.russell.murphy@case.edu</a>, <a class="moz-txt-link-abbreviated" href="mailto:trm70@case.edu">trm70@case.edu</a>)<br>
GPG Key ID: 959D48BF<br>
</div>
<div class="moz-cite-prefix">On 2022-01-30 02:24:40, Andrew Janke
wrote:<br>
</div>
<blockquote type="cite"
cite="mid:8c09ba96-9fd8-46e9-f57b-78e40133c178@apjanke.net">Hi,
MacPorts developers,
<br>
<br>
Long-time Homebrew user and recent MacPorts convert here.
<br>
<br>
Minor usability issue with the `port` program, I think: I suspect
that a common operation for regular MacPorts users to do is
"upgrade all my stuff to the latest version".
<br>
<br>
I tried doing this with `port selfupdate`; `port upgrade`, and got
this error message:
<br>
<br>
[~] $ sudo port selfupdate
<br>
---> Updating MacPorts base sources using rsync
<br>
MacPorts base version 2.7.1 installed,
<br>
MacPorts base version 2.7.1 downloaded.
<br>
---> Updating the ports tree
<br>
---> MacPorts base is already the latest version
<br>
<br>
The ports tree has been updated. To upgrade your installed ports,
you should run
<br>
port upgrade outdated
<br>
[~] $ sudo port upgrade
<br>
Can't map the URL '<a class="moz-txt-link-freetext" href="file://">file://</a>.' to a port description file ("Could
not find Portfile in /Users/janke").
<br>
Please verify that the directory and portfile syntax are correct.
<br>
To use the current port, you must be in a port's directory.
<br>
[~] $
<br>
<br>
I'm a dev with 25 years of coding and sysadmin experience, and I
don't know what to do with that error message. I dunno what a
regular user is supposed to do with that. (Yes, I saw the "To
upgrade your installed ports" output from the selfupdate command,
but still.)
<br>
<br>
Maybe the error message here could be modified to include a "maybe
you meant `port upgrade outdated`" message or something like that?
Where's the '<a class="moz-txt-link-freetext" href="file://">file://</a>'" coming from, anyway? Does `port upgrade`
operate on some port definition found in the current working
directory by default? I did not provide a URL as an input to the
`port upgrade` command, so it's a little unexpected that I got an
error complaining about a URL here.
<br>
<br>
Cheers,
<br>
Andrew
<br>
</blockquote>
</body>
</html>