doxygen: various warning fixes

Fixes such warnings:
mc/src/viewer/mcviewer.h:1: Warning: the name `view.h' supplied as the second argument
                            in the \file statement is not an input file
mc/vfs/vfs.c:267: Warning: explicit link request to 'op' could not be resolved
mc/src/strescape.c:219: Warning: Found unknown command `\params'
mc/src/strescape.c:153: Warning: Found unknown command `\params'
mc/src/strescape.c:187: Warning: Found unknown command `\params'
mc/src/strescape.c:219: Warning: Found unknown command `\params'
mc/src/strescape.c:153: Warning: Found unknown command `\params'
mc/src/strescape.c:187: Warning: Found unknown command `\params'
mc/vfs/fish.c:33: Warning: explicit link request to 'sh' could not be resolved
mc/vfs/fish.c:33: Warning: Found unknown command `\host'
mc/vfs/ftpfs.c:43: Warning: Found unknown command `\hobit'
mc/vfs/sfs.c:26: Warning: explicit link request to 'ugz' could not be resolved
mc/vfs/vfs.c:267: Warning: explicit link request to 'op' could not be resolved
mc/vfs/vfs.c:267: Warning: explicit link request to 'op' could not be resolved

Signed-off-by: Sergei Trofimovich <slyfox@inbox.ru>

src/strescape.c

@@ -153,7 +153,7 @@ strutils_unescape (const char *src, gsize src_len, const char *unescaped_chars,
 /** To be compatible with the general posix command lines we have to escape
  strings for the command line
 
- \params in
+ \param src
  string for escaping
 
  \returns
@@ -187,7 +187,7 @@ strutils_regex_escape (const char *src)
 /** Unescape paths or other strings for e.g the internal cd
     shell-unescape within a given buffer (writing to it!)
 
- \params src
+ \param text
  string for unescaping
 
  \returns
@@ -218,9 +218,12 @@ strutils_regex_unescape (const char *text)
 
 /** Check if char in pointer contain escape'd chars
 
- \params in
+ \param start
  string for checking
 
+ \param current
+ pointer to checked character
+
  \returns
  return TRUE if string contain escaped chars
  otherwise return FALSE

src/viewer/mcviewer.h

@@ -1,4 +1,4 @@
-/** \file view.h
+/** \file mcviewer.h
  *  \brief Header: internal file viewer
  */
 

vfs/fish.c

@@ -34,7 +34,7 @@
  * Derived from ftpfs.c
  * Read README.fish for protocol specification.
  *
- * Syntax of path is: /#sh:user@host[:Cr]/path
+ * Syntax of path is: \verbatim /#sh:user@host[:Cr]/path \endverbatim
  *      where C means you want compressed connection,
  *      and r means you want to use rsh
  *

vfs/ftpfs.c

@@ -44,11 +44,14 @@ What to do with this?
 
 
      * NOTE: Usage of tildes is deprecated, consider:
-     * cd /#ftp:pavel@hobit
-     * cd ~
+     * \verbatim
+         cd /#ftp:pavel@hobit
+         cd ~
+       \endverbatim
      * And now: what do I want to do? Do I want to go to /home/pavel or to
      * /#ftp:hobit/home/pavel? I think first has better sense...
      *
+    \verbatim
     {
         int f = !strcmp( remote_path, "/~" );
 	if (f || !strncmp( remote_path, "/~/", 3 )) {
@@ -58,8 +61,7 @@ What to do with this?
 	    remote_path = s;
 	}
     }
-
-
+    \endverbatim
  */
 
 /* \todo Fix: Namespace pollution: horrible */

vfs/sfs.c

@@ -27,7 +27,7 @@
  * inside. It is somehow similar to extfs, except that extfs makes
  * whole virtual trees and we do only single virtual files.
  *
- * If you want to gunzip something, you should open it with #ugz
+ * If you want to gunzip something, you should open it with \verbatim #ugz \endverbatim
  * suffix, DON'T try to gunzip it yourself.
  *
  * Namespace: exports vfs_sfs_ops

vfs/vfs.c

@@ -265,7 +265,13 @@ path_magic (const char *path)
 }
 
 /**
- * Splits path '/p1#op/inpath' into inpath,op; returns which vfs it is.
+ * Splits path extracting vfs part.
+ *
+ * Splits path
+ * \verbatim /p1#op/inpath \endverbatim
+ * into
+ * \verbatim inpath,op; \endverbatim
+ * returns which vfs it is.
  * What is left in path is p1. You still want to g_free(path), you DON'T
  * want to free neither *inpath nor *op
  */