docs: update style and examples

PR-URL: #2189
Reviewed-by: Athan Reines <kgryte@gmail.com>
Signed-off-by: GUNJ JOSHI <gunjjoshi8372@gmail.com>

Author: gunjjoshi

lib/node_modules/@stdlib/math/base/special/rcbrt/README.md

@@ -18,7 +18,7 @@ limitations under the License.
 
 -->
 
-# Reciprocal Cube Root
+# rcbrt
 
 > Compute the reciprocal of the principal [cube root][cube-root] of a double-precision floating-point number.
 
@@ -86,15 +86,13 @@ v = rcbrt( Infinity );
 <!-- eslint no-undef: "error" -->
 
 ```javascript
-var randu = require( '@stdlib/random/base/randu' );
-var round = require( '@stdlib/math/base/special/round' );
+var discreteUniform = require( '@stdlib/random/base/discrete-uniform' );
 var rcbrt = require( '@stdlib/math/base/special/rcbrt' );
 
 var x;
 var i;
-
 for ( i = 0; i < 100; i++ ) {
-    x = round( randu() * 100.0 );
+    x = discreteUniform( 0.0, 100.0 );
     console.log( 'rcbrt(%d) = %d', x, rcbrt( x ) );
 }
 ```

lib/node_modules/@stdlib/math/base/special/rcbrt/benchmark/benchmark.js

@@ -43,7 +43,7 @@ bench( pkg, function benchmark( b ) {
 
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		x = ( randu()*100000.0 ) - 0.0;
+		x = ( randu() * 100000.0 ) - 0.0;
 		y = rcbrt( x );
 		if ( isnan( y ) ) {
 			b.fail( 'should not return NaN' );
@@ -64,7 +64,7 @@ bench( pkg+'::built-in', opts, function benchmark( b ) {
 
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		x = ( randu()*100000.0 ) - 0.0;
+		x = ( randu() * 100000.0 ) - 0.0;
 		y = 1.0 / Math.cbrt( x ); // eslint-disable-line stdlib/no-builtin-math
 		if ( isnan( y ) ) {
 			b.fail( 'should not return NaN' );

lib/node_modules/@stdlib/math/base/special/rcbrt/benchmark/benchmark.native.js

@@ -45,7 +45,7 @@ bench( pkg+'::native', opts, function benchmark( b ) {
 
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		x = ( randu()*100000.0 ) - 0.0;
+		x = ( randu() * 100000.0 ) - 0.0;
 		y = rcbrt( x );
 		if ( isnan( y ) ) {
 			b.fail( 'should not return NaN' );

lib/node_modules/@stdlib/math/base/special/rcbrt/docs/repl.txt

@@ -21,7 +21,7 @@
     0.1
     > y = {{alias}}( 0.0 )
     Infinity
-    > y = {{alias}}( Infinity )
+    > y = {{alias}}( {{alias:@stdlib/constants/float64/pinf}} )
     0.0
     > y = {{alias}}( -8.0 )
     -0.5

lib/node_modules/@stdlib/math/base/special/rcbrt/examples/index.js

@@ -18,14 +18,12 @@
 
 'use strict';
 
-var randu = require( '@stdlib/random/base/randu' );
-var round = require( '@stdlib/math/base/special/round' );
+var discreteUniform = require( '@stdlib/random/base/discrete-uniform' );
 var rcbrt = require( './../lib' );
 
 var x;
 var i;
-
 for ( i = 0; i < 100; i++ ) {
-	x = round( randu() * 100.0 );
+	x = discreteUniform( 0.0, 100.0 );
 	console.log( 'rcbrt(%d) = %d', x, rcbrt( x ) );
 }

lib/node_modules/@stdlib/math/base/special/rcbrt/manifest.json

@@ -28,14 +28,12 @@
 		{
 			"task": "build",
 			"src": [
-				"./src/rcbrt.c"
+				"./src/main.c"
 			],
 			"include": [
 				"./include"
 			],
-			"libraries": [
-				"-lm"
-			],
+			"libraries": [],
 			"libpath": [],
 			"dependencies": [
 				"@stdlib/math/base/napi/unary",
@@ -45,14 +43,12 @@
 		{
 			"task": "benchmark",
 			"src": [
-				"./src/rcbrt.c"
+				"./src/main.c"
 			],
 			"include": [
 				"./include"
 			],
-			"libraries": [
-				"-lm"
-			],
+			"libraries": [],
 			"libpath": [],
 			"dependencies": [
 				"@stdlib/math/base/special/cbrt"
@@ -61,14 +57,12 @@
 		{
 			"task": "examples",
 			"src": [
-				"./src/rcbrt.c"
+				"./src/main.c"
 			],
 			"include": [
 				"./include"
 			],
-			"libraries": [
-				"-lm"
-			],
+			"libraries": [],
 			"libpath": [],
 			"dependencies": [
 				"@stdlib/math/base/special/cbrt"

lib/node_modules/@stdlib/math/base/special/rcbrt/src/addon.c

@@ -19,4 +19,5 @@
 #include "stdlib/math/base/special/rcbrt.h"
 #include "stdlib/math/base/napi/unary.h"
 
+// cppcheck-suppress shadowFunction
 STDLIB_MATH_BASE_NAPI_MODULE_D_D( stdlib_base_rcbrt )

lib/node_modules/@stdlib/math/base/special/rcbrt/src/rcbrt.c renamed to lib/node_modules/@stdlib/math/base/special/rcbrt/src/main.c

@@ -22,8 +22,8 @@
 /**
 * Computes the reciprocal cube root of a double-precision floating-point number.
 *
-* @param x       number
-* @return        reciprocal cube root
+* @param x    number
+* @return     reciprocal cube root
 *
 * @example
 * double y = stdlib_base_rcbrt( 8.0 );