Document the pip install path, and fix the stale test and command references

[HugoFara]

Three findings from the documentation audit, the ones that send a reader somewhere wrong.

1. The documentation site never mentioned pip

$ grep -rni "pip\|pypi\|wheel" docs/source
$

Nothing. The README's headline instruction is pip install forefire, and the site sent every reader to build from source instead — with a NetCDF dependency they do not need, since it is bundled in the wheel.

installation.rst now leads with pip: which platforms have wheels, what the wheel contains, and the three things it does not have (MPI, -march=native, ANN_test). The source build follows, unchanged in substance. quickstart.rst offered Docker only, calling it "the quickest way"; a pip route comes first now, and the Docker walkthrough is untouched.

Two things fixed along the way:

• The NetCDF prerequisite told the reader to answer the documentation's own question:"Ensure this is the correct/intended library. Older docs might mention libnetcdf-cxx-legacy-dev. Verify which one is actually required by the current CMake setup."CMakeLists.txt searches for netcdf_c++4, netcdf-cxx4 and netcdf-cxx, and its failure message already lists the package per distribution. That table is now in the page, with the note that libnetcdf-cxx-legacy-dev is a different, pre-C++4 API.
• conf.py hard-coded release = '2.0.0', so the site advertised 2.0.0 while the code was v2.5.0. It parses src/include/Version.h, the same file CMake and scikit-build-core read.

2. tests/README.md was wrong in nearly every row

Claim	Reality
idealized_wind.py	the file is idealizedwind.py
rothermel.fann	the file is Rothermel.ffann
runANN needs tensorflow (or torch)	it needs neither — bin/ANN_test, and ForeFire reads the .ffann itself
runANN "compares with reference outputs"	it diffs against result.txt.ref, which is not in the repository
percolation.py runs "three fires"	four, one per entry in k_coeffs
idealizedwind.py produces "NetCDF files"	only 360wind.png, via ForeFire's plot[]

The runANN entry now says plainly that the suite fails, with a pointer to #163.

runff also has two entry points that do different things, and the old text described neither: run.bash runs three scenarios and checks the artefacts exist; ff-run.bash runs two and compares KML and NetCDF against references. CI calls the second, so only the second can catch physics drift.

tests/python/README.md documented only farsite_flat.py — the one script that cannot run as checked out, because flatland.lcp is not in the repository — and did not mention that. It now covers all four files and keeps the download URL.

3. emit was invisible to the console

trans["emit"] = &emit; has been in Command::makeCmds since it was added, but emit appears in neither app/forefire/commands.md nor the command reference.

That file is not prose. AdvancedLineEditor.cpp:32 parses it into getCommandMan(), which drives Tab completion, the help text and the syntax colouring. A command missing from it is invisible to the console's own help.

Before, typing emit rendered uncoloured — exactly like a typo — while save beside it came out green. After:

forefire> emit <- green
forefire> clear <- green
forefire> nosuchcommand <- plain

commands.md also carried two## clear blocks. getCommandMan() assigns cmdMan[key] as it walks the file, so the second silently replaced the first and the longer entry was dead text. They are merged into one that matches what Command::clear actually does: free the domain, cancel scheduled events, keep the parameters.

Both files now cover all 22 registered commands, with no duplicates:

$ comm -23 <(registered) <(documented) # nothing

Not touching the open pull requests

This branch does not touch CHANGELOG.md, CONTRIBUTING.md or README.md — the only three files #184 and #185 change — so it merges in any order relative to them. No changelog entry is included for the same reason: CHANGELOG.md does not exist on master until #184 lands.

Verification

• Sphinx builds with no new warnings. The eleven that remain are the doxygenclass lookups that need the Doxygen XML RTD generates in its pre_build step.
• The console behaviour above was checked against a rebuilt binary, with a nonsense word as the negative control.
• Every file name, package name and script behaviour in the corrected READMEs was read out of the tree rather than carried over.

---

This pull request, including its code changes and this description, was generated by Claude Opus 5, and reviewed manually before submitting.

[antonio-leblanc]

ok only documentarion.
Commands.md is used in autocomplete on the forefire shell but ok nothin breaks