Skip Menu |

This queue is for tickets about the File-Path CPAN distribution.

Report information
The Basics
Id: 107356
Status: resolved
Worked: 1 min
Priority: 0/
Queue: File-Path

People
Owner: RICHE [...] cpan.org
Requestors: SREZIC [...] cpan.org
Cc:
AdminCc:

Bug Information
Severity: (no value)
Broken in: (no value)
Fixed in: (no value)



Subject: perlfunc.pod contradicts File::Path documentation
"perldoc -f rmdir" says To remove a directory tree recursively ("rm -rf" on Unix) look at the "rmtree" function of the File::Path module. Probably File::Path documentation should also say so (instead of currently stating that it's like "rm -r") (and make sure the behavior is also like this).
Subject: Re: [rt.cpan.org #107356] perlfunc.pod contradicts File::Path documentation
Date: Sun, 27 Sep 2015 09:31:22 -0400
To: bug-File-Path [...] rt.cpan.org
From: Richard Elberger <rich [...] richelberger.com>
I tend to agree with this statement - I mentioned this very same documentation to Jim a few months ago when you originally filed the other RT. However, we didn’t want to change the core behavior of File::Path at the time. Perhaps we should have mentioned we already knew about this conflicting documentation in the other thread which probably could have publicly led us to this point. If we can a better sense that this is the ultimate desired behavior in File::Path I’m all for it. Do you know if there is a feature request voting facility in place (other than ppl doing +1’s in a bug thread)? — rich Show quoted text
> On Sep 26, 2015, at 5:35 PM, Slaven_Rezic via RT <bug-File-Path@rt.cpan.org> wrote: > > Sat Sep 26 17:35:26 2015: Request 107356 was acted upon. > Transaction: Ticket created by SREZIC > Queue: File-Path > Subject: perlfunc.pod contradicts File::Path documentation > Broken in: (no value) > Severity: (no value) > Owner: Nobody > Requestors: SREZIC@cpan.org > Status: new > Ticket <URL: https://rt.cpan.org/Ticket/Display.html?id=107356 > > > > "perldoc -f rmdir" says > > To remove a directory tree recursively ("rm -rf" on Unix) look > at the "rmtree" function of the File::Path module. > > Probably File::Path documentation should also say so (instead of currently stating that it's like "rm -r") (and make sure the behavior is also like this). > >
On Sun Sep 27 09:31:33 2015, rich@richelberger.com wrote: Show quoted text
> I tend to agree with this statement - I mentioned this very same > documentation to Jim a few months ago when you originally filed the > other RT. However, we didn’t want to change the core behavior of > File::Path at the time. Perhaps we should have mentioned we already > knew about this conflicting documentation in the other thread which > probably could have publicly led us to this point. > > If we can a better sense that this is the ultimate desired behavior in > File::Path I’m all for it. > > Do you know if there is a feature request voting facility in place > (other than ppl doing +1’s in a bug thread)? > > — rich >
> > On Sep 26, 2015, at 5:35 PM, Slaven_Rezic via RT <bug-File- > > Path@rt.cpan.org> wrote: > > > > Sat Sep 26 17:35:26 2015: Request 107356 was acted upon. > > Transaction: Ticket created by SREZIC > > Queue: File-Path > > Subject: perlfunc.pod contradicts File::Path documentation > > Broken in: (no value) > > Severity: (no value) > > Owner: Nobody > > Requestors: SREZIC@cpan.org > > Status: new > > Ticket <URL: https://rt.cpan.org/Ticket/Display.html?id=107356 > > > > > > > "perldoc -f rmdir" says > > > > To remove a directory tree recursively ("rm -rf" on Unix) look > > at the "rmtree" function of the File::Path module. > > > > Probably File::Path documentation should also say so (instead of > > currently stating that it's like "rm -r") (and make sure the behavior > > is also like this). > > > >
https://github.com/rpcme/File-Path/commit/f8832028c340e6669ae46021977da853dca75987 will be in next developer release. this doc fix plus the 2.12 rollback of error on root node should 'fix' this to the extent where we don't stomp on any long-standing behaviors.