Skip to content

build: install the upstream f2c manual page - #69

Merged
goroyabu merged 2 commits into
mainfrom
build/issue-61-install-manpage
Sep 18, 2026
Merged

goroyabu merged 2 commits into
mainfrom
build/issue-61-install-manpage

Conversation

@goroyabu

Copy link
Copy Markdown
Owner

Summary

  • Install the upstream roff manual source as share/man/man1/f2c.1 through GNUInstallDirs.
  • Document local manual lookup, including MANPATH handling for custom prefixes.
  • Verify the installed source, rendered sections, install manifest, and uninstall behavior in online and offline CI paths.

Related Issue

Closes #61

Verification

  • cmake --build build --parallel
  • ctest --test-dir build --output-on-failure — 63/63 tests passed.
  • Verified the installed manual source, .TH F2C 1 declaration, install manifest entry, and rendered NAME, SYNOPSIS, and DESCRIPTION sections with mandoc.
  • Verified man f2c using the staged manual directory through MANPATH.
  • Verified a strict offline build and installation with an overridden CMAKE_INSTALL_MANDIR.
  • Verified the downstream CMake example and incremental regeneration workflow.
  • Verified uninstall removes the manual page while preserving an unrelated staged file.

Linux rendering remains covered by the GitHub Actions matrix because the local verification environment is macOS.

Impact

Installs a new local f2c(1) manual page. Converter behavior, runtime behavior, and existing public CMake targets are unchanged.

Documentation

The README now lists the installed manual page and documents man f2c and custom-prefix MANPATH usage. The browser-accessible upstream manual link remains available.

Checklist

  • The change is focused on one coherent maintenance outcome.
  • Relevant local verification has been run and reported above.
  • User-facing workflows and supported behavior are documented when changed.
  • No downloaded upstream archives, extracted vendor sources, build outputs,
    or generated files were committed unintentionally.

@goroyabu
goroyabu merged commit 0479bd2 into main Sep 18, 2026
6 checks passed
@goroyabu
goroyabu deleted the build/issue-61-install-manpage branch September 18, 2026 15:20
@goroyabu goroyabu added the build Build system and packaging changes label Sep 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

build Build system and packaging changes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

build: install the upstream f2c manual page

1 participant