From 22df70e9edaa8353e5edcc65c660d2d9f19ede5a Mon Sep 17 00:00:00 2001 From: Timothy Gu Date: Fri, 29 Jul 2016 17:18:09 -0700 Subject: [PATCH] doxygen: Add a note on libavutil's modular nature --- libavutil/avutil.h | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/libavutil/avutil.h b/libavutil/avutil.h index c1f76c16ea..27e9cf0f67 100644 --- a/libavutil/avutil.h +++ b/libavutil/avutil.h @@ -23,7 +23,8 @@ /** * @file - * external API header + * @ingroup lavu + * Convenience header that includes @ref lavu "libavutil"'s core. */ /** @@ -81,11 +82,14 @@ * @defgroup lavu Common utility functions * * @brief - * libavutil contains the code shared across all the other FFmpeg - * libraries + * libavutil contains the code shared across all the other FFmpeg libraries. * - * @note In order to use the functions provided by avutil you must include - * the specific header. + * @note + * libavutil is designed to be modular. In most cases, in order to use the + * functions provided by one component of libavutil you must explicitly include + * the specific header containing that feature. If you are only using + * media-related components, you could simply include libavutil/avutil.h, which + * brings in most of the "core" components. * * @{ *