Skip to content

COMP: Replace dynamic DESCRIPTION in PolarTransform itk-module.cmake#6245

Merged
hjmjohnson merged 1 commit into
InsightSoftwareConsortium:mainfrom
hjmjohnson:hj/fix-polartransform-cmake-warnings
May 9, 2026
Merged

COMP: Replace dynamic DESCRIPTION in PolarTransform itk-module.cmake#6245
hjmjohnson merged 1 commit into
InsightSoftwareConsortium:mainfrom
hjmjohnson:hj/fix-polartransform-cmake-warnings

Conversation

@hjmjohnson
Copy link
Copy Markdown
Member

Drop the file(READ README.md DOCUMENTATION) preamble in Modules/Filtering/PolarTransform/itk-module.cmake and use a static one-line DESCRIPTION. Silences 4 Unknown argument AUTHOR_WARNINGs on every configure.

Root cause

itk_module() is a CMake macro, so ${ARGN} re-tokenizes its arguments and list-splits any embedded ;. The PolarTransform README.md contains 4 semicolons, producing 4 spurious CMake Warning (dev): Unknown argument [...] messages from CMake/ITKModuleMacros.cmake:111.

Prior art
Verification

Drop the file(READ README.md DOCUMENTATION) preamble and replace
DESCRIPTION "${DOCUMENTATION}" with a static one-liner.

itk_module() is a CMake macro, so ARGN re-tokenizes its arguments and
list-splits any embedded ';' characters. The PolarTransform README
contains 4 semicolons, producing 4 spurious "Unknown argument"
AUTHOR_WARNINGs from CMake/ITKModuleMacros.cmake:111 on every
configure.

Same canonical fix applied in PR InsightSoftwareConsortium#6220 to RLEImage, SplitComponents,
IOFDF, IOMeshMZ3, IOMeshSTL; PolarTransform was missed because it
landed in parallel. The v4 ingestion pipeline (PR InsightSoftwareConsortium#6204) prevents
this regression via sanitize-history.py:patch_dynamic_description.
@github-actions github-actions Bot added type:Compiler Compiler support or related warnings area:Filtering Issues affecting the Filtering module labels May 9, 2026
hjmjohnson added a commit to hjmjohnson/ITK that referenced this pull request May 9, 2026
Replace the set(DOCUMENTATION "...") + DESCRIPTION "${DOCUMENTATION}"
indirection with a static one-liner literal.

itk_module() is a CMake macro, so ${ARGN} re-tokenizes its arguments
and list-splits any embedded ";". A future edit adding a semicolon or
"[" to the DOCUMENTATION string would silently produce spurious
"Unknown argument" AUTHOR_WARNINGs from CMake/ITKModuleMacros.cmake:111
on every configure (see PRs InsightSoftwareConsortium#6220, InsightSoftwareConsortium#6245).

The v4 ingestion pipeline (PR InsightSoftwareConsortium#6204) enforces this via
sanitize-history.py:patch_dynamic_description.
hjmjohnson added a commit to hjmjohnson/ITK that referenced this pull request May 9, 2026
Replace the set(DOCUMENTATION "...") + DESCRIPTION "${DOCUMENTATION}"
indirection with a static one-liner literal.

itk_module() is a CMake macro, so ${ARGN} re-tokenizes its arguments
and list-splits any embedded ";". A future edit adding a semicolon or
"[" to the DOCUMENTATION string would silently produce spurious
"Unknown argument" AUTHOR_WARNINGs from CMake/ITKModuleMacros.cmake:111
on every configure (see PRs InsightSoftwareConsortium#6220, InsightSoftwareConsortium#6245).

The v4 ingestion pipeline (PR InsightSoftwareConsortium#6204) enforces this via
sanitize-history.py:patch_dynamic_description.
@hjmjohnson hjmjohnson marked this pull request as ready for review May 9, 2026 13:08
@greptile-apps

This comment was marked as resolved.

hjmjohnson added a commit to hjmjohnson/ITK that referenced this pull request May 9, 2026
Replace the set(DOCUMENTATION "...") + DESCRIPTION "${DOCUMENTATION}"
indirection with a static one-liner literal.

itk_module() is a CMake macro, so ${ARGN} re-tokenizes its arguments
and list-splits any embedded ";". A future edit adding a semicolon or
"[" to the DOCUMENTATION string would silently produce spurious
"Unknown argument" AUTHOR_WARNINGs from CMake/ITKModuleMacros.cmake:111
on every configure (see PRs InsightSoftwareConsortium#6220, InsightSoftwareConsortium#6245).

The v4 ingestion pipeline (PR InsightSoftwareConsortium#6204) enforces this via
sanitize-history.py:patch_dynamic_description.
@hjmjohnson hjmjohnson merged commit 7820bbc into InsightSoftwareConsortium:main May 9, 2026
20 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:Filtering Issues affecting the Filtering module type:Compiler Compiler support or related warnings

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants