[MacPorts] #58505: Please improve the "pseudo-portname selector" information on the Macports manual AND guide (was: Omission of pseudo-portname selector information from Macports manual)

[MacPorts]

#58505: Please improve the "pseudo-portname selector" information on the Macports
manual AND guide
----------------------------+--------------------
  Reporter:  SenileFelineS  |      Owner:  (none)
      Type:  enhancement    |     Status:  new
  Priority:  Normal         |  Milestone:
 Component:  guide          |    Version:  2.5.4
Resolution:                 |   Keywords:
      Port:                 |
----------------------------+--------------------
Changes (by SenileFelineS):

 * cc: SenileFelineS (added)


Old description:

> Looking at the man page for Macports ({{{man port}}} or {{{port help}}}),
> there is a section regarding "Other pseudo-portname selectors". However,
> I can't find an explicit explanation of differences between 'depof',
> 'rdepof', 'rdepends', 'dependentof', and 'rdependentof'.
>
> One can make a not-too-difficult educated guess to infer that
> 'dependentof:regex' refers to the ports directly dependent on 'regex',
> and that 'rdependentof:regex' refers to the ports directly dependent on
> 'regex' **as well as** those dependent ports' dependent ports, and the
> recursive tree of dependents that can be followed up.
>
> From that, one can hopefully infer that 'depof:regex' refers to the ports
> that 'regex' directly depends on, and that 'rdepof:regex' refers to ports
> that 'regex' directly depends on **as well as** those dependency ports'
> dependency ports, and the recursive tree of dependencies that can be
> followed down.
>
> However, 'rdepends' is not clearly explained, **and 'depends' isn't even
> listed.**
>

> Can this be clarified in the manual and the online guide? It could be
> easier to understand.

New description:

 Looking at the man page for Macports ({{{man port}}} or {{{port help}}}),
 there is a section regarding "Other pseudo-portname selectors". However, I
 can't find an explicit explanation of differences between 'depof',
 'rdepof', 'rdepends', 'dependentof', and 'rdependentof'.

 One can make a not-too-difficult educated guess to infer that
 'dependentof:regex' refers to the ports directly dependent on 'regex', and
 that 'rdependentof:regex' refers to the ports directly dependent on
 'regex' **as well as** those dependent ports' dependent ports, and the
 recursive tree of dependents that can be followed up.

 From that, one can hopefully infer that 'depof:regex' refers to the ports
 that 'regex' directly depends on, and that 'rdepof:regex' refers to ports
 that 'regex' directly depends on **as well as** those dependency ports'
 dependency ports, and the recursive tree of dependencies that can be
 followed down.

 However, 'rdepends' is not clearly explained, **and 'depends' isn't even
 listed.**


 Can this be clarified in the manual and the online guide? It could be
 easier to understand if it were outlined in such a way like here in a
 tabular format:
 http://khelil.de/Ref_Projekte_Intern/Unix/Tab_Tool_MacPorts_Selectors_EN.html

--

-- 
Ticket URL: <https://trac.macports.org/ticket/58505#comment:1>
MacPorts <https://www.macports.org/>
Ports system for macOS