Skip to content

Rewrite the installation section of the manual - #62

Merged
fingolfin merged 2 commits into
masterfrom
mh/modernize-install-docs
Oct 2, 2026
Merged

fingolfin merged 2 commits into
masterfrom
mh/modernize-install-docs

Conversation

@fingolfin

Copy link
Copy Markdown
Member

The installation section described a GAP 4.8.8 setup: /opt/gap4r8 paths, running ./configure && make in each package by hand, and loading transcripts whose banners show long-dead author homepages and FinInG 1.4.1.

The rewrite explains:

  • which dependencies need compiling: IO and cvec are mandatory, GRAPE's nauty is needed for collineation groups of generalised polygons and the ...WithNauty operations, and Orb's C code is optional;
  • how to compile them with BuildPackages.sh;
  • how to diagnose a LoadPackage that returns fail;
  • how to install a newer release into the user GAP root directory.

The sample banner already shows the contact details from mh/update-contact-details, which edits the same transcripts in doc/intro.xml. Whichever of the two merges second needs a trivial conflict resolution: take this branch's version.

🤖 Generated with Claude Code

The section described a GAP 4.8.8 installation: /opt/gap4r8 paths,
running configure and make in each package by hand, and transcripts
whose banners show dead author homepages and outdated versions.

Explain instead which dependencies need compiling and why, how to do
that with BuildPackages.sh, how to diagnose a failed LoadPackage, and
how to install a newer release into the user GAP root directory.

Assisted-by: Claude Code (Opus 5.5)
@codecov

codecov Bot commented Oct 1, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 53.55%. Comparing base (b5c0d01) to head (2b8f850).
⚠️ Report is 1 commits behind head on master.

Additional details and impacted files
@@           Coverage Diff           @@
##           master      #62   +/-   ##
=======================================
  Coverage   53.55%   53.55%           
=======================================
  Files          34       34           
  Lines       17059    17059           
=======================================
  Hits         9136     9136           
  Misses       7923     7923           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@fingolfin
fingolfin merged commit 9aef2a2 into master Oct 2, 2026
4 checks passed
@fingolfin
fingolfin deleted the mh/modernize-install-docs branch October 2, 2026 00:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant