From be1de4f8db9626be0341d588b6b36aaae06a52d2 Mon Sep 17 00:00:00 2001
From: gsinclair <gsinclair@b2dd03c8-39d4-4d8f-98ff-823fe69b080e>
Date: Fri, 13 Feb 2004 12:53:42 +0000
Subject: [PATCH]   * 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
---
 ChangeLog        |  4 ++++
 lib/fileutils.rb | 23 +++++++++--------------
 2 files changed, 13 insertions(+), 14 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 7194b15b3c..129f1e9bfd 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+Fri Feb 13 21:51:00 2004  Gavin Sinclair <gsinclair@soyabean.com.au>
+
+	* lib/fileutils.rb: slighly improved documentation (sync with 1.8)
+
 Fri Feb 13 19:57:01 2004  Kouhei Sutou  <kou@cozmixng.org>
 
 	* test/rss/test_trackback.rb: added tests for TrackBack with RSS
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.