PATH:
opt
/
alt
/
ruby34
/
share
/
ri
/
system
/
FileUtils
U:RDoc::AnyMethod[iI" cp_r:ETI"FileUtils::cp_r;TT:publico:RDoc::Markup::Document:@parts[o:RDoc::Markup::Paragraph; [I"Recursively copies files.;To:RDoc::Markup::BlankLine o; ; [I":Arguments +src+ (a single path or an array of paths) ;TI" and +dest+ (a single path) ;TI"Kshould be {interpretable as paths}[rdoc-ref:FileUtils@Path+Arguments].;T@o; ; [I":The mode, owner, and group are retained in the copy; ;TI"4to change those, use FileUtils.install instead.;T@o; ; [I"OIf +src+ is the path to a file and +dest+ is not the path to a directory, ;TI"copies +src+ to +dest+:;T@o:RDoc::Markup::Verbatim; [ I"!FileUtils.touch('src0.txt') ;TI")File.exist?('dest0.txt') # => false ;TI"-FileUtils.cp_r('src0.txt', 'dest0.txt') ;TI"(File.file?('dest0.txt') # => true ;T:@format0o; ; [I"KIf +src+ is the path to a file and +dest+ is the path to a directory, ;TI"'copies +src+ to <tt>dest/src</tt>:;T@o;; [ I"!FileUtils.touch('src1.txt') ;TI"FileUtils.mkdir('dest1') ;TI")FileUtils.cp_r('src1.txt', 'dest1') ;TI",File.file?('dest1/src1.txt') # => true ;T; 0o; ; [I"DIf +src+ is the path to a directory and +dest+ does not exist, ;TI"(recursively copies +src+ to +dest+:;T@o;; [I"tree('src2') ;TI"# => src2 ;TI"# |-- dir0 ;TI"# | |-- src0.txt ;TI"# | `-- src1.txt ;TI"# `-- dir1 ;TI"# |-- src2.txt ;TI"# `-- src3.txt ;TI"*FileUtils.exist?('dest2') # => false ;TI"%FileUtils.cp_r('src2', 'dest2') ;TI"tree('dest2') ;TI"# => dest2 ;TI"# |-- dir0 ;TI"# | |-- src0.txt ;TI"# | `-- src1.txt ;TI"# `-- dir1 ;TI"# |-- src2.txt ;TI"# `-- src3.txt ;T; 0o; ; [I"3If +src+ and +dest+ are paths to directories, ;TI"3recursively copies +src+ to <tt>dest/src</tt>:;T@o;; [I"tree('src3') ;TI"# => src3 ;TI"# |-- dir0 ;TI"# | |-- src0.txt ;TI"# | `-- src1.txt ;TI"# `-- dir1 ;TI"# |-- src2.txt ;TI"# `-- src3.txt ;TI"FileUtils.mkdir('dest3') ;TI"%FileUtils.cp_r('src3', 'dest3') ;TI"tree('dest3') ;TI"# => dest3 ;TI"# `-- src3 ;TI"# |-- dir0 ;TI"# | |-- src0.txt ;TI"# | `-- src1.txt ;TI"# `-- dir1 ;TI"# |-- src2.txt ;TI"# `-- src3.txt ;T; 0o; ; [I">If +src+ is an array of paths and +dest+ is a directory, ;TI";recursively copies from each path in +src+ to +dest+; ;TI">the paths in +src+ may point to files and/or directories.;T@o; ; [I"Keyword arguments:;T@o:RDoc::Markup::List: @type:BULLET:@items[ o:RDoc::Markup::ListItem:@label0; [o; ; [I"E<tt>dereference_root: false</tt> - if +src+ is a symbolic link, ;TI"does not dereference it.;To;;0; [o; ; [I"/<tt>noop: true</tt> - does not copy files.;To;;0; [o; ; [I"4<tt>preserve: true</tt> - preserves file times.;To;;0; [o; ; [I"M<tt>remove_destination: true</tt> - removes +dest+ before copying files.;To;;0; [o; ; [I";<tt>verbose: true</tt> - prints an equivalent command:;T@o;; [ I"HFileUtils.cp_r('src0.txt', 'dest0.txt', noop: true, verbose: true) ;TI"DFileUtils.cp_r('src1.txt', 'dest1', noop: true, verbose: true) ;TI"@FileUtils.cp_r('src2', 'dest2', noop: true, verbose: true) ;TI"@FileUtils.cp_r('src3', 'dest3', noop: true, verbose: true) ;T; 0o; ; [I"Output:;T@o;; [ I"cp -r src0.txt dest0.txt ;TI"cp -r src1.txt dest1 ;TI"cp -r src2 dest2 ;TI"cp -r src3 dest3 ;T; 0o; ; [I"=Raises an exception of +src+ is the path to a directory ;TI"&and +dest+ is the path to a file.;T@o; ; [I"@Related: {methods for copying}[rdoc-ref:FileUtils@Copying].;T: @fileI"lib/fileutils.rb;T:0@omit_headings_from_table_of_contents_below000[ I"i(src, dest, preserve: nil, noop: nil, verbose: nil, dereference_root: true, remove_destination: nil);T@�FI"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]