guide bug?

[Perry E. Metzger]

On Fri, 27 Apr 2018 23:10:34 +1000 Joshua Root <jmr at macports.org>
wrote:
> On 2018-4-27 23:02 , Rainer Müller wrote:
> > On 2018-04-27 14:37, Perry E. Metzger wrote:  
> >> "For the above operations provided by Tcl's file command,
> >> MacPorts provides the following shorthands. These should be used
> >> in preference to the Tcl commands above, as they may work around
> >> certain bugs."  
> > 
> > Ah, I even linked to this section, but did not realize it says
> > that... 
> >> So we've discouraged the direct use of "file copy" over using
> >> "copy" by my reading. "These should be used in preference".  
> > 
> > Very old versions of Tcl (on Tiger and before) indeed had a bug in
> > "file delete" that prompted the addition of "delete". That
> > problem no longer exists as we include our own version of Tcl,
> > but it is probably where this is originally coming from.
> > 
> > Do we really have a preference? At least for "file copy" vs.
> > "copy", both seem to be used to equal amounts in Portfiles.  
> 
> 'move' still handles some case-sensitivity issues, but indeed
> 'copy' and 'delete' are just aliases these days. I think we don't
> need to discourage the use of 'file', since if you hit the one
> fairly rare case where there's a difference you'll know it.

Would it be best to change the documentation then?

Perry
-- 
Perry E. Metzger		pmetzger at macports.org