diff --git a/modules/gui/macosx/VLCScrollingClipView.h b/modules/gui/macosx/VLCScrollingClipView.h
index efaf366b6d404203102b7ab5188a85e557652d96..e0f5d2b233e2b63c040f8ee2fd6dbc9c166e3793 100644
--- a/modules/gui/macosx/VLCScrollingClipView.h
+++ b/modules/gui/macosx/VLCScrollingClipView.h
@@ -21,20 +21,35 @@
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  *****************************************************************************/
 
+/**
+ A Clip view subclass that offers automatic scrolling of its contents.
+ */
+
 #import <Cocoa/Cocoa.h>
 
 @interface VLCScrollingClipView : NSClipView
 
-/* Start scrolling. Does nothing if already scrolling. */
+/**
+ \brief Start automatic scrolling
+
+ \note  Does nothing if already scrolling
+ */
 - (void)startScrolling;
 
-/* Stop scrolling. Does not reset the position! */
+/**
+ Stop automatic scrolling.
+
+ \note  Does not reset the position */
 - (void)stopScrolling;
 
-/* Resets scrolling position to the top */
+/**
+ Reset scrolling position to the top
+ */
 - (void)resetScrolling;
 
-/* Outlet to the parent NSScrollView */
+/**
+ Outlet to the parent NSScrollView
+ */
 @property IBOutlet NSScrollView *parentScrollView;
 
 @end