port clean doesn't conform to the man page instructions

[paulbeard@…]

Specifically the "all" flag:

"To remove the

work files, distribution files and archives, pass --all. To remove log files for certain port, pass --logs. For example:

port clean --dist vim port clean --archive vim port clean --logs vim

Users/paul# port clean --all Can't map the URL '​file://.' to a port description file ("Could not find Portfile in /Users/paul"). Please verify that the directory and portfile syntax are correct. To use the current port, you must be in a port's directory.

Users/paul# port -v clean all ---> Cleaning 2Pong ---> Removing build directory for 2Pong ---> Cleaning 3proxy ---> Removing build directory for 3proxy ---> Cleaning 4th ---> Removing build directory for 4th

[blb@…]

--all and all are actually different, and you can use them both as in port clean --all all as --all applies to whichever port(s) is given to clean and all is the actual port to clean.

The examples in the man page could also include port clean --all vim, would that help make it clearer?

[paulbeard@…]

Replying to blb@…:

--all and all are actually different, and you can use them both as in port clean --all all as --all applies to whichever port(s) is given to clean and all is the actual port to clean.

The examples in the man page could also include port clean --all vim, would that help make it clearer?

Why not just make port clean all work as expected/advertised?

That works but why would anyone do that?

[jmroot (Joshua Root)]

Working as documented.

[paulbeard@…]

"port clean --all all as --all applies to whichever port(s) is given to clean and all is the actual port to clean."

There is no mention of {{{port clean all}} in the manual.

{{{Users/paul:: man port | col -b | grep "clean all"

(paul@…)-(08:14 AM / Mon Aug 09)

Users/paul:: }}}

[sewebster@…]

"all" has nothing in particular to do with port clean. It is just a list of all ports. So if you want to clean all ports, you "port clean all", if you want to install all ports, you "port install all" etc.

The "all" pseudo-portname is explained very close to the beginning of the man page.

"port clean --all all" is an ok way of cleaning almost everything, but probably shouldn't be included in the documentation, because the list of all ports is very very long, and most people likely don't need to do this.

[sewebster@…]

Cc Me!