1#@!#!123s

��JFIF�� 1#@!#!123s
: / proc / self / root / opt / alt / ruby34 / share / ri / system / FileUtils /
Filename : cp_lr-i.ri
back
U:RDoc::AnyMethod[iI"
cp_lr:ETI"FileUtils#cp_lr;TF:privateo:RDoc::Markup::Document:@parts[o:RDoc::Markup::Paragraph;	[I"CCreates {hard links}[https://en.wikipedia.org/wiki/Hard_link].;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"DIf +src+ is the path to a directory and +dest+ does not exist, ;TI"Pcreates links +dest+ and descendents pointing to +src+ and its descendents:;T@o:RDoc::Markup::Verbatim;	[I"tree('src0')
;TI"# => src0
;TI"#    |-- sub0
;TI"#    |   |-- src0.txt
;TI"#    |   `-- src1.txt
;TI"#    `-- sub1
;TI"#        |-- src2.txt
;TI"#        `-- src3.txt
;TI"%File.exist?('dest0') # => false
;TI"&FileUtils.cp_lr('src0', 'dest0')
;TI"tree('dest0')
;TI"# => dest0
;TI"#    |-- sub0
;TI"#    |   |-- src0.txt
;TI"#    |   `-- src1.txt
;TI"#    `-- sub1
;TI"#        |-- src2.txt
;TI"#        `-- src3.txt
;T:@format0o;
;	[I"8If +src+ and +dest+ are both paths to directories, ;TI"5creates links <tt>dest/src</tt> and descendents ;TI"+pointing to +src+ and its descendents:;T@o;;	[I"tree('src1')
;TI"# => src1
;TI"#    |-- sub0
;TI"#    |   |-- src0.txt
;TI"#    |   `-- src1.txt
;TI"#    `-- sub1
;TI"#        |-- src2.txt
;TI"#        `-- src3.txt
;TI"FileUtils.mkdir('dest1')
;TI"&FileUtils.cp_lr('src1', 'dest1')
;TI"tree('dest1')
;TI"# => dest1
;TI"#    `-- src1
;TI"#        |-- sub0
;TI"#        |   |-- src0.txt
;TI"#        |   `-- src1.txt
;TI"#        `-- sub1
;TI"#            |-- src2.txt
;TI"#            `-- src3.txt
;T;
0o;
;	[I"UIf +src+ is an array of paths to entries and +dest+ is the path to a directory, ;TI"Qfor each path +filepath+ in +src+, creates a link at <tt>dest/filepath</tt> ;TI"pointing to that path:;T@o;;	[I"tree('src2')
;TI"# => src2
;TI"#    |-- sub0
;TI"#    |   |-- src0.txt
;TI"#    |   `-- src1.txt
;TI"#    `-- sub1
;TI"#        |-- src2.txt
;TI"#        `-- src3.txt
;TI"FileUtils.mkdir('dest2')
;TI":FileUtils.cp_lr(['src2/sub0', 'src2/sub1'], 'dest2')
;TI"tree('dest2')
;TI"# => dest2
;TI"#    |-- sub0
;TI"#    |   |-- src0.txt
;TI"#    |   `-- src1.txt
;TI"#    `-- sub1
;TI"#        |-- src2.txt
;TI"#        `-- src3.txt
;T;
0o;
;	[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"1<tt>noop: true</tt> - does not create links.;To;;0;	[o;
;	[I"N<tt>remove_destination: true</tt> - removes +dest+ before creating links.;To;;0;	[o;
;	[I";<tt>verbose: true</tt> - prints an equivalent command:;T@o;;	[I"AFileUtils.cp_lr('src0', 'dest0', noop: true, verbose: true)
;TI"AFileUtils.cp_lr('src1', 'dest1', noop: true, verbose: true)
;TI"UFileUtils.cp_lr(['src2/sub0', 'src2/sub1'], 'dest2', noop: true, verbose: true)
;T;
0o;
;	[I"Output:;T@o;;	[I"cp -lr src0 dest0
;TI"cp -lr src1 dest1
;TI"&cp -lr src2/sub0 src2/sub1 dest2
;T;
0o;
;	[I"PRaises an exception if +dest+ is the path to an existing file or directory ;TI"Iand keyword argument <tt>remove_destination: true</tt> is not given.;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"\(src, dest, noop: nil, verbose: nil, dereference_root: true, remove_destination: false);T@�FI"FileUtils;TcRDoc::NormalModule00