U:RDoc::AnyMethod[iI"shellescape:EFI"Shellwords#shellescape;TF: privateo:RDoc::Markup::Document: @parts[o:RDoc::Markup::Paragraph; [I"FEscapes a string so that it can be safely used in a Bourne shell ;TI"Fcommand line. +str+ can be a non-string object that responds to ;TI" +to_s+.;To:RDoc::Markup::BlankLineo; ; [I"DNote that a resulted string should be used unquoted and is not ;TI" "It\\'s\\ better\\ to\\ give\\ than\\ to\\ receive" ;T: @format0o; ; [I"9String#shellescape is a shorthand for this function.;T@o; ; [I">argv = "It's better to give than to receive".shellescape ;TI"Bargv #=> "It\\'s\\ better\\ to\\ give\\ than\\ to\\ receive" ;TI" ;TI"2# Search files in lib for method definitions ;TI"pattern = "^[ \t]*def " ;TI"=open("| grep -Ern #{pattern.shellescape} lib") { |grep| ;TI" grep.each_line { |line| ;TI"9 file, lineno, matched_line = line.split(':', 3) ;TI" # ... ;TI" } ;TI"} ;T; 0o; ; [I"IIt is the caller's responsibility to encode the string in the right ;TI"Bencoding for the shell environment where this string is used.;T@o; ; [I"LMultibyte characters are treated as multibyte characters, not as bytes.;T@o; ; [I"BReturns an empty quoted String if +str+ has a length of zero.;T: @fileI"lib/shellwords.rb;T:0@omit_headings_from_table_of_contents_below000[[I" escape;Fo;; [;@3;0I" (str);T@3FI"Shellwords;FcRDoc::NormalModule00