PATH:
opt
/
alt
/
ruby34
/
share
/
ri
/
system
/
FileUtils
U:RDoc::AnyMethod[iI" ln_s:ETI"FileUtils#ln_s;TF:privateo:RDoc::Markup::Document:@parts[o:RDoc::Markup::Paragraph; [I"KCreates {symbolic links}[https://en.wikipedia.org/wiki/Symbolic_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".If +src+ is the path to an existing file:;T@o:RDoc::Markup::List: @type:BULLET:@items[o:RDoc::Markup::ListItem:@label0; [o; ; [I"5When +dest+ is the path to a non-existent file, ;TI"9creates a symbolic link at +dest+ pointing to +src+:;T@o:RDoc::Markup::Verbatim; [ I"!FileUtils.touch('src0.txt') ;TI"+File.exist?('dest0.txt') # => false ;TI"-FileUtils.ln_s('src0.txt', 'dest0.txt') ;TI"*File.symlink?('dest0.txt') # => true ;T:@format0o;;0; [o; ; [ I"2When +dest+ is the path to an existing file, ;TI"9creates a symbolic link at +dest+ pointing to +src+ ;TI"Cif and only if keyword argument <tt>force: true</tt> is given ;TI"%(raises an exception otherwise):;T@o;; [I"!FileUtils.touch('src1.txt') ;TI""FileUtils.touch('dest1.txt') ;TI":FileUtils.ln_s('src1.txt', 'dest1.txt', force: true) ;TI".FileTest.symlink?('dest1.txt') # => true ;TI" ;TI"EFileUtils.ln_s('src1.txt', 'dest1.txt') # Raises Errno::EEXIST. ;T;0o; ; [I"+If +dest+ is the path to a directory, ;TI"Dcreates a symbolic link at <tt>dest/src</tt> pointing to +src+:;T@o;; [ I"!FileUtils.touch('src2.txt') ;TI"!FileUtils.mkdir('destdir2') ;TI",FileUtils.ln_s('src2.txt', 'destdir2') ;TI"2File.symlink?('destdir2/src2.txt') # => true ;T;0o; ; [I"PIf +src+ is an array of paths to existing files and +dest+ is a directory, ;TI"Qfor each child +child+ in +src+ creates a symbolic link <tt>dest/child</tt> ;TI"pointing to +child+:;T@o;; [I" FileUtils.mkdir('srcdir3') ;TI")FileUtils.touch('srcdir3/src0.txt') ;TI")FileUtils.touch('srcdir3/src1.txt') ;TI"!FileUtils.mkdir('destdir3') ;TI"JFileUtils.ln_s(['srcdir3/src0.txt', 'srcdir3/src1.txt'], 'destdir3') ;TI"2File.symlink?('destdir3/src0.txt') # => true ;TI"2File.symlink?('destdir3/src1.txt') # => true ;T;0o; ; [I"Keyword arguments:;T@o;; ;;[ o;;0; [o; ; [I";<tt>force: true</tt> - overwrites +dest+ if it exists.;To;;0; [o; ; [I"@<tt>relative: false</tt> - create links relative to +dest+.;To;;0; [o; ; [I"1<tt>noop: true</tt> - does not create links.;To;;0; [o; ; [I";<tt>verbose: true</tt> - prints an equivalent command:;T@o;; [ I"HFileUtils.ln_s('src0.txt', 'dest0.txt', noop: true, verbose: true) ;TI"GFileUtils.ln_s('src1.txt', 'destdir1', noop: true, verbose: true) ;TI"UFileUtils.ln_s('src2.txt', 'dest2.txt', force: true, noop: true, verbose: true) ;TI"eFileUtils.ln_s(['srcdir3/src0.txt', 'srcdir3/src1.txt'], 'destdir3', noop: true, verbose: true) ;T;0o; ; [I"Output:;T@o;; [ I"ln -s src0.txt dest0.txt ;TI"ln -s src1.txt destdir1 ;TI"ln -sf src2.txt dest2.txt ;TI"6ln -s srcdir3/src0.txt srcdir3/src1.txt destdir3 ;T;0o; ; [I"Related: FileUtils.ln_sf.;T: @fileI"lib/fileutils.rb;T:0@omit_headings_from_table_of_contents_below000[[I"symlink;To;; [ ;@x;0I"^(src, dest, force: nil, relative: false, target_directory: true, noop: nil, verbose: nil);T@xFI"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]