From f0346bd249ae29cdf4d9c2e88b09e63c41ff1ce8 Mon Sep 17 00:00:00 2001 From: dave Date: Wed, 24 Dec 2003 04:24:29 +0000 Subject: Forgot to save buffer.... sigh git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@5272 b2dd03c8-39d4-4d8f-98ff-823fe69b080e --- io.c | 64 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 64 insertions(+) (limited to 'io.c') diff --git a/io.c b/io.c index de3d7230d8..a8ab755758 100644 --- a/io.c +++ b/io.c @@ -4007,6 +4007,70 @@ opt_i_set(val) ruby_inplace_mode = strdup(RSTRING(val)->ptr); } +/* + * Class IO is the basis for all input and output in Ruby. + * An I/O stream may be duplexed (that is, bidirectional), and + * so may use more than one native operating system stream. + * + * Many of the examples in this section use class File, + * the only standard subclass of IO. The two classes are + * closely associated. + * + * As used in this section, portname may take any of the + * following forms. + * + * * A plain string represents a filename suitable for the underlying + * operating system. + * + * * A string starting with ``|'' indicates a subprocess. + * The remainder of the string following the ``|'' is + * invoked as a process with appropriate input/output channels + * connected to it. + * + * * A string equal to ``|-'' will create another Ruby + * instance as a subprocess. + * + * Ruby will convert pathnames between different operating system + * conventions if possible. For instance, on a Windows system the + * filename ``/gumby/ruby/test.rb'' will be opened as + * ``\gumby\ruby\test.rb''. When specifying a + * Windows-style filename in a Ruby string, remember to escape the + * backslashes: + * + * "c:\\gumby\\ruby\\test.rb" + * + * Our examples here will use the Unix-style forward slashes; + * File::SEPARATOR can be used to get the + * platform-specific separator character. + * + * I/O ports may be opened in any one of several different modes, which + * are shown in this section as mode_string. This mode string + * must be one of the values listed in the following table. + * + * Mode | Meaning + * -----+-------------------------------------------------------- + * "r" | Read-only, starts at beginning of file (default mode). + * -----+-------------------------------------------------------- + * "r+" | Read-write, starts at beginning of file. + * -----+-------------------------------------------------------- + * "w" | Write-only, truncates existing file + * | to zero length or creates a new file for writing. + * -----+-------------------------------------------------------- + * "w+" | Read-write, truncates existing file to zero length + * | or creates a new file for reading and writing. + * -----+-------------------------------------------------------- + * "a" | Write-only, starts at end of file if file exists, + * | otherwise creates a new file for writing. + * -----+-------------------------------------------------------- + * "a+" | Read-write, starts at end of file if file exists, + * | otherwise creates a new file for reading and + * | writing. + * -----+-------------------------------------------------------- + * "b" | (DOS/Windows only) Binary file mode (may appear with + * | any of the key letters listed above). + * + */ + void Init_IO() { -- cgit v1.2.3