Re: [Rd] typo in docs for unlink()

From: Duncan Murdoch <murdoch_at_stats.uwo.ca>
Date: Wed, 11 Nov 2009 05:36:33 -0500

On 10/11/2009 11:16 PM, Tony Plate wrote:

> PS, I should have said that I'm reading the docs for unlink in R-2.10.0 
> on a Linux system.  The docs that appear in a Windows installation of R 
> are different (the Windows docs do not mention that not all systems 
> support recursive=TRUE).
> 
> Here's a plea for docs to be uniform across all systems!  Trying to 
> write R code that works on all systems is much harder when the docs are 
> different across systems, and you might only see system specific notes 
> on a different system than the one you're working on.

That's a good point, but in favour of the current practice, it is very irritating when searches take you to functions that don't work on your system.

One thing that might be possible is to render all versions of the help on all systems, but with some sort of indicator (e.g. a colour change) to indicate things that don't apply on your system, or only apply on your system. I think the hardest part of doing this would be designing the output; actually implementing it would not be so bad.

Duncan Murdoch

> 
> -- Tony Plate
> 
> Tony Plate wrote:

>> The VALUE section in the help for 'unlink' says:
>>
>> | 0| for success, |1| for failure. Not deleting a non-existent file
>> is not a failure, nor is being unable to delete a directory if
>> |recursive = FALSE|. However, missing values in |x| result are
>> regarded as failures.
>>
>> The last phrase doesn't make sense to me. Should it be either
>> "missing values in x are regarded as failures" or "missing values in x
>> result in failure" ?
>>
>> Also, after reading the docs, I'm still unable to work out if unlink()
>> will return 1 when the user tries to recursively delete a directory on
>> systems that don't support recursive=T.
>>
>> The DETAILS section says "recursive=TRUE is not supported on all
>> platforms, and may be ignored, with a warning", which could be
>> interpreted as implying no special action when recursive=TRUE is not
>> implemented (other than a warning()), and the VALUE section doesn't
>> say what the return value will be under such conditions.
>>
>> I've skimmed the various *_unlink functions in src/main/platform.c,
>> and it looks like they all implement recursive=TRUE, so I'm still in
>> the dark about the required behavior on systems that don't support
>> it. Could this be clarified in the help file?
>>
>> thanks,
>>
>> Tony Plate
>>
>> ______________________________________________
>> R-devel_at_r-project.org mailing list
>> https://stat.ethz.ch/mailman/listinfo/r-devel
>>
> 
> ______________________________________________
> R-devel_at_r-project.org mailing list
> https://stat.ethz.ch/mailman/listinfo/r-devel

______________________________________________
R-devel_at_r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-devel Received on Wed 11 Nov 2009 - 10:44:31 GMT

This archive was generated by hypermail 2.2.0 : Thu 12 Nov 2009 - 03:10:23 GMT