Skip to content
go-libfossil Artifact [d005ce82b4]
Login

Artifact [d005ce82b4]

Artifact d005ce82b4fdc484275c1cc8430b8785aafeb86a92ed827cad0155655fdb1769:


// Package conformance checks go-libfossil against the Fossil Internet-Drafts
// in rfcs/, requirement by requirement.
//
// The package holds no library code; everything is in its tests. Each draft
// has a requirements table in requirements/, written from the draft text, and
// a test file whose cases name the requirement they exercise. Coverage is
// derived from the cases, never recorded by hand: a requirement with no case
// is a GAP, one whose cases all conform is COVERED (or PARTIAL when its table
// row says what the cases leave out), and one with a case that is known to
// fail is FAILING until the issue that case names is fixed.
//
// What counts as correct, in order:
//
//  1. The draft text. Each draft records its corrections in its own Changes
//     appendix; there are no separate errata.
//  2. fossil(1), run on the same input wherever the draft is silent. A case
//     that expects something fossil(1) does not do must say why.
//  3. zit and libfossil, whose own suites inform which cases to write.
//
// A case that fails is marked with the issue tracking the fix and is skipped;
// once it passes, it fails until the mark is removed, so the list of known
// failures cannot go stale. Set CONFORMANCE_REPORT to a file path to have the
// coverage test write a Markdown report there.
package conformance