fix(build): add new make rule to build docs

Add the rule to avoid hitting shell limits.

Fixes: #6583
Private-ref: #6583

---
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: passed
  - 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: na
  - 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: karanBRAVO

.gitignore

@@ -20,6 +20,7 @@
 #########
 package.json.copy
 .stdlibrc
+sources.txt
 
 # Directories #
 ###############

tools/make/README.md

@@ -22,7 +22,7 @@ limitations under the License.
 
 > Development utility.
 
-This project uses [`make`][make] as its development utility. For an overview of `make`, see the `make` [manual][make]. 
+This project uses [`make`][make] as its development utility. For an overview of `make`, see the `make` [manual][make].
 
 ## Usage
 
@@ -405,6 +405,12 @@ To generate documentation from [JSDoc][jsdoc] source code comments,
 $ make docs-src
 ```
 
+sometimes you might get an error `Argument listing too long` then use,
+
+```bash
+$ make src-docs-out
+```
+
 To view the documentation in a local web browser,
 
 ```bash

tools/make/lib/docs/jsdoc.mk

@@ -85,6 +85,18 @@ jsdoc-html: $(NODE_MODULES)
 
 .PHONY: jsdoc-html
 
+# Generate JSDoc HTML documentation.
+#
+# See issue #6583
+
+jsdoc-html-out: $(NODE_MODULES)
+	$(QUIET) $(DELETE) $(DELETE_FLAGS) $(JSDOC_HTML_OUT)
+	$(QUIET) $(MKDIR_RECURSIVE) $(JSDOC_HTML_OUT)
+	$(QUIET) find . -type f -name "$(SOURCES_PATTERN)" > sources.txt
+	$(QUIET) cat sources.txt | xargs $(JSDOC) $(JSDOC_HTML_FLAGS) $(JSDOC_TYPEDEF)
+
+.PHONY: jsdoc-html-out
+
 
 # Generate JSDoc JSON.
 #

tools/make/lib/docs/src.mk

@@ -47,6 +47,23 @@ endif
 .PHONY: src-docs
 
 
+# Generate source documentation.
+#
+# use this if you get error
+# "Argument Listing too long"
+#
+# ```bash
+# make src-docs-out
+# ```
+
+src-docs-out:
+ifeq ($(SRC_DOC_GENERATOR), jsdoc)
+	$(QUIET) $(MAKE) -f $(this_file) jsdoc-html-out
+endif
+
+.PHONY: src-docs-out
+
+
 # View HTML documentation.
 #
 # This target opens source HTML documentation in a local web browser.