Documentation omission

I noticed plaympeg.c using a function that I couldn’t find in the
documentation, but found in the SDL_video.h file:

/* This function fills the given character buffer with the name of the

  • video driver, and returns a pointer to it if the video driver has
  • been initialized. It returns NULL if no driver has been initialized.
    */
    extern DECLSPEC char *SDL_VideoDriverName(char *namebuf, int maxlen);

Should the function documentation/API reference automatically be generated
from the header files or is it already doing this or is this a bad idea or
what??? :)–

Olivier A. Dagenais - Software Architect and Developer