PATH:
opt
/
alt
/
ruby34
/
share
/
ri
/
system
/
FileUtils
U:RDoc::AnyMethod[iI" touch:ETI"FileUtils#touch;TF:privateo:RDoc::Markup::Document:@parts[o:RDoc::Markup::Paragraph; [ I"AUpdates modification times (mtime) and access times (atime) ;TI"1of the entries given by the paths in +list+ ;TI"+(a single path or an array of paths); ;TI"Areturns +list+ if it is an array, <tt>[list]</tt> otherwise.;To:RDoc::Markup::BlankLine o; ; [I"MBy default, creates an empty file for any path to a non-existent entry; ;TI"Cuse keyword argument +nocreate+ to raise an exception instead.;T@o; ; [I"%Argument +list+ or its elements ;TI"Kshould be {interpretable as paths}[rdoc-ref:FileUtils@Path+Arguments].;T@o; ; [I"Examples:;T@o:RDoc::Markup::Verbatim; [I"# Single path. ;TI"/f = File.new('src0.txt') # Existing file. ;TI"3f.atime # => 2022-06-10 11:11:21.200277 -0700 ;TI"3f.mtime # => 2022-06-10 11:11:21.200277 -0700 ;TI"!FileUtils.touch('src0.txt') ;TI"f = File.new('src0.txt') ;TI"4f.atime # => 2022-06-11 08:28:09.8185343 -0700 ;TI"4f.mtime # => 2022-06-11 08:28:09.8185343 -0700 ;TI" ;TI"# Array of paths. ;TI"/FileUtils.touch(['src0.txt', 'src0.dat']) ;T:@format0o; ; [I"Keyword arguments:;T@o:RDoc::Markup::List: @type:BULLET:@items[ o:RDoc::Markup::ListItem:@label0; [o; ; [I"M<tt>mtime: <i>time</i></tt> - sets the entry's mtime to the given time, ;TI"!instead of the current time.;To;;0; [o; ; [I"O<tt>nocreate: true</tt> - raises an exception if the entry does not exist.;To;;0; [o; ; [I"A<tt>noop: true</tt> - does not touch entries; returns +nil+.;To;;0; [o; ; [I";<tt>verbose: true</tt> - prints an equivalent command:;T@o;; [I"<FileUtils.touch('src0.txt', noop: true, verbose: true) ;TI"JFileUtils.touch(['src0.txt', 'src0.dat'], noop: true, verbose: true) ;TI"6FileUtils.touch(path, noop: true, verbose: true) ;T; 0o; ; [I"Output:;T@o;; [I"touch src0.txt ;TI"touch src0.txt src0.dat ;TI"touch src0.txt ;T; 0o; ; [I""Related: FileUtils.uptodate?.;T: @fileI"lib/fileutils.rb;T:0@omit_headings_from_table_of_contents_below000[ I"?(list, noop: nil, verbose: nil, mtime: nil, nocreate: nil);T@TFI"FileUtils;TcRDoc::NormalModule00
[+]
..
[+]
NoWrite
[-] symlink-c.ri
[edit]
[-] makedirs-c.ri
[edit]
[-] chmod-i.ri
[edit]
[-] copy_stream-c.ri
[edit]
[-] cp-i.ri
[edit]
[-] copy_stream-i.ri
[edit]
[-] rm_rf-i.ri
[edit]
[-] remove_file-i.ri
[edit]
[-] ln_sr-i.ri
[edit]
[-] rm-c.ri
[edit]
[-] link-i.ri
[edit]
[-] copy_file-i.ri
[edit]
[-] collect_method-c.ri
[edit]
[-] cp_lr-i.ri
[edit]
[-] ln-c.ri
[edit]
[-] link_entry-c.ri
[edit]
[-] copy_entry-c.ri
[edit]
[-] rm_rf-c.ri
[edit]
[-] ln_s-i.ri
[edit]
[-] mkpath-i.ri
[edit]
[-] rm_r-i.ri
[edit]
[-] ln-i.ri
[edit]
[-] chmod_R-i.ri
[edit]
[-] move-c.ri
[edit]
[-] cmp-c.ri
[edit]
[-] touch-c.ri
[edit]
[-] getwd-c.ri
[edit]
[-] cd-i.ri
[edit]
[-] remove_entry-c.ri
[edit]
[+]
Verbose
[-] cp_r-i.ri
[edit]
[-] cp-c.ri
[edit]
[-] cdesc-FileUtils.ri
[edit]
[-] mkdir-c.ri
[edit]
[-] cp_r-c.ri
[edit]
[-] rmdir-c.ri
[edit]
[-] mkdir_p-i.ri
[edit]
[-] remove_dir-i.ri
[edit]
[-] rmdir-i.ri
[edit]
[-] chdir-c.ri
[edit]
[-] compare_file-i.ri
[edit]
[-] copy-i.ri
[edit]
[-] ln_sr-c.ri
[edit]
[-] chmod_R-c.ri
[edit]
[-] mkpath-c.ri
[edit]
[-] compare_file-c.ri
[edit]
[-] compare_stream-i.ri
[edit]
[-] remove_entry-i.ri
[edit]
[-] uptodate%3f-c.ri
[edit]
[-] options_of-c.ri
[edit]
[-] mv-i.ri
[edit]
[-] identical%3f-c.ri
[edit]
[-] remove-i.ri
[edit]
[-] chown_R-i.ri
[edit]
[-] touch-i.ri
[edit]
[-] rm_f-i.ri
[edit]
[-] link_entry-i.ri
[edit]
[-] rm-i.ri
[edit]
[-] install-i.ri
[edit]
[-] remove_entry_secure-i.ri
[edit]
[-] ln_sf-i.ri
[edit]
[-] chown-i.ri
[edit]
[-] remove_dir-c.ri
[edit]
[-] safe_unlink-i.ri
[edit]
[+]
DryRun
[-] ln_sf-c.ri
[edit]
[-] install-c.ri
[edit]
[-] options-c.ri
[edit]
[-] getwd-i.ri
[edit]
[-] chmod-c.ri
[edit]
[-] chdir-i.ri
[edit]
[-] move-i.ri
[edit]
[-] remove_entry_secure-c.ri
[edit]
[-] cd-c.ri
[edit]
[-] compare_stream-c.ri
[edit]
[-] commands-c.ri
[edit]
[-] symlink-i.ri
[edit]
[-] mkdir-i.ri
[edit]
[-] rmtree-c.ri
[edit]
[-] link-c.ri
[edit]
[-] copy_entry-i.ri
[edit]
[-] copy_file-c.ri
[edit]
[-] pwd-c.ri
[edit]
[-] rmtree-i.ri
[edit]
[-] safe_unlink-c.ri
[edit]
[-] chown_R-c.ri
[edit]
[-] have_option%3f-c.ri
[edit]
[-] cmp-i.ri
[edit]
[-] mkdir_p-c.ri
[edit]
[-] chown-c.ri
[edit]
[-] remove-c.ri
[edit]
[-] remove_file-c.ri
[edit]
[-] makedirs-i.ri
[edit]
[-] mv-c.ri
[edit]
[-] pwd-i.ri
[edit]
[-] copy-c.ri
[edit]
[-] ln_s-c.ri
[edit]
[-] rm_f-c.ri
[edit]
[-] cp_lr-c.ri
[edit]
[-] uptodate%3f-i.ri
[edit]
[-] rm_r-c.ri
[edit]
[-] identical%3f-i.ri
[edit]