docs: upgrade cdotc README

Author: DhruvArvindSingh

lib/node_modules/@stdlib/blas/base/cdotc/README.md

@@ -153,10 +153,157 @@ console.log( out );
 
 <!-- /.examples -->
 
+<!-- C interface documentation. -->
+
+* * *
+
+<section class="c">
+
+## C APIs
+
+<!-- Section to include introductory text. Make sure to keep an empty line after the intro `section` element and another before the `/section` close. -->
+
+<section class="intro">
+
+</section>
+
+<!-- /.intro -->
+
+<!-- C usage documentation. -->
+
+<section class="usage">
+
+### Usage
+
+```c
+#include "stdlib/blas/base/cdotc.h"
+```
+
+#### c_cdotc( N, \*X, strideX, \*Y, strideY )
+
+Calculates the dot product `x^H * y` of `x` and `y`.
+
+```c
+#include "stdlib/complex/float32/ctor.h"
+
+float x[] = { 7.0f, -8.0f, -1.0f, -9.0f };
+float y[] = { 6.0f, -6.0f, -9.0f, 5.0f };
+
+stdlib_complex64_t out = c_cdotc( 2, (void *)x, 1, (void *)y, 1 );
+```
+
+The function accepts the following arguments:
+
+-   **N**: `[in] CBLAS_INT` number of indexed elements.
+-   **X**: `[in] void*` first input array.
+-   **strideX**: `[in] CBLAS_INT` index increment for `X`.
+-   **Y**: `[in] void*` second input array.
+-   **strideY**: `[in] CBLAS_INT` index increment for `Y`.
+
+```c
+stdlib_complex64_t c_cdotc( const CBLAS_INT N, const void *X, const CBLAS_INT strideX, const void *Y, const CBLAS_INT strideY );
+```
+
+#### c_cdotc_ndarray( N, \*X, strideX, offsetX, \*Y, strideY, offsetY )
+
+Calculates the dot product `x^H * y` of `x` and `y` using alternative indexing semantics.
+
+```c
+#include "stdlib/complex/float32/ctor.h"
+
+float x[] = { 7.0f, -8.0f, -1.0f, -9.0f };
+float y[] = { 6.0f, -6.0f, -9.0f, 5.0f };
+
+stdlib_complex64_t out = c_cdotc_ndarray( 2, (void *)x, 1, 0, (void *)y, 1, 0 );
+```
+
+The function accepts the following arguments:
+
+-   **N**: `[in] CBLAS_INT` number of indexed elements.
+-   **X**: `[in] void*` first input array.
+-   **strideX**: `[in] CBLAS_INT` index increment for `X`.
+-   **offsetX**: `[in] CBLAS_INT` starting index for `X`.
+-   **Y**: `[in] void*` second input array.
+-   **strideY**: `[in] CBLAS_INT` index increment for `Y`.
+-   **offsetY**: `[in] CBLAS_INT` starting index for `Y`.
+
+```c
+stdlib_complex64_t c_cdotc_ndarray( const CBLAS_INT N, const void *X, const CBLAS_INT strideX, const CBLAS_INT offsetX, const void *Y, const CBLAS_INT strideY, const CBLAS_INT offsetY );
+```
+
+</section>
+
+<!-- /.usage -->
+
+<!-- C API usage notes. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
+<section class="notes">
+
+</section>
+
+<!-- /.notes -->
+
+<!-- C API usage examples. -->
+
+<section class="examples">
+
+### Examples
+
+```c
+#include "stdlib/blas/base/cdotc.h"
+#include "stdlib/complex/float32/ctor.h"
+#include "stdlib/complex/float32/reim.h"
+#include <stdio.h>
+
+int main( void ) {
+    // Create strided arrays of interleaved real and imaginary components:
+    float x[] = { 7.0f, -8.0f, -1.0f, -9.0f };
+    float y[] = { 6.0f, -6.0f, -9.0f, 5.0f };
+
+    // Specify the number of elements:
+    const int N = 2;
+
+    // Specify stride lengths:
+    const int strideX = 1;
+    const int strideY = 1;
+
+    // Compute the dot product:
+    stdlib_complex64_t dot = c_cdotc( N, (void *)x, strideX, (void *)y, strideY );
+
+    // Print the result:
+    float re;
+    float im;
+    stdlib_complex64_reim( dot, &re, &im );
+    printf( "cdotc( x, y ) = %f + %fi\n", re, im );
+
+    // Compute the dot product using alternative indexing semantics:
+    dot = c_cdotc_ndarray( N, (void *)x, -strideX, 1, (void *)y, strideY, 0 );
+
+    // Print the result:
+    stdlib_complex64_reim( dot, &re, &im );
+    printf( "cdotc( x, y ) = %f + %fi\n", re, im );
+}
+```
+
+</section>
+
+<!-- /.examples -->
+
+</section>
+
+<!-- /.c -->
+
 <!-- Section for related `stdlib` packages. Do not manually edit this section, as it is automatically populated. -->
 
 <section class="related">
 
+* * *
+
+## See Also
+
+-   <span class="package-name">[`@stdlib/blas/base/cdotu`][@stdlib/blas/base/cdotu]</span><span class="delimiter">: </span><span class="description">calculate the dot product of two single-precision complex floating-point vectors.</span>
+-   <span class="package-name">[`@stdlib/blas/base/zdotc`][@stdlib/blas/base/zdotc]</span><span class="delimiter">: </span><span class="description">calculate the dot product of two double-precision complex floating-point vectors, conjugating the first vector.</span>
+
 </section>
 
 <!-- /.related -->
@@ -175,6 +322,12 @@ console.log( out );
 
 [mdn-typed-array]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray
 
+<!-- <related-links> -->
+
+[@stdlib/blas/base/cdotu]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/base/cdotu
+
+[@stdlib/blas/base/zdotc]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/base/zdotc
+
 <!-- </related-links> -->
 
 </section>