Fix formatting of What's Here for File (#5717)

This commit is contained in:
Burdette Lamar 2022-03-25 12:16:37 -05:00 committed by GitHub
parent 52793c007b
commit d0b7df8153
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
Notes: git 2022-03-26 02:16:56 +09:00
Merged-By: BurdetteLamar <BurdetteLamar@Yahoo.com>

186
file.c
View File

@ -6591,119 +6591,119 @@ const char ruby_null_device[] =
* *
* === Creating * === Creating
* *
* - ::new:: Opens the file at the given path; returns the file. * - ::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, * - ::open: Same as ::new, but when given a block will yield the file to the block,
* and close the file upon exiting the block. * and close the file upon exiting the block.
* - ::link:: Creates a new name for an existing file using a hard link. * - ::link: Creates a new name for an existing file using a hard link.
* - ::mkfifo:: Returns the FIFO file created at the given path. * - ::mkfifo: Returns the FIFO file created at the given path.
* - ::symlink:: Creates a symbolic link for the given file path. * - ::symlink: Creates a symbolic link for the given file path.
* *
* === Querying * === Querying
* *
* _Paths_ * _Paths_
* *
* - ::absolute_path:: Returns the absolute file path for 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. * - ::absolute_path?: Returns whether the given path is the absolute file path.
* - ::basename:: Returns the last component of the given file path. * - ::basename: Returns the last component of the given file path.
* - ::dirname:: Returns all but 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, * - ::expand_path: Returns the absolute file path for the given path,
* expanding <tt>~</tt> for a home directory. * expanding <tt>~</tt> for a home directory.
* - ::extname:: Returns the file extension for the given file path. * - ::extname: Returns the file extension for the given file path.
* - ::fnmatch? (aliased as ::fnmatch):: Returns whether the given file path * - ::fnmatch? (aliased as ::fnmatch): Returns whether the given file path
* matches the given pattern. * matches the given pattern.
* - ::join:: Joins path components into a single path string. * - ::join: Joins path components into a single path string.
* - ::path:: Returns the string representation of the given path. * - ::path: Returns the string representation of the given path.
* - ::readlink:: Returns the path to the file at the given symbolic link. * - ::readlink: Returns the path to the file at the given symbolic link.
* - ::realdirpath:: Returns the real path for the given file path, * - ::realdirpath: Returns the real path for the given file path,
* where the last component need not exist. * where the last component need not exist.
* - ::realpath:: Returns the real path for the given file path, * - ::realpath: Returns the real path for the given file path,
* where all components must exist. * where all components must exist.
* - ::split:: Returns an array of two strings: the directory name and basename * - ::split: Returns an array of two strings: the directory name and basename
* of the file at the given path. * of the file at the given path.
* - #path (aliased as #to_path):: Returns the string representation of the given path. * - #path (aliased as #to_path): Returns the string representation of the given path.
* *
* _Times_ * _Times_
* *
* - ::atime:: Returns a \Time for the most recent access to the given file. * - ::atime: Returns a \Time for the most recent access to the given file.
* - ::birthtime:: Returns a \Time for the creation of 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. * - ::ctime: Returns a \Time for the metadata change of the given file.
* - ::mtime:: Returns a \Time for the most recent data modification to * - ::mtime: Returns a \Time for the most recent data modification to
* the content of the given file. * the content of the given file.
* - #atime:: Returns a \Time for the most recent access to +self+. * - #atime: Returns a \Time for the most recent access to +self+.
* - #birthtime:: Returns a \Time the creation for +self+. * - #birthtime: Returns a \Time the creation for +self+.
* - #ctime:: Returns a \Time for the metadata change of +self+. * - #ctime: Returns a \Time for the metadata change of +self+.
* - #mtime:: Returns a \Time for the most recent data modification * - #mtime: Returns a \Time for the most recent data modification
* to the content of +self+. * to the content of +self+.
* *
* _Types_ * _Types_
* *
* - ::blockdev?:: Returns whether the file at the given path is a block device. * - ::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. * - ::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. * - ::directory?: Returns whether the file at the given path is a diretory.
* - ::executable?:: Returns whether the file at the given path is executable * - ::executable?: Returns whether the file at the given path is executable
* by the effective user and group of the current process. * by the effective user and group of the current process.
* - ::executable_real?:: Returns whether the file at the given path is executable * - ::executable_real?: Returns whether the file at the given path is executable
* by the real user and group of the current process. * by the real user and group of the current process.
* - ::exist?:: Returns whether the file at the given path exists. * - ::exist?: Returns whether the file at the given path exists.
* - ::file?:: Returns whether the file at the given path is a regular file. * - ::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. * - ::ftype: Returns a string giving the type of the file at the given path.
* - ::grpowned?:: Returns whether the effective group of the current process * - ::grpowned?: Returns whether the effective group of the current process
* owns the file at the given path. * owns the file at the given path.
* - ::identical?:: Returns whether the files at two given paths are identical. * - ::identical?: Returns whether the files at two given paths are identical.
* - ::lstat:: Returns the File::Stat object for the last symbolic link * - ::lstat: Returns the File::Stat object for the last symbolic link
* in the given path. * in the given path.
* - ::owned?:: Returns whether the effective user of the current process * - ::owned?: Returns whether the effective user of the current process
* owns the file at the given path. * owns the file at the given path.
* - ::pipe?:: Returns whether the file at the given path is a pipe. * - ::pipe?: Returns whether the file at the given path is a pipe.
* - ::readable?:: Returns whether the file at the given path is readable * - ::readable?: Returns whether the file at the given path is readable
* by the effective user and group of the current process. * by the effective user and group of the current process.
* - ::readable_real?:: Returns whether the file at the given path is readable * - ::readable_real?: Returns whether the file at the given path is readable
* by the real user and group of the current process. * 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. * - ::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. * - ::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. * - ::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. * - ::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. * - ::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. * - ::symlink?: Returns whether the file at the given path is a symbolic link.
* - ::umask:: Returns the umask value for the current process. * - ::umask: Returns the umask value for the current process.
* - ::world_readable?:: Returns whether the file at the given path is readable * - ::world_readable?: Returns whether the file at the given path is readable
* by others. * by others.
* - ::world_writable?:: Returns whether the file at the given path is writable * - ::world_writable?: Returns whether the file at the given path is writable
* by others. * by others.
* - ::writable?:: Returns whether the file at the given path is writable * - ::writable?: Returns whether the file at the given path is writable
* by the effective user and group of the current process. * by the effective user and group of the current process.
* - ::writable_real?:: Returns whether the file at the given path is writable * - ::writable_real?: Returns whether the file at the given path is writable
* by the real user and group of the current process. * by the real user and group of the current process.
* - #lstat:: Returns the File::Stat object for the last symbolic link * - #lstat: Returns the File::Stat object for the last symbolic link
* in the path for +self+. * in the path for +self+.
* *
* _Contents_ * _Contents_
* *
* - ::empty? (aliased as ::zero?):: Returns whether the file at the given path * - ::empty? (aliased as ::zero?): Returns whether the file at the given path
* exists and is empty. * exists and is empty.
* - ::size:: Returns the size (bytes) of the file at the given path. * - ::size: Returns the size (bytes) of the file at the given path.
* - ::size?:: Returns +nil+ if there is no 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). * or if that file is empty; otherwise returns the file size (bytes).
* - #size:: Returns the size (bytes) of +self+. * - #size: Returns the size (bytes) of +self+.
* *
* === Settings * === Settings
* *
* - ::chmod:: Changes permissions of the file at the given path. * - ::chmod: Changes permissions of the file at the given path.
* - ::chown:: Change ownership 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. * - ::lchmod: Changes permissions of the last symbolic link in the given path.
* - ::lchown:: Change ownership of the last symbolic 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 * - ::lutime: For each given file path, sets the access time and modification time
* of the last symbolic link in the path. * of the last symbolic link in the path.
* - ::rename:: Moves the file at one given path to another given path. * - ::rename: Moves the file at one given path to another given path.
* - ::utime:: Sets the access time and modification time of each file * - ::utime: Sets the access time and modification time of each file
* at the given paths. * at the given paths.
* - #flock:: Locks or unlocks +self+. * - #flock: Locks or unlocks +self+.
* *
* === Other * === Other
* *
* - ::truncate:: Truncates the file at the given file path 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. * - ::unlink (aliased as ::delete): Deletes the file for each given file path.
* - #truncate:: Truncates +self+ to the given size. * - #truncate: Truncates +self+ to the given size.
* *
*/ */