From 5c96a025f12f3dbfe63ea19782e8bf3eeffe9e42 Mon Sep 17 00:00:00 2001 From: arimu1 <19286898+arimu1@users.noreply.github.com> Date: Thu, 18 Jun 2026 20:37:35 +0700 Subject: [PATCH 1/2] docs: link cwl-docker-extract from CWL_SINGULARITY_CACHE help (#1537) Issue #1537 asked to document CWL_SINGULARITY_CACHE and link to the cwl-utils "pull all referenced software container images" reference. The variable itself is now listed in the environment-variable table (shown in `cwltool --help` and the Sphinx CLI docs), but it did not point users at how to pre-populate the cache. Add a link to cwl-utils' cwl-docker-extract, using the existing [link=...] markup so it renders both as a terminal hyperlink and as a reStructuredText link in the generated docs. Co-Authored-By: Claude Opus 4.8 --- cwltool/argparser.py | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/cwltool/argparser.py b/cwltool/argparser.py index 0c4e51f3f..7e3d626a1 100644 --- a/cwltool/argparser.py +++ b/cwltool/argparser.py @@ -66,7 +66,9 @@ def arg_parser() -> argparse.ArgumentParser: env_table.add_env( "CWL_SINGULARITY_CACHE", f"directory path to find already downloaded Singularity images; " - f"[{bt}]dockerFile[/] images will also be searched for and stored here", + f"[{bt}]dockerFile[/] images will also be searched for and stored here. " + f"Images can be pre-pulled into this directory using " + f"[link=https://github.com/common-workflow-language/cwl-utils#pull-the-all-referenced-software-container-images]cwl-docker-extract[/] from cwl-utils", ) env_table.add_env( "ORCID", From f949b67ac0d8051bffbbc6e07242b6e95619710c Mon Sep 17 00:00:00 2001 From: arimu1 <19286898+arimu1@users.noreply.github.com> Date: Sat, 20 Jun 2026 09:55:19 +0700 Subject: [PATCH 2/2] docs: point cwl-docker-extract link at cwl-utils readthedocs (#1537) Per review feedback, link to the stable cwl-utils documentation page (https://cwl-utils.readthedocs.io/en/latest/#cwl-docker-extract) instead of the GitHub README anchor. --- cwltool/argparser.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/cwltool/argparser.py b/cwltool/argparser.py index 7e3d626a1..bf0d5c4ee 100644 --- a/cwltool/argparser.py +++ b/cwltool/argparser.py @@ -68,7 +68,7 @@ def arg_parser() -> argparse.ArgumentParser: f"directory path to find already downloaded Singularity images; " f"[{bt}]dockerFile[/] images will also be searched for and stored here. " f"Images can be pre-pulled into this directory using " - f"[link=https://github.com/common-workflow-language/cwl-utils#pull-the-all-referenced-software-container-images]cwl-docker-extract[/] from cwl-utils", + f"[link=https://cwl-utils.readthedocs.io/en/latest/#cwl-docker-extract]cwl-docker-extract[/] from cwl-utils", ) env_table.add_env( "ORCID",