ruby-changes:71515
From: Burdette <ko1@a...>
Date: Sat, 26 Mar 2022 02:17:06 +0900 (JST)
Subject: [ruby-changes:71515] d0b7df8153 (master): Fix formatting of What's Here for File (#5717)
https://git.ruby-lang.org/ruby.git/commit/?id=d0b7df8153 From d0b7df81535a0201a17adc74d6731253cd70689e Mon Sep 17 00:00:00 2001 From: Burdette Lamar <BurdetteLamar@Y...> Date: Fri, 25 Mar 2022 12:16:37 -0500 Subject: Fix formatting of What's Here for File (#5717) --- file.c | 186 ++++++++++++++++++++++++++++++++--------------------------------- 1 file changed, 93 insertions(+), 93 deletions(-) diff --git a/file.c b/file.c index 990ae4fc64..e65e548c9a 100644 --- a/file.c +++ b/file.c @@ -6591,119 +6591,119 @@ const char ruby_null_device[] = https://github.com/ruby/ruby/blob/trunk/file.c#L6591 * * === 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 (... truncated) -- ML: ruby-changes@q... Info: http://www.atdot.net/~ko1/quickml/