RFE: document binpath option in ports.conf

[cssdev@…]

Only after some digging through trying to get things running on FreeBSD did I realize why the port command couldn't locate /usr/local/bin/rsync. I eventually figured out how the PATH variable operates within darwinports.tcl, and then I found confirmation in BUG #1427 that I needed to overload binpath. I'm not sure if this might considered a dangerous workaround, as it can introduce non-system and non-DP conflicts. However, it would be helpful to have a comment in ports.conf indicating that that this option is available.

[cssdev@…]

Moving to doc

[rhwood@…]

Make the list of bugs easier to scan.

[markd@…]

Only Macs are supported now. Could you describe the issue in laymen's terms or provide an example of how you think it should be documented? People doing documentation aren't always portmgrs. ;-)

[cssdev]

The binpath variable is not documented in the man page for ports.conf, so it's not obvious that it's an available setting. It was the key variable in my case due to the fact that the default binpath did not include a path containing FreeBSD's rsync command (which is found in /usr/local/bin). It's a valid variable, but it's just undocumented.

binpath

Sets the directory search path for locating system executables used by MacPorts. This variable should contain the paths for locating utilities such as rsync, XXX, and YYY. (what are some of the other required utilities?)
Default: ${prefix}/bin:${prefix}/sbin:/bin:/sbin:/usr/bin:/usr/sbin:/usr/X11R6/bin

[markd@…]

Perfect. Thanks. I've added it to a todo list for docs.

[jmpp@…]

Added in r21998, closing ticket.

-jmpp