Cockatrice/doc/doxygen
Lukas Brübach 9c60ae98d4 Extract the shared reveal helper and name the test's CardRef fields
RickyRister asked for cmdRevealCards and cmdRevealRandomCards to share a
helper instead of threading a randomCount parameter through the reveal
virtual. Restore the three-argument cmdRevealCards signature, resolve the
reveal preconditions and zone in resolveRevealZone, and let both commands
build their card list and hand it to revealCards, which owns the private and
public Event_RevealCards construction and the enqueue. The random command no
longer fabricates a Command_RevealCards with the -2 sentinel to re-enter the
legacy path; its behaviour is unchanged.

Name the CardRef fields in random_reveal_test instead of relying on
declaration order, and state in the user documentation that a rejected
reveal is not reported in the client, matching what the client does.
2026-11-08 09:51:31 +01:00
..
css Docs: Use doxygen-awesome-css theme (#6512) 2026-01-24 11:22:43 +01:00
filters [Networking] Doxygen (#7030) 2026-07-27 11:27:00 +02:00
groups Doxygen: Improve file structure and includes (#6344) 2025-11-22 19:38:39 +01:00
html [Doxygen] Add javascript to toggle call/caller graph visibility. (#6195) 2025-09-28 21:22:37 +02:00
images [Docs] Add app logo to main page + cleanup (#7471) 2026-10-10 23:48:37 +02:00
js [Doxygen] Add javascript to toggle call/caller graph visibility. (#6195) 2025-09-28 21:22:37 +02:00
pages Extract the shared reveal helper and name the test's CardRef fields 2026-11-08 09:51:31 +01:00
theme@46483f1e5a Bump doc/doxygen/theme from d52eafe to 46483f1 (#7371) 2026-10-01 20:59:20 +02:00
DoxygenLayout.xml Docs: Use doxygen-awesome-css theme (#6512) 2026-01-24 11:22:43 +01:00
README.md [Docs] Add app logo to main page + cleanup (#7471) 2026-10-10 23:48:37 +02:00

Building Doxygen Documentation

We use Doxygen for our code documentation.
After installing the tool, you can build a HTML webpage into the /docs folder according to our configuration:

doxygen Doxyfile

Open the index.html file in the /docs/html/ folder to browse the result locally.
There is also an online version we host at the Cockatrice webpage: cockatrice.github.io/docs

Doxygen's own documenation can be found at www.doxygen.nl/manual.


Doxygen Documentation Theme

Required changes to the Doxyfile config from the theme docs to make doxygen-awesome-css work:

HTML_EXTRA_STYLESHEET  = doxygen-awesome.css      # Main CSS file of the theme
GENERATE_TREEVIEW      = YES                      # Optional, also works without
HTML_COLORSTYLE        = LIGHT                    # Required with doxygen-awesome-css theme, Auto Dark Mode will still work
DISABLE_INDEX          = NO                       # YES is bugged in the theme, see jothepro/doxygen-awesome-css/issues/201
FULL_SIDEBAR           = NO                       # Required for doxygen-awesome-css theme

Cockatrice dedicated color adjustments are configured in the cockatrice_docs_style.css file that uses & overrides the theme definitions.