fade: Add documentation for main() and include it in doxygen.

The two mixer implementations for OSS and ALSA are also included,
both of which are only used by para_fade. So it makes sense to include
para_fade as well. main() is the only a non-static function, so let's
doxify that.

diff --git a/Doxyfile b/Doxyfile
index 50c74695da5e8c690127511a7b21958972d721e0..df6c87fd3a21f3ca3d754636539903010c74a537 100644 (file)
--- a/Doxyfile
+++ b/Doxyfile
@@ -797,7 +797,6 @@ EXCLUDE_SYMLINKS       = NO
 
 EXCLUDE_PATTERNS       = *.cmdline.* \
                          gcc-compat.h \
 
 EXCLUDE_PATTERNS       = *.cmdline.* \
                          gcc-compat.h \

-                         fade.c \

                          *.command_list.h \
                          *.completion.h
 
                          *.command_list.h \
                          *.completion.h
 

diff --git a/fade.c b/fade.c
index e05e31733623dacae4beddad69580d077ad23a0d..95bb1d59ffd60f277f4569e44c8909c3fe060c76 100644 (file)
--- a/fade.c
+++ b/fade.c
@@ -333,6 +333,17 @@ __noreturn static void print_help_and_die(void)
        exit(0);
 }
 
        exit(0);
 }
 

+/**
+ * The main function of para_fade.
+ *
+ * The executable is linked with the alsa or the oss mixer API, or both. It has
+ * a custom log function which prefixes log messages with the current date.
+ *
+ * \param argc Argument counter.
+ * \param argv Argument vector.
+ *
+ * \return EXIT_SUCCESS or EXIT_FAILURE.
+ */

 int main(int argc, char *argv[])
 {
        int ret;
 int main(int argc, char *argv[])
 {
        int ret;