refactor: apply suggestions from code review

Author: headlessNode

lib/node_modules/@stdlib/ndarray/fill-slice/benchmark/benchmark.1d.js

@@ -67,7 +67,7 @@ function createBenchmark( len, shape, xtype, order ) {
 
 		b.tic();
 		for ( i = 0; i < b.iterations; i++ ) {
-			fillSlice( x, new MultiSlice( null ), i );
+			fillSlice( x, i, new MultiSlice( null ) );
 			if ( isnan( x.data[ i%len ] ) ) {
 				b.fail( 'should not return NaN' );
 			}

lib/node_modules/@stdlib/ndarray/fill-slice/benchmark/benchmark.2d.js

@@ -69,7 +69,7 @@ function createBenchmark( len, shape, xtype, order ) {
 
 		b.tic();
 		for ( i = 0; i < b.iterations; i++ ) {
-			fillSlice( x, new MultiSlice( null, null ), i );
+			fillSlice( x, i, new MultiSlice( null, null ) );
 			if ( isnan( x.data[ i%len ] ) ) {
 				b.fail( 'should not return NaN' );
 			}

lib/node_modules/@stdlib/ndarray/fill-slice/docs/repl.txt

@@ -1,32 +1,49 @@
 
-{{alias}}( x, s, value )
-    Fills an input ndarray with a specified value in the region defined by a
-    MultiSlice.
+{{alias}}( x, value, ...s[, options] )
+    Fills an input ndarray slice with a specified value.
 
-    If `value` is a number and `x` has a complex data type, the function fills
-    an input ndarray with a complex number whose real component equals the
-    provided scalar `value` and whose imaginary component is zero.
+    The function supports three (mutually exclusive) means of providing slice
+    arguments:
 
-    The function *mutates* the input ndarray.
+    1. Providing a single MultiSlice object.
+    2. Providing a single array containing slice arguments.
+    3. Providing slice arguments as separate arguments.
+
+    An individual slice argument must be either a Slice, an integer, null, or
+    undefined.
+
+    If providing a MultiSlice object or an array of slice arguments, no other
+    slice arguments should be provided.
+
+    Mixing function invocation styles (e.g., providing multiple MultiSlice
+    objects or providing an array of slice arguments followed by additional
+    slice arguments) is not supported.
 
     Parameters
     ----------
-    x: ndarrayLike
+    x: ndarray
         Input ndarray.
 
-    s: MultiSlice
-        MultiSlice instance.
-
     value: any
         Scalar value. Must be able to safely cast to the input ndarray data
         type. Scalar values having floating-point data types (both real and
         complex) are allowed to downcast to a lower precision data type of the
         same kind (e.g., a scalar double-precision floating-point number can be
         used to fill a 'float32' input ndarray).
 
+    s: ...MultiSlice|Slice|null|undefined|integer|ArrayLike
+        Slice arguments.
+
+    options: Object (optional)
+        Options.
+
+    options.strict: boolean (optional)
+        Boolean indicating whether to enforce strict bounds checking.
+        Default: true.
+
     Returns
     -------
-    out: ndarrayLike
+    out: ndarray
         Input ndarray.
 
     Examples
@@ -37,7 +54,7 @@
     > var s0 = new {{alias:@stdlib/slice/ctor}}( 0, 1 );
     > var s1 = new {{alias:@stdlib/slice/ctor}}( null, null );
     > var s = new {{alias:@stdlib/slice/multi}}( s0, s1 );
-    > {{alias}}( x, s, 10.0 );
+    > {{alias}}( x, 10.0, s );
     > x.get( 0, 0 )
     10.0