[valadoc] libvaladoc: Add API documentation for file utils

[Florian Brosch <flobrosch src gnome org>]

commit f36f3f90aa35dfc01b3b2a4b6ce8cf4e4a74d3d2
Author: Florian Brosch <flo brosch gmail com>
Date:   Mon Feb 28 01:47:35 2011 +0100

    libvaladoc: Add API documentation for file utils

 src/libvaladoc/filehelper.vala |   23 +++++++++++++++++++++++
 1 files changed, 23 insertions(+), 0 deletions(-)
---
diff --git a/src/libvaladoc/filehelper.vala b/src/libvaladoc/filehelper.vala
index edd47bf..d8b2ef6 100755
--- a/src/libvaladoc/filehelper.vala
+++ b/src/libvaladoc/filehelper.vala
@@ -26,6 +26,12 @@ namespace Valadoc {
 	[CCode (cprefix = "", cname = "PACKAGE_ICONDIR")]
 	public extern const string icons_dir;
 
+	/**
+	 * Makes a copy of the file src to dest. 
+	 *
+	 * @param src the file to copy
+	 * @param dest the destination path
+	 */
 	public bool copy_file (string src, string dest) {
 		GLib.FileStream fsrc = GLib.FileStream.open (src, "rb");
 		if (fsrc == null) {
@@ -44,6 +50,12 @@ namespace Valadoc {
 		return true;
 	}
 
+	/**
+	 * Makes a copy of the directory src to dest. 
+	 *
+	 * @param src the directory to copy
+	 * @param dest the destination path
+	 */
 	public bool copy_directory (string src, string dest) {
 		string _src = (src.has_suffix ( "/" ))? src : src + "/";
 		string _dest = (dest.has_suffix ( "/" ))? dest : dest + "/";
@@ -62,6 +74,11 @@ namespace Valadoc {
 		return true;
 	}
 
+	/**
+	 * A recursive directory delete function
+	 *
+	 * @param rpath the directory to remove
+	 */
 	public bool remove_directory (string rpath) {
 		try {
 			GLib.Dir dir = GLib.Dir.open ( rpath );
@@ -91,6 +108,12 @@ namespace Valadoc {
 		return true;
 	}
 
+	/**
+	 * Returns canonicalized absolute pathname
+	 *
+	 * @param basedir the path being checked
+	 * @return a canonicalized absolute pathname
+	 */
 	public string realpath (string basedir) {
 		return Vala.CodeContext.realpath (basedir);
 	}