From be1de4f8db9626be0341d588b6b36aaae06a52d2 Mon Sep 17 00:00:00 2001 From: gsinclair Date: Fri, 13 Feb 2004 12:53:42 +0000 Subject: * lib/fileutils.rb: slighly improved documentation (sync with 1.8) git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@5692 b2dd03c8-39d4-4d8f-98ff-823fe69b080e --- lib/fileutils.rb | 23 +++++++++-------------- 1 file changed, 9 insertions(+), 14 deletions(-) (limited to 'lib/fileutils.rb') diff --git a/lib/fileutils.rb b/lib/fileutils.rb index f888681685..149687c44f 100644 --- a/lib/fileutils.rb +++ b/lib/fileutils.rb @@ -37,9 +37,9 @@ # touch(list, options) # # The options parameter is a hash of options, taken from the list -# +:force+, +:noop+, +:preserve+, and +:verbose+. +:noop+ means that no changes -# are made. The other two are obvious. Each method documents the options that -# it honours. +# :force, :noop, :preserve, and :verbose. +# :noop means that no changes are made. The other two are obvious. +# Each method documents the options that it honours. # # All methods that have the concept of a "source" file or directory can take # either one file or a list of files in that argument. See the method @@ -56,14 +56,14 @@ # == module FileUtils::Verbose # # This module has all methods of FileUtils module, but it outputs messages -# before acting. This equates to passing the +:verbose+ flag to methods in -# FileUtils. +# before acting. This equates to passing the :verbose flag to methods +# in FileUtils. # # == module FileUtils::NoWrite # # This module has all methods of FileUtils module, but never changes -# files/directories. This equates to passing the +:noop+ flag to methods in -# FileUtils. +# files/directories. This equates to passing the :noop flag to methods +# in FileUtils. # @@ -820,7 +820,7 @@ module FileUtils # # This module has all methods of FileUtils module, but it outputs messages - # before acting. This equates to passing the +:verbose+ flag to methods in + # before acting. This equates to passing the :verbose flag to methods in # FileUtils. # module Verbose @@ -848,7 +848,7 @@ module FileUtils # # This module has all methods of FileUtils module, but never changes - # files/directories. This equates to passing the +:noop+ flag to methods in + # files/directories. This equates to passing the :noop flag to methods in # FileUtils. # module NoWrite @@ -877,8 +877,3 @@ module FileUtils end - -# Documentation comments: -# - Some RDoc markup used here doesn't work (namely, +file1+, +:noop+, -# +dir/file+). I consider this a bug and expect that these will be valid in -# the near future. -- cgit v1.2.3