summaryrefslogtreecommitdiff
path: root/lib/fileutils.rb
diff options
context:
space:
mode:
authorgsinclair <gsinclair@b2dd03c8-39d4-4d8f-98ff-823fe69b080e>2004-02-13 12:53:42 +0000
committergsinclair <gsinclair@b2dd03c8-39d4-4d8f-98ff-823fe69b080e>2004-02-13 12:53:42 +0000
commitbe1de4f8db9626be0341d588b6b36aaae06a52d2 (patch)
treed5b24be88d8c4bb7e12eda9c6b307d7ab9fc30c6 /lib/fileutils.rb
parentc0306157d9dbb12447ba5288b8a2db73b2beef11 (diff)
* 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
Diffstat (limited to 'lib/fileutils.rb')
-rw-r--r--lib/fileutils.rb23
1 files changed, 9 insertions, 14 deletions
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 <tt>options</tt> 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.
+# <tt>:force</tt>, <tt>:noop</tt>, <tt>:preserve</tt>, and <tt>:verbose</tt>.
+# <tt>:noop</tt> 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 <tt>:verbose</tt> 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 <tt>:noop</tt> 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 <tt>:verbose</tt> 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 <tt>:noop</tt> 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.