Index: ChangeLog
===================================================================
RCS file: /cvsroot/tcl/tcl/ChangeLog,v
retrieving revision 1.352
diff -c -r1.352 ChangeLog
*** ChangeLog	2000/11/24 15:29:51	1.352
--- ChangeLog	2000/12/06 10:06:37
***************
*** 1,3 ****
--- 1,9 ----
+ 2000-12-06  Donal K. Fellows  <fellowsd@cs.man.ac.uk>
+ 
+ 	* doc/open.n: Added xref to fconfigure and advice on the opening
+ 	  of binary files.  Should help prevent a recurrence of bugs like
+ 	  #124558
+ 
  2000-11-24  Donal K. Fellows  <fellowsd@cs.man.ac.uk>
  
  	* generic/tclExecute.c (TclExecuteByteCode): Logical negation "!"
Index: doc/open.n
===================================================================
RCS file: /cvsroot/tcl/tcl/doc/open.n,v
retrieving revision 1.10
diff -c -r1.10 open.n
*** doc/open.n	2000/09/07 14:27:50	1.10
--- doc/open.n	2000/12/06 10:06:39
***************
*** 108,113 ****
--- 108,125 ----
  (an integer) is used to set the permissions for the new file in
  conjunction with the process's file mode creation mask.
  \fIPermissions\fR defaults to 0666.
+ .PP
+ '\" Not versioned as advice applies to all recent versions of Tcl.
+ '\" Prior to that, Tcl didn't really support binary files anyway...
+ .VS
+ Note that if you are going to be reading or writing binary data from
+ the channel created by this command, you should use the
+ \fBfconfigure\fR command to change the \fB-translation\fI option of
+ the channel to \fBbinary\fR before transferring any binary data.  This
+ is in contrast to the ``b'' character passed as part of the equivalent
+ of the \fIaccess\fR parameter to some versions of the C library
+ \fIfopen()\fR function.
+ .VE
  .SH "COMMAND PIPELINES"
  .PP
  If the first character of \fIfileName\fR is ``|'' then the
***************
*** 253,259 ****
  applications on the various platforms
  
  .SH "SEE ALSO"
! file(n), close(n), filename(n), gets(n), read(n), puts(n), exec(n), fopen(1)
  
  .SH KEYWORDS
  access mode, append, create, file, non-blocking, open, permissions,
--- 265,272 ----
  applications on the various platforms
  
  .SH "SEE ALSO"
! file(n), close(n), filename(n), fconfigure(n), gets(n), read(n),
! puts(n), exec(n), fopen(1)
  
  .SH KEYWORDS
  access mode, append, create, file, non-blocking, open, permissions,
