Bad documentation (no biscuit!)

[Olivier Dagenais]

I have found the documentation provided with version 1.5.2 _and_ 2.0 to have
a big hole in it!  Specifically, the file is /lib/os-fd-ops.html and the
problem is the constants/flags used with the os.open function:  it isn't
obvious what the flags stand for...

After some searching on the net, I found the following descriptions for the
flags:  (from a Unix Java package or something)

O_APPEND          Open in append-only mode.
O_CREAT           Open with creation flag.
O_EXCL            Open with exclusive access flag.
O_NDELAY          Open with no-delay flag.
O_NOCTTY          Open but don't make it the control tty.
O_NONBLOCK        Open in non-blocking mode flag.
O_RDONLY          Open for read-only flag.
O_RDWR            Open for update flag.
O_SYNC            Open and keep-disk-synchronized flag.
O_TRUNC           Open and truncate flag.
O_WRONLY          Open for write-only flag.


Can these be added to the documentation, in that sorted order?  (plus an
elaboration on what a control tty is and what non-blocking or no-delay do
would be very nice..)  Definitions for O_DSYNC, O_RSYNC and O_BINARY are
still missing, anybody can fill them in?  (although I have a good hunch as
to what O_BINARY does...)

am-I-the-only-one-who-isn't-familiar-with-those-flags-ly y'rs

--
----------------------------------------------------------------------
Olivier A. Dagenais - Software Architect and Developer
"Someone called 'Type your name here' is impersonating me on the
internet and is posting exactly the same things I am posting!"