mirror of
https://github.com/ruby/ruby.git
synced 2022-11-09 12:17:21 -05:00
Fix formatting of What's Here for File (#5717)
This commit is contained in:
parent
52793c007b
commit
d0b7df8153
Notes:
git
2022-03-26 02:16:56 +09:00
Merged-By: BurdetteLamar <BurdetteLamar@Yahoo.com>
1 changed files with 93 additions and 93 deletions
186
file.c
186
file.c
|
@ -6591,119 +6591,119 @@ const char ruby_null_device[] =
|
|||
*
|
||||
* === Creating
|
||||
*
|
||||
* - ::new:: Opens the file at the given path; returns the file.
|
||||
* - ::open:: Same as ::new, but when given a block will yield the file to the block,
|
||||
* and close the file upon exiting the block.
|
||||
* - ::link:: Creates a new name for an existing file using a hard link.
|
||||
* - ::mkfifo:: Returns the FIFO file created at the given path.
|
||||
* - ::symlink:: Creates a symbolic link for the given file path.
|
||||
* - ::new: Opens the file at the given path; returns the file.
|
||||
* - ::open: Same as ::new, but when given a block will yield the file to the block,
|
||||
* and close the file upon exiting the block.
|
||||
* - ::link: Creates a new name for an existing file using a hard link.
|
||||
* - ::mkfifo: Returns the FIFO file created at the given path.
|
||||
* - ::symlink: Creates a symbolic link for the given file path.
|
||||
*
|
||||
* === Querying
|
||||
*
|
||||
* _Paths_
|
||||
*
|
||||
* - ::absolute_path:: Returns the absolute file path for the given path.
|
||||
* - ::absolute_path?:: Returns whether the given path is the absolute file path.
|
||||
* - ::basename:: Returns the last component of the given file path.
|
||||
* - ::dirname:: Returns all but the last component of the given file path.
|
||||
* - ::expand_path:: Returns the absolute file path for the given path,
|
||||
* expanding <tt>~</tt> for a home directory.
|
||||
* - ::extname:: Returns the file extension for the given file path.
|
||||
* - ::fnmatch? (aliased as ::fnmatch):: Returns whether the given file path
|
||||
* matches the given pattern.
|
||||
* - ::join:: Joins path components into a single path string.
|
||||
* - ::path:: Returns the string representation of the given path.
|
||||
* - ::readlink:: Returns the path to the file at the given symbolic link.
|
||||
* - ::realdirpath:: Returns the real path for the given file path,
|
||||
* where the last component need not exist.
|
||||
* - ::realpath:: Returns the real path for the given file path,
|
||||
* where all components must exist.
|
||||
* - ::split:: Returns an array of two strings: the directory name and basename
|
||||
* of the file at the given path.
|
||||
* - #path (aliased as #to_path):: Returns the string representation of the given path.
|
||||
* - ::absolute_path: Returns the absolute file path for the given path.
|
||||
* - ::absolute_path?: Returns whether the given path is the absolute file path.
|
||||
* - ::basename: Returns the last component of the given file path.
|
||||
* - ::dirname: Returns all but the last component of the given file path.
|
||||
* - ::expand_path: Returns the absolute file path for the given path,
|
||||
* expanding <tt>~</tt> for a home directory.
|
||||
* - ::extname: Returns the file extension for the given file path.
|
||||
* - ::fnmatch? (aliased as ::fnmatch): Returns whether the given file path
|
||||
* matches the given pattern.
|
||||
* - ::join: Joins path components into a single path string.
|
||||
* - ::path: Returns the string representation of the given path.
|
||||
* - ::readlink: Returns the path to the file at the given symbolic link.
|
||||
* - ::realdirpath: Returns the real path for the given file path,
|
||||
* where the last component need not exist.
|
||||
* - ::realpath: Returns the real path for the given file path,
|
||||
* where all components must exist.
|
||||
* - ::split: Returns an array of two strings: the directory name and basename
|
||||
* of the file at the given path.
|
||||
* - #path (aliased as #to_path): Returns the string representation of the given path.
|
||||
*
|
||||
* _Times_
|
||||
*
|
||||
* - ::atime:: Returns a \Time for the most recent access to the given file.
|
||||
* - ::birthtime:: Returns a \Time for the creation of the given file.
|
||||
* - ::ctime:: Returns a \Time for the metadata change of the given file.
|
||||
* - ::mtime:: Returns a \Time for the most recent data modification to
|
||||
* the content of the given file.
|
||||
* - #atime:: Returns a \Time for the most recent access to +self+.
|
||||
* - #birthtime:: Returns a \Time the creation for +self+.
|
||||
* - #ctime:: Returns a \Time for the metadata change of +self+.
|
||||
* - #mtime:: Returns a \Time for the most recent data modification
|
||||
* to the content of +self+.
|
||||
* - ::atime: Returns a \Time for the most recent access to the given file.
|
||||
* - ::birthtime: Returns a \Time for the creation of the given file.
|
||||
* - ::ctime: Returns a \Time for the metadata change of the given file.
|
||||
* - ::mtime: Returns a \Time for the most recent data modification to
|
||||
* the content of the given file.
|
||||
* - #atime: Returns a \Time for the most recent access to +self+.
|
||||
* - #birthtime: Returns a \Time the creation for +self+.
|
||||
* - #ctime: Returns a \Time for the metadata change of +self+.
|
||||
* - #mtime: Returns a \Time for the most recent data modification
|
||||
* to the content of +self+.
|
||||
*
|
||||
* _Types_
|
||||
*
|
||||
* - ::blockdev?:: Returns whether the file at the given path is a block device.
|
||||
* - ::chardev?:: Returns whether the file at the given path is a character device.
|
||||
* - ::directory?:: Returns whether the file at the given path is a diretory.
|
||||
* - ::executable?:: Returns whether the file at the given path is executable
|
||||
* by the effective user and group of the current process.
|
||||
* - ::executable_real?:: Returns whether the file at the given path is executable
|
||||
* by the real user and group of the current process.
|
||||
* - ::exist?:: Returns whether the file at the given path exists.
|
||||
* - ::file?:: Returns whether the file at the given path is a regular file.
|
||||
* - ::ftype:: Returns a string giving the type of the file at the given path.
|
||||
* - ::grpowned?:: Returns whether the effective group of the current process
|
||||
* owns the file at the given path.
|
||||
* - ::identical?:: Returns whether the files at two given paths are identical.
|
||||
* - ::lstat:: Returns the File::Stat object for the last symbolic link
|
||||
* in the given path.
|
||||
* - ::owned?:: Returns whether the effective user of the current process
|
||||
* owns the file at the given path.
|
||||
* - ::pipe?:: Returns whether the file at the given path is a pipe.
|
||||
* - ::readable?:: Returns whether the file at the given path is readable
|
||||
* by the effective user and group of the current process.
|
||||
* - ::readable_real?:: Returns whether the file at the given path is readable
|
||||
* by the real user and group of the current process.
|
||||
* - ::setgid?:: Returns whether the setgid bit is set for the file at the given path.
|
||||
* - ::setuid?:: Returns whether the setuid bit is set for the file at the given path.
|
||||
* - ::socket?:: Returns whether the file at the given path is a socket.
|
||||
* - ::stat:: Returns the File::Stat object for the file at the given path.
|
||||
* - ::sticky?:: Returns whether the file at the given path has its sticky bit set.
|
||||
* - ::symlink?:: Returns whether the file at the given path is a symbolic link.
|
||||
* - ::umask:: Returns the umask value for the current process.
|
||||
* - ::world_readable?:: Returns whether the file at the given path is readable
|
||||
* by others.
|
||||
* - ::world_writable?:: Returns whether the file at the given path is writable
|
||||
* by others.
|
||||
* - ::writable?:: Returns whether the file at the given path is writable
|
||||
* by the effective user and group of the current process.
|
||||
* - ::writable_real?:: Returns whether the file at the given path is writable
|
||||
* by the real user and group of the current process.
|
||||
* - #lstat:: Returns the File::Stat object for the last symbolic link
|
||||
* in the path for +self+.
|
||||
* - ::blockdev?: Returns whether the file at the given path is a block device.
|
||||
* - ::chardev?: Returns whether the file at the given path is a character device.
|
||||
* - ::directory?: Returns whether the file at the given path is a diretory.
|
||||
* - ::executable?: Returns whether the file at the given path is executable
|
||||
* by the effective user and group of the current process.
|
||||
* - ::executable_real?: Returns whether the file at the given path is executable
|
||||
* by the real user and group of the current process.
|
||||
* - ::exist?: Returns whether the file at the given path exists.
|
||||
* - ::file?: Returns whether the file at the given path is a regular file.
|
||||
* - ::ftype: Returns a string giving the type of the file at the given path.
|
||||
* - ::grpowned?: Returns whether the effective group of the current process
|
||||
* owns the file at the given path.
|
||||
* - ::identical?: Returns whether the files at two given paths are identical.
|
||||
* - ::lstat: Returns the File::Stat object for the last symbolic link
|
||||
* in the given path.
|
||||
* - ::owned?: Returns whether the effective user of the current process
|
||||
* owns the file at the given path.
|
||||
* - ::pipe?: Returns whether the file at the given path is a pipe.
|
||||
* - ::readable?: Returns whether the file at the given path is readable
|
||||
* by the effective user and group of the current process.
|
||||
* - ::readable_real?: Returns whether the file at the given path is readable
|
||||
* by the real user and group of the current process.
|
||||
* - ::setgid?: Returns whether the setgid bit is set for the file at the given path.
|
||||
* - ::setuid?: Returns whether the setuid bit is set for the file at the given path.
|
||||
* - ::socket?: Returns whether the file at the given path is a socket.
|
||||
* - ::stat: Returns the File::Stat object for the file at the given path.
|
||||
* - ::sticky?: Returns whether the file at the given path has its sticky bit set.
|
||||
* - ::symlink?: Returns whether the file at the given path is a symbolic link.
|
||||
* - ::umask: Returns the umask value for the current process.
|
||||
* - ::world_readable?: Returns whether the file at the given path is readable
|
||||
* by others.
|
||||
* - ::world_writable?: Returns whether the file at the given path is writable
|
||||
* by others.
|
||||
* - ::writable?: Returns whether the file at the given path is writable
|
||||
* by the effective user and group of the current process.
|
||||
* - ::writable_real?: Returns whether the file at the given path is writable
|
||||
* by the real user and group of the current process.
|
||||
* - #lstat: Returns the File::Stat object for the last symbolic link
|
||||
* in the path for +self+.
|
||||
*
|
||||
* _Contents_
|
||||
*
|
||||
* - ::empty? (aliased as ::zero?):: Returns whether the file at the given path
|
||||
* exists and is empty.
|
||||
* - ::size:: Returns the size (bytes) of the file at the given path.
|
||||
* - ::size?:: Returns +nil+ if there is no file at the given path,
|
||||
* or if that file is empty; otherwise returns the file size (bytes).
|
||||
* - #size:: Returns the size (bytes) of +self+.
|
||||
* - ::empty? (aliased as ::zero?): Returns whether the file at the given path
|
||||
* exists and is empty.
|
||||
* - ::size: Returns the size (bytes) of the file at the given path.
|
||||
* - ::size?: Returns +nil+ if there is no file at the given path,
|
||||
* or if that file is empty; otherwise returns the file size (bytes).
|
||||
* - #size: Returns the size (bytes) of +self+.
|
||||
*
|
||||
* === Settings
|
||||
*
|
||||
* - ::chmod:: Changes permissions of the file at the given path.
|
||||
* - ::chown:: Change ownership of the file at the given path.
|
||||
* - ::lchmod:: Changes permissions of the last symbolic link in the given path.
|
||||
* - ::lchown:: Change ownership of the last symbolic in the given path.
|
||||
* - ::lutime:: For each given file path, sets the access time and modification time
|
||||
* of the last symbolic link in the path.
|
||||
* - ::rename:: Moves the file at one given path to another given path.
|
||||
* - ::utime:: Sets the access time and modification time of each file
|
||||
* at the given paths.
|
||||
* - #flock:: Locks or unlocks +self+.
|
||||
* - ::chmod: Changes permissions of the file at the given path.
|
||||
* - ::chown: Change ownership of the file at the given path.
|
||||
* - ::lchmod: Changes permissions of the last symbolic link in the given path.
|
||||
* - ::lchown: Change ownership of the last symbolic in the given path.
|
||||
* - ::lutime: For each given file path, sets the access time and modification time
|
||||
* of the last symbolic link in the path.
|
||||
* - ::rename: Moves the file at one given path to another given path.
|
||||
* - ::utime: Sets the access time and modification time of each file
|
||||
* at the given paths.
|
||||
* - #flock: Locks or unlocks +self+.
|
||||
*
|
||||
* === Other
|
||||
*
|
||||
* - ::truncate:: Truncates the file at the given file path to the given size.
|
||||
* - ::unlink (aliased as ::delete):: Deletes the file for each given file path.
|
||||
* - #truncate:: Truncates +self+ to the given size.
|
||||
* - ::truncate: Truncates the file at the given file path to the given size.
|
||||
* - ::unlink (aliased as ::delete): Deletes the file for each given file path.
|
||||
* - #truncate: Truncates +self+ to the given size.
|
||||
*
|
||||
*/
|
||||
|
||||
|
|
Loading…
Reference in a new issue