fix: implement C Doxygen style comments in main.c

---
type: pre_commit_static_analysis_report
description: Results of running static analysis checks when committing changes.
report:
  - task: lint_filenames
    status: passed
  - task: lint_editorconfig
    status: passed
  - task: lint_markdown
    status: na
  - task: lint_package_json
    status: na
  - task: lint_repl_help
    status: na
  - task: lint_javascript_src
    status: na
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: na
  - task: lint_javascript_tests
    status: na
  - task: lint_javascript_benchmarks
    status: na
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: passed
  - task: lint_c_examples
    status: na
  - task: lint_c_benchmarks
    status: na
  - task: lint_c_tests_fixtures
    status: na
  - task: lint_shell
    status: na
  - task: lint_typescript_declarations
    status: na
  - task: lint_typescript_tests
    status: na
  - task: lint_license_headers
    status: passed
---

Author: Lokeshranjan8

lib/node_modules/@stdlib/stats/base/dists/signrank/pdf/benchmark/benchmark.js

@@ -1,7 +1,7 @@
 /**
 * @license Apache-2.0
 *
-* Copyright (c) 2020 The Stdlib Authors.
+* Copyright (c) 2025 The Stdlib Authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -20,27 +20,19 @@
 
 // MODULES //
 
-var resolve = require( 'path' ).resolve;
 var bench = require( '@stdlib/bench' );
 var Float64Array = require( '@stdlib/array/float64' );
+var uniform = require( '@stdlib/random/array/uniform' );
 var randu = require( '@stdlib/random/base/randu' );
 var ceil = require( '@stdlib/math/base/special/ceil' );
 var isnan = require( '@stdlib/math/base/assert/is-nan' );
-var tryRequire = require( '@stdlib/utils/try-require' );
 var pkg = require( './../package.json' ).name;
-
-
-// VARIABLES //
-
-var pdf = tryRequire( resolve( __dirname, './../lib/native.js' ) );
-var opts = {
-	'skip': ( pdf instanceof Error )
-};
+var pdf = require( './../lib' );
 
 
 // MAIN //
 
-bench( pkg, opts, function benchmark( b ) {
+bench( pkg, function benchmark( b ) {
 	var len;
 	var n;
 	var x;
@@ -69,3 +61,29 @@ bench( pkg, opts, function benchmark( b ) {
 	b.pass( 'benchmark finished' );
 	b.end();
 });
+
+bench( pkg+':factory', function benchmark( b ) {
+	var mypdf;
+	var n;
+	var x;
+	var y;
+	var i;
+
+	n = 20;
+	mypdf = pdf.factory( n );
+	x = uniform( 100, -2.0, 2.0 );
+
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		y = mypdf( x[ i % x.length] );
+		if ( isnan( y ) ) {
+			b.fail( 'should not return NaN' );
+		}
+	}
+	b.toc();
+	if ( isnan( y ) ) {
+		b.fail( 'should not return NaN' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+});

lib/node_modules/@stdlib/stats/base/dists/signrank/pdf/benchmark/benchmark.native.js

@@ -1,7 +1,7 @@
 /**
 * @license Apache-2.0
 *
-* Copyright (c) 2025 The Stdlib Authors.
+* Copyright (c) 2020 The Stdlib Authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -20,19 +20,27 @@
 
 // MODULES //
 
+var resolve = require( 'path' ).resolve;
 var bench = require( '@stdlib/bench' );
 var Float64Array = require( '@stdlib/array/float64' );
-var uniform = require( '@stdlib/random/array/uniform' );
 var randu = require( '@stdlib/random/base/randu' );
 var ceil = require( '@stdlib/math/base/special/ceil' );
 var isnan = require( '@stdlib/math/base/assert/is-nan' );
+var tryRequire = require( '@stdlib/utils/try-require' );
 var pkg = require( './../package.json' ).name;
-var pdf = require( './../lib' );
+
+
+// VARIABLES //
+
+var pdf = tryRequire( resolve( __dirname, './../lib/native.js' ) );
+var opts = {
+	'skip': ( pdf instanceof Error )
+};
 
 
 // MAIN //
 
-bench( pkg, function benchmark( b ) {
+bench( pkg, opts, function benchmark( b ) {
 	var len;
 	var n;
 	var x;
@@ -61,29 +69,3 @@ bench( pkg, function benchmark( b ) {
 	b.pass( 'benchmark finished' );
 	b.end();
 });
-
-bench( pkg+':factory', function benchmark( b ) {
-	var mypdf;
-	var n;
-	var x;
-	var y;
-	var i;
-
-	n = 20;
-	mypdf = pdf.factory( n );
-	x = uniform( 100, -2.0, 2.0 );
-
-	b.tic();
-	for ( i = 0; i < b.iterations; i++ ) {
-		y = mypdf( x[ i % x.length] );
-		if ( isnan( y ) ) {
-			b.fail( 'should not return NaN' );
-		}
-	}
-	b.toc();
-	if ( isnan( y ) ) {
-		b.fail( 'should not return NaN' );
-	}
-	b.pass( 'benchmark finished' );
-	b.end();
-});

lib/node_modules/@stdlib/stats/base/dists/signrank/pdf/src/main.c

@@ -25,12 +25,11 @@
 #include <stdint.h>
 
 /**
-* Calculates the weight for the `(x,n)` pair and memoizes the result.
+* Calculates the weight for the (x,n) pair and memoizes the result.
 *
-* @private
-* @param {number} x - input value
-* @param {NonNegativeInteger} n - number of observations
-* @returns {number} weight
+* @param x Input value
+* @param n Number of observations (must be a non-negative)
+* @return Weight value
 */
 static double weights( double x, const int32_t n ) {
 	double mlim;
@@ -51,9 +50,9 @@ static double weights( double x, const int32_t n ) {
 /**
 * Evaluates the probability density function (PDF) of the Wilcoxon signed rank test statistic with `n` observations.
 *
-* @param {number} x - input value
-* @param {PositiveInteger} n - number of observations
-* @returns {Probability} evaluated PDF
+* @param x Input value
+* @param n Number of observations (must be a non-negative)
+* @return Evaluated PDF
 *
 * @example
 * double y = stdlib_base_dists_signrank_pdf( 7.0, 9 );