cleaned out idiotic commenting of FUNCDEF, which had been done when a strict compile
[feisty_meow.git] / nucleus / library / filesystem / filename.h
index a6018ef53313ab4488e3449dcb9a491454db1d36..9c4eb56beb7b9a582f70e5881dbba7951fcbf9b3 100644 (file)
@@ -23,8 +23,7 @@
 // forward declarations.
 class status_info;
 
-//hmmm: this doesn't really belong here, does it.
-
+//hmmm: this doesn't really belong here, does it...
 // define useful constant for filesystem path length.
 #ifndef MAX_ABS_PATH 
   #ifdef __WIN32__
@@ -142,6 +141,10 @@ public:
   bool is_readable() const;
   bool is_executable() const;
 
+  // is_normal makes sure that the file or directory is not a named pipe or other
+  // special type of file.  symbolic links are considered normal.
+  bool is_normal() const;
+
   enum write_modes {
     ALLOW_NEITHER = 0x0,
     ALLOW_READ = 0x1, ALLOW_WRITE = 0x2,
@@ -183,10 +186,12 @@ public:
     character that is substituted instead of illegal characters. */
 
   void separate(structures::string_array &pieces) const;
-    //!< breaks the filename into its component directories.
+    //!< breaks the filename into its component parts.
     /*!< this returns an array containing the component names.  the last
     component, unless the filename held is actually a directory, should be the
-    name of the file.  if the first character is a directory, then the first
+    name of the file.
+//hmmm: what does this mean, below?
+  if the first character is a directory, then the first
     component will be empty. */
 
   void join(const structures::string_array &pieces);