[Rd] Section 7.1 HML documentation (PR#8484)

[Greg Kochanski]

Well, I don't know how it can be precise
and correct when it has dangling antecedents.
Gramatically speaking, that's the equivalent of
an uninitialized pointer.

However, I agree with you that it probably just
needs a minor bit of fiddling to make sure it
answers "Instead of what?" and "Earlier than what?"


Hin-Tak Leung wrote:
> greg.kochanski at phon.ox.ac.uk wrote:
> 
>> Full_Name: Greg Kochanski
>> Version: 2.2.0
>> OS: Debian Linux i686
>> Submission from: (NULL) (212.159.16.190)
>>
>>
>> In /usr/share/doc/r-doc-html/manual/R-data.html (at least that's where
>> it is on Debian...) the documentation is unclear.   Comments below.
> 
> 
> The documentation is, I believe, correct and precise as it stands.
> What it doesn't emphasize and mention is the difference between
> "BSD socket" and "socket connection", or an "R connection of the socket 
> type". And it is recommended that you
> use "socket connection" instead of "BSD socket".
> 
> The earlier "BSD socket" is created, read, write with 
> "make.socket"/"read.socket"/"write socket"/"close socket".
> 
> The newer "socket connection" is created by creating a new connection 
> object like this:
>      con <- socketConnection(port = 79, blocking = TRUE)
> and invoking the open/write/read method of the "connection"
> object. type "?connection" in an R prompt for details.
> 
> "BSD socket" is a unix concept, "socket connection" is an R object.
> The paragraph should have put "BSD socket" and "socket connection"
> in quote or italics. Make more sense?
> 
> Somebody please fix the paragraph... :-).
> 
>> The paragraph has unclear references, and I have no idea what
>> it actually means.
>>
>>
>>>> Base R comes with some facilities to communicate via BSD sockets on 
>>>> systems
>>
>>
>> that support them (...). One potential problem....
>>
>>>> For new projects it is suggested that socket connections are used 
>>>> instead.
>>
>>
>>
>> "Used instead"?   Instead of what?
>>
>>
>>>> The earlier low-level interface is given by functions make.socket,
>>
>>
>> read.socket, write.socket and close.socket.
>> What does "earlier" mean?   Earlier than what?
>>
>> ______________________________________________
>> R-devel at r-project.org mailing list
>> https://stat.ethz.ch/mailman/listinfo/r-devel
> 
> 
> 
>