Change the Doxygen doc requirement for non public functions

To be at the prototype site in the internal header file.

The major reason *Why* we would like to have Doxygen style comments
describing what internals do is so that they work with modern IDE's
since most common ones support them.

It's wonderful to be looking at an internal function, thinking "wtf is this",
and be able to hover over it and - boink - up comes the docs. This
typically only works (or works better) when the Doxygen comment is
at the prototype site, not if it is at the implementation site.

This also reinforces the requirement that "yes you do this for shared
functions but you don't need to for statics".

Reviewed-by: Neil Horman <[email protected]>
Reviewed-by: Milan Broz <[email protected]>
MergeDate: Fri Jul 10 15:37:18 2026
(Merged from https://github.com/openssl/openssl/pull/29295)

1 files changed, 1 insertions, 4 deletions

diff --git a/STYLE.md b/STYLE.md
index a5df9546f05..35d08983e5f 100644
--- a/STYLE.md
+++ b/STYLE.md
@@ -314,10 +314,7 @@ typedef struct foo_st {
  * @param b input integer to add
  * @returns the sum of a and b
  */
-int add(int a, int b)
-{
-    return a + b;
-}
+int add(int a, int b);
 ```
 
 #### Spec-mirroring variables