docs(apidocs/c): improve profapi.h and profhooks.h comments

- Enhanced file-level comments with concise descriptions
- Added usage examples and aligned with Python prof module style
- Updated function comments to remove tables, improve clarity
- Replaced Profanity with CProof, preserved paths and method names

apidocs/c/profapi.h

@@ -1,4 +1,4 @@
-    /** @file profapi.h
+/** @file profapi.h
  * @brief C Plugin API for CProof.
  *
  * This header defines functions for CProof plugins to interact with the console,
@@ -16,11 +16,6 @@
  * @see profhooks.h
  */
 
-/** @mainpage CProof Plugin API and Hooks
- * API functions: @ref profapi.h
- * Hooks: @ref profhooks.h
- */
-
 /** Window handle for referencing plugin-created windows. */
 typedef char* PROF_WIN_TAG;