Add a bunch of \file doxygen comments

diff --git a/include/vlc_access.h b/include/vlc_access.h
index a3c5be99c9789f1b97c456e229f6543972207970..9ddc64a3168aa0d380e6bba2b18dfb8b705fdfe0 100644 (file)
--- a/include/vlc_access.h
+++ b/include/vlc_access.h
@@ -24,6 +24,11 @@
 #ifndef VLC_ACCESS_H
 #define VLC_ACCESS_H 1
 
+/**
+ * \file
+ * This file defines functions and definitions for access object
+ */
+
 #include <vlc_block.h>
 
 /**

diff --git a/include/vlc_aout.h b/include/vlc_aout.h
index 7d119845ccc52ab48a7a52923f668f0c6dfd6ae5..993fa0135662fd77af88fc1ce1efab50d937645e 100644 (file)
--- a/include/vlc_aout.h
+++ b/include/vlc_aout.h
@@ -24,6 +24,11 @@
 #ifndef VLC_AOUT_H
 #define VLC_AOUT_H 1
 
+/**
+ * \file
+ * This file defines functions, structures and macros for audio output object
+ */
+
 # ifdef __cplusplus
 extern "C" {
 # endif
@@ -86,7 +91,6 @@ typedef int32_t vlc_fixed_t;
 #define FIXED32_MAX ((vlc_fixed_t) +0x7fffffffL)
 #define FIXED32_ONE ((vlc_fixed_t) 0x10000000)
 
-
 /*
  * Channels descriptions
  */

diff --git a/include/vlc_arrays.h b/include/vlc_arrays.h
index a95bc2388459ac0c5f28841d968d76606a536783..faf69d4a2854b6b3e307c34857c8b2ef9419998c 100644 (file)
--- a/include/vlc_arrays.h
+++ b/include/vlc_arrays.h
@@ -24,6 +24,11 @@
 #ifndef VLC_ARRAYS_H_
 #define VLC_ARRAYS_H_
 
+/**
+ * \file
+ * This file defines functions, structures and macros for handling arrays in vlc
+ */
+
 /**
  * Simple dynamic array handling. Array is realloced at each insert/removal
  */

diff --git a/include/vlc_bits.h b/include/vlc_bits.h
index 9f3d7fda389ed281934150445353867c375499bd..4dcfa2f1a37e577448a371dea8c56303551d48bf 100644 (file)
--- a/include/vlc_bits.h
+++ b/include/vlc_bits.h
@@ -24,6 +24,11 @@
 #ifndef VLC_BITS_H
 #define VLC_BITS_H 1
 
+/**
+ * \file
+ * This file defines functions, structures for handling streams of bits in vlc
+ */
+
 typedef struct bs_s
 {
     uint8_t *p_start;
@@ -40,14 +45,17 @@ static inline void bs_init( bs_t *s, void *p_data, int i_data )
     s->p_end   = s->p + i_data;
     s->i_left  = 8;
 }
+
 static inline int bs_pos( bs_t *s )
 {
     return( 8 * ( s->p - s->p_start ) + 8 - s->i_left );
 }
+
 static inline int bs_eof( bs_t *s )
 {
     return( s->p >= s->p_end ? 1: 0 );
 }
+
 static inline uint32_t bs_read( bs_t *s, int i_count )
 {
      static const uint32_t i_mask[33] =
@@ -167,6 +175,7 @@ static inline void bs_align( bs_t *s )
         s->p++;
     }
 }
+
 static inline void bs_align_0( bs_t *s )
 {
     if( s->i_left != 8 )
@@ -174,6 +183,7 @@ static inline void bs_align_0( bs_t *s )
         bs_write( s, s->i_left, 0 );
     }
 }
