diff --git a/libavutil/avutil.h b/libavutil/avutil.h
index 6bb5510bd7f09e8a4aa2fdc0a658638906b03552..782284d046348f11f8cb4bde4e7852e7d2265eb4 100644
--- a/libavutil/avutil.h
+++ b/libavutil/avutil.h
@@ -40,7 +40,7 @@
  * @li @ref lavd "libavdevice" special devices muxing/demuxing library
  * @li @ref lavu "libavutil" common utility library
  * @li @ref lavr "libavresample" audio resampling, format conversion and mixing
- * @li @subpage libswscale  color conversion and scaling library
+ * @li @ref libsws "libswscale"  color conversion and scaling library
  *
  * @section libav_versioning Versioning and compatibility
  *
diff --git a/libswscale/swscale.h b/libswscale/swscale.h
index e69a69461bd3996c6f064cae2fd30407eb445987..8fe27dfece0d9b5b27efd5c026ea4309638ef398 100644
--- a/libswscale/swscale.h
+++ b/libswscale/swscale.h
@@ -23,6 +23,7 @@
 
 /**
  * @file
+ * @ingroup libsws
  * @brief
  *     external api for the swscale stuff
  */
@@ -35,6 +36,9 @@
 #include "version.h"
 
 /**
+ * @defgroup libsws Color conversion and scaling
+ * @{
+ *
  * Return the LIBSWSCALE_VERSION_INT constant.
  */
 unsigned swscale_version(void);
@@ -343,4 +347,8 @@ void sws_convertPalette8ToPacked24(const uint8_t *src, uint8_t *dst, int num_pix
  */
 const AVClass *sws_get_class(void);
 
+/**
+ * @}
+ */
+
 #endif /* SWSCALE_SWSCALE_H */