1
1

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>
Этот коммит содержится в:
Sergei Trofimovich 2009-12-07 19:38:59 +02:00 коммит произвёл Slava Zanko
родитель d3e91b0711
Коммит 66371454c7
6 изменённых файлов: 22 добавлений и 11 удалений

Просмотреть файл

@ -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

Просмотреть файл

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

Просмотреть файл

@ -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
*

Просмотреть файл

@ -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 */

Просмотреть файл

@ -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

Просмотреть файл

@ -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
*/