+
 static inline void bs_align_1( bs_t *s )
 {
     while( s->i_left != 8 )

diff --git a/include/vlc_block.h b/include/vlc_block.h
index cdd337a1badab56d41f5822cdb10be2043e9e6a3..b882b1f8c564cf6b4d8d83f684d97b43c576a838 100644 (file)
--- a/include/vlc_block.h
+++ b/include/vlc_block.h
@@ -24,6 +24,12 @@
 #ifndef VLC_BLOCK_H
 #define VLC_BLOCK_H 1
 
+/**
+ * \file
+ * This file implements functions and structures to handle blocks of data in vlc
+ *
+ */
+
 /****************************************************************************
  * block:
  ****************************************************************************

diff --git a/include/vlc_charset.h b/include/vlc_charset.h
index 3392bc13b3085fc54d08995fd20efc774d4ddcdb..76d9a03ad16eecc86115fbedd470ed37765a8605 100644 (file)
--- a/include/vlc_charset.h
+++ b/include/vlc_charset.h
@@ -25,6 +25,11 @@
 #ifndef VLC_CHARSET_H
 #define VLC_CHARSET_H 1
 
+/**
+ * \file
+ * This files handles locale conversions in vlc
+ */
+
 #include <stdarg.h>
 #include <sys/types.h>
 #include <dirent.h>

diff --git a/include/vlc_codecs.h b/include/vlc_codecs.h
index 988c5901eaf1dc188bbfba2192f02f91d623646c..46047116c7d286a918163a796d5fb6c10e4bf9ba 100644 (file)
--- a/include/vlc_codecs.h
+++ b/include/vlc_codecs.h
@@ -24,6 +24,11 @@
 #ifndef VLC_CODECS_H
 #define VLC_CODECS_H 1
 
+/**
+ * \file
+ * This file defines codec related structures needed by the demuxers and decoders
+ */
+
 #ifdef HAVE_ATTRIBUTE_PACKED
 #   define ATTR_PACKED __attribute__((__packed__))
 #else

diff --git a/include/vlc_config.h b/include/vlc_config.h
index 316179a38d8a9d5ab01512a2818b5e1dbcbdbc32..4a514355f238751cb3f93ae261374354044faa8e 100644 (file)
--- a/include/vlc_config.h
+++ b/include/vlc_config.h
@@ -22,6 +22,11 @@
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  *****************************************************************************/
 
+/**
+ * \file
+ * This file defines of values used in interface, vout, aout and vlc core functions.
+ */
+
 /* Conventions regarding names of symbols and variables
  * ----------------------------------------------------
  *

diff --git a/include/vlc_configuration.h b/include/vlc_configuration.h
index 5e0911ac7a6a7717b2b4f2024dc2b9e1a5ea52c4..36d46cb28a799b5e2f0e2bd687d281e90562db9c 100644 (file)
--- a/include/vlc_configuration.h
+++ b/include/vlc_configuration.h
@@ -26,6 +26,11 @@
 #ifndef VLC_CONFIGURATION_H
 #define VLC_CONFIGURATION_H 1
 
+/**
+ * \file
+ * This file describes the programming interface for the configuration module.
+ * It includes functions allowing to declare, get or set configuration options.
+ */
 
 # ifdef __cplusplus
 extern "C" {

diff --git a/include/vlc_demux.h b/include/vlc_demux.h
index 5a0fc0b7eeafa1f34fe08c4c3b0b518306de7a60..27909504f71cfeaf359f23b883d8ee19e4495b82 100644 (file)
--- a/include/vlc_demux.h
+++ b/include/vlc_demux.h
@@ -24,6 +24,11 @@
 #ifndef VLC_DEMUX_H
 #define VLC_DEMUX_H 1
 
+/**
+ * \file
+ * This files defines functions and structures used by demux objects in vlc
+ */
+
 #include <vlc_es.h>
 #include <vlc_stream.h>
 #include <vlc_es_out.h>

diff --git a/include/vlc_devices.h b/include/vlc_devices.h
index 46b74124def4d7d8a3b4af99d48a89e8f033a0f4..ba0d5f809007c6a07f8d8c1f91f63ff17cce04cf 100644 (file)
--- a/include/vlc_devices.h
+++ b/include/vlc_devices.h
@@ -24,6 +24,11 @@
 #ifndef VLC_DEVICES_H
 #define VLC_DEVICES_H 1
 
+/**
+ * \file
+ * This file implements functions, structures for probing devices (DVD, CD, VCD)
+ */
+
 enum
 {
     DEVICE_CAN_DVD,

diff --git a/include/vlc_epg.h b/include/vlc_epg.h
index 25a94312623a6fda83c520dc2a4df35ce05897a4..f1ffabe7b4a0306385b25cdd5281cf3ac95ea415 100644 (file)
--- a/include/vlc_epg.h
+++ b/include/vlc_epg.h
@@ -24,6 +24,11 @@
 #ifndef VLC_EPG_H
 #define VLC_EPG_H 1
 
+/**
+ * \file
+ * This file defines functions and structures for storing dvb epg information
+ */
+
 typedef struct
 {
     int64_t i_start;    /* Interpreted as a value return by time() */
@@ -50,6 +55,7 @@ static inline void vlc_epg_Init( vlc_epg_t *p_epg, const char *psz_name )
     p_epg->p_current = NULL;
     TAB_INIT( p_epg->i_event, p_epg->pp_event );
 }
+
 static inline void vlc_epg_Clean( vlc_epg_t *p_epg )
 {
     int i;
@@ -64,6 +70,7 @@ static inline void vlc_epg_Clean( vlc_epg_t *p_epg )
     TAB_CLEAN( p_epg->i_event, p_epg->pp_event );
     free( p_epg->psz_name );
 }
+
 static inline void vlc_epg_AddEvent( vlc_epg_t *p_epg, int64_t i_start, int i_duration,
                                 const char *psz_name, const char *psz_short_description, const char *psz_description )
 {
@@ -85,11 +92,13 @@ static inline vlc_epg_t *vlc_epg_New( const char *psz_name )
         vlc_epg_Init( p_epg, psz_name );
     return p_epg;
 }
+
 static inline void vlc_epg_Delete( vlc_epg_t *p_epg )
 {
     vlc_epg_Clean( p_epg );
     free( p_epg );
 }
+
 static inline void vlc_epg_SetCurrent( vlc_epg_t *p_epg, int64_t i_start )
 {
     int i;

diff --git a/include/vlc_es_out.h b/include/vlc_es_out.h
index 782c1b3fd4fa2cc6da86656d6f0cdef6fd72f9cb..bd654484a972d30c5b23de24c00dead6a9cd90fe 100644 (file)
--- a/include/vlc_es_out.h
+++ b/include/vlc_es_out.h
@@ -24,6 +24,11 @@
 #ifndef VLC_ES_OUT_H
 #define VLC_ES_OUT_H 1
 
+/**
+ * \file
+ * This file defines functions and structures for handling es_out in stream output
+ */
+
 /**
  * \defgroup es out Es Out
  * @{
@@ -105,10 +110,12 @@ static inline es_out_id_t * es_out_Add( es_out_t *out, es_format_t *fmt )
 {
     return out->pf_add( out, fmt );
 }
+
 static inline void es_out_Del( es_out_t *out, es_out_id_t *id )
 {
     out->pf_del( out, id );
 }
+
 static inline int es_out_Send( es_out_t *out, es_out_id_t *id,
                                block_t *p_block )
 {
@@ -119,6 +126,7 @@ static inline int es_out_vaControl( es_out_t *out, int i_query, va_list args )
 {
     return out->pf_control( out, i_query, args );
 }
+
 static inline int es_out_Control( es_out_t *out, int i_query, ... )
 {
     va_list args;

diff --git a/include/vlc_gcrypt.h b/include/vlc_gcrypt.h
index 3a2e631b01fde0f8efbe9edfb807e7853909bf3a..85029109348e0d6b9c27ffeac4d35c0c8dbdec97 100644 (file)
--- a/include/vlc_gcrypt.h
+++ b/include/vlc_gcrypt.h
@@ -18,6 +18,11 @@
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  *****************************************************************************/
 
+/**
+ * \file
+ * This file implements gcrypt support functions in vlc
+ */
+
 #ifdef LIBVLC_USE_PTHREAD
 /**
  * If possible, use gcrypt-provided thread implementation. This is so that
@@ -26,6 +31,7 @@
 GCRY_THREAD_OPTION_PTHREAD_IMPL;
 # define gcry_threads_vlc gcry_threads_pthread
 #else
+
 /**
  * gcrypt thread option VLC implementation
  */

diff --git a/include/vlc_httpd.h b/include/vlc_httpd.h
index 2bbf47d7196ad7647a700182b16a74987398e5e0..5febb370f6bd234c99f052589b471a6f85b010d0 100644 (file)
--- a/include/vlc_httpd.h
+++ b/include/vlc_httpd.h
@@ -24,6 +24,11 @@
 #ifndef VLC_HTTPD_H
 #define VLC_HTTPD_H 1
 
+/**
+ * \file
+ * This file defines functions, structures, enums and macros for httpd functionality in vlc.
+ */
+
 enum
 {
     HTTPD_MSG_NONE,

diff --git a/include/vlc_image.h b/include/vlc_image.h
index cd7686a33189502e36601f05db2c9f885ef4ce1c..a7ab94cef5519080a233c87d5eb883ab8641ac03 100644 (file)
--- a/include/vlc_image.h
+++ b/include/vlc_image.h
@@ -24,6 +24,11 @@
 #ifndef VLC_IMAGE_H
 #define VLC_IMAGE_H 1
 
+/**
+ * \file
+ * This file defines functions and structures for image conversions in vlc
+ */
+
 #include <vlc_vout.h>
 
 # ifdef __cplusplus

diff --git a/include/vlc_input.h b/include/vlc_input.h
index 8663f11c5f852d391d390051ea17b3caafeafe52..09603e35f90f16afa7cc8533a1b692d2c074c858 100644 (file)
--- a/include/vlc_input.h
+++ b/include/vlc_input.h
@@ -26,6 +26,11 @@
 #ifndef VLC__INPUT_H
 #define VLC__INPUT_H 1
 
+/**
+ * \file
+ * This file defines functions, structures and enums for input objects in vlc
+ */
+
 #include <vlc_es.h>
 #include <vlc_meta.h>
 #include <vlc_epg.h>

diff --git a/include/vlc_intf_strings.h b/include/vlc_intf_strings.h
index 050ffd370b8565d16a86014b0cdb1bae7b4c99d5..c709a6619ac654051f7d0f81ddbc2830d52b2f06 100644 (file)
--- a/include/vlc_intf_strings.h
+++ b/include/vlc_intf_strings.h
@@ -24,6 +24,11 @@
 #ifndef VLC_INTF_STRINGS_H
 #define VLC_INTF_STRINGS_H 1
 
+/**
+ * \file
+ * This file defines a number of strings used in user interfaces
+ */
+
 /*************** Open dialogs **************/
 
 #define I_OP_OPF        N_("Quick &Open File...")

diff --git a/include/vlc_iso_lang.h b/include/vlc_iso_lang.h
index 44823e4eda4ce3ccc080df98f91d92ad6e214e2d..2d8ddb6fa9ac4593c3d80482bc62815c596cb866 100644 (file)
--- a/include/vlc_iso_lang.h
+++ b/include/vlc_iso_lang.h
@@ -22,6 +22,11 @@
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  *****************************************************************************/
 
+/**
+ * \file
+ * This file defines functions and structures for iso639 language codes
+ */
+
 struct iso639_lang_t
 {
     const char * psz_eng_name;        /* Description in English */

diff --git a/include/vlc_keys.h b/include/vlc_keys.h
index 87541d50ceb9ec61f72cd5f6997f1ef5b7ed3c12..a3fca5788fd4a430d4235158b0fc2d4c4a8e1a94 100644 (file)
--- a/include/vlc_keys.h
+++ b/include/vlc_keys.h
@@ -24,6 +24,12 @@
 #ifndef VLC_KEYS_H
 #define VLC_KEYS_H 1
 
+/**
+ * \file
+ * This file defines keys, functions and structures for hotkey handling in vlc
+ *
+ */
+
 #define KEY_MODIFIER         0xFF000000
 #define KEY_MODIFIER_ALT     0x01000000
 #define KEY_MODIFIER_SHIFT   0x02000000

diff --git a/include/vlc_main.h b/include/vlc_main.h
index 1d1810efedf393ec2fe3eccb6485a24d594fbb18..119b177bc1d960cbc48478079c615541b95ff8e7 100644 (file)
--- a/include/vlc_main.h
+++ b/include/vlc_main.h
@@ -21,6 +21,11 @@
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  *****************************************************************************/
 
+/**
+ * \file
+ * This file defines libvlc_int_t internal libvlc instance
+ */
+
 TYPEDEF_ARRAY(input_item_t*, input_item_array_t);
 
 /*****************************************************************************

diff --git a/include/vlc_md5.h b/include/vlc_md5.h
index 9acca98e4306707ed66be0210523aef73fface9c..d05126980ffacc7e6778cdc35a74339374386292 100644 (file)
--- a/include/vlc_md5.h
+++ b/include/vlc_md5.h
@@ -25,6 +25,11 @@
 #ifndef VLC_MD5_H
 # define VLC_MD5_H
 
+/**
+ * \file
+ * This file defines functions and structures for handling md5 checksums
+ */
+
 /*****************************************************************************
  * md5_s: MD5 message structure
  *****************************************************************************

diff --git a/include/vlc_messages.h b/include/vlc_messages.h
index c4113677fd8e1e88bd4d916ef75d3bccda45fd6f..c0b8ee5e178ee6bd185bb20f83e0c3da4ea03316 100644 (file)
--- a/include/vlc_messages.h
+++ b/include/vlc_messages.h
@@ -27,6 +27,11 @@
 #ifndef VLC_MESSAGES_H_
 #define VLC_MESSAGES_H_
 
+/**
+ * \file
+ * This file defines structures and functions to handle messages and statistics gathering
+ */
+
 #include <stdarg.h>
 
 /**

diff --git a/include/vlc_meta.h b/include/vlc_meta.h
index 19be4122bc04179d62b56fd392b9deb3a789a73b..a2abee0bbdb1298370f0ecd939c8dee809ec5478 100644 (file)
--- a/include/vlc_meta.h
+++ b/include/vlc_meta.h
@@ -24,6 +24,12 @@
 #ifndef VLC_META_H
 #define VLC_META_H 1
 
+/**
+ * \file
+ * This file defines functions and structures for stream meta-data in vlc
+ *
+ */
+
 #include <vlc_arrays.h>
 
 typedef enum vlc_meta_type_t

diff --git a/include/vlc_modules.h b/include/vlc_modules.h
index 7d965bcd11ced7fdc71ac0ca6fa6afaef86a6331..97023972974e47a077d4520b3813475c30c27da2 100644 (file)
--- a/include/vlc_modules.h
+++ b/include/vlc_modules.h
@@ -21,6 +21,11 @@
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  *****************************************************************************/
 
+/**
+ * \file
+ * This file defines functions for modules in vlc
+ */
+
 /*****************************************************************************
  * Exported functions.
  *****************************************************************************/

diff --git a/include/vlc_network.h b/include/vlc_network.h
index e2200d3eea5338c4d6f035dcece2cc026832223a..5c4b1dcf780f119694c8b8556c5120777bdf4d3a 100644 (file)
--- a/include/vlc_network.h
+++ b/include/vlc_network.h
@@ -27,6 +27,11 @@
 #ifndef VLC_NETWORK_H
 # define VLC_NETWORK_H
 
+/**
+ * \file
+ * This file defines interface to communicate with network plug-ins
+ */
+
 #if defined( WIN32 )
 #   if !defined(UNDER_CE)
 #       define _NO_OLDNAMES 1

diff --git a/include/vlc_osd.h b/include/vlc_osd.h
index d9fa797edb3d5ca99025eb8919cba7269ee23319..a332b61a1b2d4f9983e8a6a49e0eec1dda191a59 100644 (file)
--- a/include/vlc_osd.h
+++ b/include/vlc_osd.h
@@ -36,6 +36,11 @@
 extern "C" {
 # endif
 
+/**
+ * \file
+ * This file defines SPU subpicture and OSD functions and object types.
+ */
+
 /**********************************************************************
  * Base SPU structures
  **********************************************************************/

diff --git a/include/vlc_plugin.h b/include/vlc_plugin.h
index f0d2554562ecbb4b15a76776a44664f5c0cf25c2..cc51ddc65077820f49b094b16969dc6389428b0f 100644 (file)
--- a/include/vlc_plugin.h
+++ b/include/vlc_plugin.h
@@ -24,6 +24,11 @@
 #ifndef LIBVLC_MODULES_MACROS_H
 # define LIBVLC_MODULES_MACROS_H 1
 
+/**
+ * \file
+ * This file implements plugin (module) macros used to define a vlc module.
+ */
+
 /*****************************************************************************
  * If we are not within a module, assume we're in the vlc core.
  *****************************************************************************/

diff --git a/include/vlc_rand.h b/include/vlc_rand.h
index 2afff1905deb633965233979973f3fad6db94ad5..56e07affa8179e4fd54966b63e717f96e37b8fc4 100644 (file)
--- a/include/vlc_rand.h
+++ b/include/vlc_rand.h
@@ -22,6 +22,11 @@
 #ifndef VLC_RAND_H
 # define VLC_RAND_H
 
+/**
+ * \file
+ * This file defined random number generator function in vlc
+ */
+
 VLC_EXPORT( void, vlc_rand_bytes, (void *buf, size_t len) );
 
 #endif

diff --git a/include/vlc_services_discovery.h b/include/vlc_services_discovery.h
index 33e354b045cf2483be95921e1fe0dfd962f7ba3f..75834212b3d14bed300bb1ee57acd79e17dd2b4e 100644 (file)
--- a/include/vlc_services_discovery.h
+++ b/include/vlc_services_discovery.h
@@ -24,6 +24,11 @@
 #ifndef VLC_SERVICES_DISCOVERY_H_
 #define VLC_SERVICES_DISCOVERY_H_
 
+/**
+ * \file
+ * This file functions and structures for service discovery in vlc
+ */
+
 # ifdef __cplusplus
 extern "C" {
 # endif

diff --git a/include/vlc_sout.h b/include/vlc_sout.h
index 576e8305eb8e07e115c6ad95d36c22ba7af2750a..811146f72baef197e8d5936c8183f4e35d476a61 100644 (file)
--- a/include/vlc_sout.h
+++ b/include/vlc_sout.h
@@ -27,6 +27,11 @@
 #ifndef VLC_SOUT_H_
 #define VLC_SOUT_H_
 
+/**
+ * \file
+ * This file defines structures and functions for stream ouput in vlc
+ */
+
 #ifdef __cplusplus
 extern "C" {
 #endif

diff --git a/include/vlc_stream.h b/include/vlc_stream.h
index 13a0155a018f627e07c67f16b8874671e82cfc84..eba91cf7e9197ecd180bc4f9e0da775d1b7c3091 100644 (file)
--- a/include/vlc_stream.h
+++ b/include/vlc_stream.h
@@ -26,6 +26,11 @@
 
 #include <vlc_block.h>
 
+/**
+ * \file
+ * This file defines structures and functions for stream (between access and demux) descriptor in vlc
+ */
+
 # ifdef __cplusplus
 extern "C" {
 # endif
@@ -122,7 +127,6 @@ VLC_EXPORT( stream_t *,__stream_DemuxNew, ( vlc_object_t *p_obj, const char *psz
 VLC_EXPORT( void,      stream_DemuxSend,  ( stream_t *s, block_t *p_block ) );
 VLC_EXPORT( void,      stream_DemuxDelete,( stream_t *s ) );
 
-
 #define stream_MemoryNew( a, b, c, d ) __stream_MemoryNew( VLC_OBJECT(a), b, c, d )
 VLC_EXPORT( stream_t *,__stream_MemoryNew, (vlc_object_t *p_obj, uint8_t *p_buffer, int64_t i_size, bool i_preserve_memory ) );
 #define stream_UrlNew( a, b ) __stream_UrlNew( VLC_OBJECT(a), b )

diff --git a/include/vlc_strings.h b/include/vlc_strings.h
index 82d947a30939fdfa043f05a4ad63096e66d511e8..eab608e09063b3cd8d14842f4861abb50008cbc6 100644 (file)
--- a/include/vlc_strings.h
+++ b/include/vlc_strings.h
@@ -24,6 +24,11 @@
 #ifndef VLC_STRINGS_H
 #define VLC_STRINGS_H 1
 
+/**
+ * \file
+ * This file defines functions and structures handling misc strings
+ */
+
 /**
  * \defgroup strings Strings
  * @{

diff --git a/include/vlc_threads.h b/include/vlc_threads.h
index 5cee5bf05ddb07813b1256c848fda1b2cb745095..0acffce32e9ba9b552ab8aae772bf6cab89a3381 100644 (file)
--- a/include/vlc_threads.h
+++ b/include/vlc_threads.h
@@ -28,6 +28,12 @@
 #ifndef VLC_THREADS_H_
 #define VLC_THREADS_H_
 
+/**
+ * \file
+ * This file defines structures and functions for handling threads in vlc
+ *
+ */
+
 #if defined( UNDER_CE )
                                                                 /* WinCE API */
 #elif defined( WIN32 )

diff --git a/include/vlc_tls.h b/include/vlc_tls.h
index 7bf3500fca7cd75703169e569798af6384b0d774..84d59538b615b50667463da4978f50f58b165588 100644 (file)
--- a/include/vlc_tls.h
+++ b/include/vlc_tls.h
@@ -24,6 +24,11 @@
 #ifndef VLC_TLS_H
 # define VLC_TLS_H
 
+/**
+ * \file
+ * This file defines Transport Layer Security API (TLS) in vlc
+ */
+
 # include <vlc_network.h>
 
 typedef struct tls_server_sys_t tls_server_sys_t;

diff --git a/include/vlc_update.h b/include/vlc_update.h
index d53d898a6f9bded53fa702de57a420dde240051c..1bb91f90fadfe2037b178bc208d494614c4b4851 100644 (file)
--- a/include/vlc_update.h
+++ b/include/vlc_update.h
@@ -25,6 +25,11 @@
 #ifndef VLC_UPDATE_H
 #define VLC_UPDATE_H
 
+/**
+ * \file
+ * This file defines update API in vlc
+ */
+
 /**
  * \defgroup update Update
  *
@@ -46,7 +51,6 @@ struct update_release_t
     char* psz_desc;     ///< Release description
 };
 
-
 #endif /* UPDATE_CHECK */
 
 typedef struct update_release_t update_release_t;

diff --git a/include/vlc_url.h b/include/vlc_url.h
index 4e95c7d7d83bbdf8e11546b0328134601d5092fb..7cedd5b8b0156cbf9211d215b7ff4cd7b0637661 100644 (file)
--- a/include/vlc_url.h
+++ b/include/vlc_url.h
@@ -25,6 +25,11 @@
 #ifndef VLC_URL_H
 # define VLC_URL_H
 
+/**
+ * \file
+ * This file defines functions for manipulating URL in vlc
+ */
+
 struct vlc_url_t
 {
     char *psz_protocol;
@@ -192,7 +197,6 @@ static inline void vlc_UrlClean( vlc_url_t *url )
     url->psz_buffer   = NULL;
 }
 
-
 static inline char *vlc_UrlEncode( const char *psz_url )
 {
     /* FIXME: do not encode / : ? and & _when_ not needed */
@@ -227,5 +231,4 @@ static inline int vlc_UrlIsNotEncoded( const char *psz_url )
     return 0; /* looks fine - but maybe it is not encoded */
 }
 
-
 #endif

diff --git a/include/vlc_variables.h b/include/vlc_variables.h
index 7c2bbd4c565648301253e4edd54165f653ca51f3..aa1c6b466be8740ff2c701ae3658b6ca1776bf54 100644 (file)
--- a/include/vlc_variables.h
+++ b/include/vlc_variables.h
@@ -25,6 +25,11 @@
 #ifndef VLC_VARIABLES_H
 #define VLC_VARIABLES_H 1
 
+/**
+ * \file
+ * This file defines functions and structures for dynamic variables in vlc
+ */
+
 /**
  * \defgroup variables Variables
  *

diff --git a/include/vlc_vlm.h b/include/vlc_vlm.h
index d85034f93edbabae9ce05dd27805dfde1115d5df..665cf2db9fa08651be180a317adfcc024a46d0d5 100644 (file)
--- a/include/vlc_vlm.h
+++ b/include/vlc_vlm.h
@@ -25,8 +25,21 @@
 #ifndef VLC_VLM_H
 #define VLC_VLM_H 1
 
+/**
+ * \file
+ * This file defines VLM core functions and structures in vlc
+ */
+
 #include <vlc_input.h>
 
+/**
+ * \defgroup server VLM
+ * VLM is the server core in vlc that allows streaming of multiple media streams
+ * at the same time. It provides broadcast, schedule and video on demand features
+ * for streaming using several streaming and network protocols.
+ * @{
+ */
+
 /* VLM media */
 typedef struct
 {
@@ -270,4 +283,6 @@ static inline void vlm_media_instance_Delete( vlm_media_instance_t *p_instance )
 }
 #endif
 
+/**@}*/
+
 #endif

diff --git a/include/vlc_vod.h b/include/vlc_vod.h
index 52cdd3029ea4d525035fbf6c7898049d082f8252..17cd2e497af218a5ab2f935f2f923966905be1dd 100644 (file)
--- a/include/vlc_vod.h
+++ b/include/vlc_vod.h
@@ -24,6 +24,17 @@
 #ifndef VLC_VOD_H
 #define VLC_VOD_H 1
 
+/**
+ * \file
+ * This file defines an interface for VOD server modules in vlc
+ */
+
+/**
+ * \defgroup server Video On Demand (VOD)
+ * Video On Demand (VOD) functionality is provided from VLM.
+ * @{
+ */
+
 struct vod_t
 {
     VLC_COMMON_MEMBERS
@@ -67,4 +78,6 @@ enum vod_query_e
     VOD_MEDIA_FORWARD,      /* arg1= double         res=    */
 };
 
+/**}*/
+
 #endif

diff --git a/include/vlc_vout.h b/include/vlc_vout.h
index f80688815ef78ccec4a7cecf4d9d00b7466d72dc..47fc3fd0a86285e1786107df69f8d6c546cef1cf 100644 (file)
--- a/include/vlc_vout.h
+++ b/include/vlc_vout.h
@@ -26,6 +26,11 @@
 #ifndef VLC_VOUT_H_
 #define VLC_VOUT_H_ 1
 
+/**
+ * \file
+ * This file defines common video output structures and functions in vlc
+ */
+
 #include <vlc_es.h>
 #include <vlc_filter.h>
 

diff --git a/include/vlc_window.h b/include/vlc_window.h
index 8cbb75a8463995688016783876af65633c1070ee..9e95a6b5db2332b1d2958e2a9e08b3a141224be0 100644 (file)
--- a/include/vlc_window.h
+++ b/include/vlc_window.h
@@ -21,6 +21,11 @@
 #ifndef LIBVLCCORE_WINDOW_H
 # define LIBVLCCORE_WINDOW_H 1
 
+/**
+ * \file
+ * This file defines functions and structures for output windows
+ */
+
 # include <stdarg.h>
 
 typedef struct vout_window_t vout_window_t;

diff --git a/include/vlc_xml.h b/include/vlc_xml.h
index 1b600b73f2e15942a01195817bb6a29b07b5b50b..20b097059adb5334912b2591fca3460161e75a58 100644 (file)
--- a/include/vlc_xml.h
+++ b/include/vlc_xml.h
@@ -24,6 +24,12 @@
 #ifndef VLC_XML_H
 #define VLC_XML_H
 
+/**
+ * \file
+ * This file defines functions and structures to handle xml tags in vlc
+ *
+ */
+
 # ifdef __cplusplus
 extern "C" {
 # endif