5.2 Citing Between Books

2 min read

5.2.1 Within a book #

A reference to another part of the same book omits the book name:

The claim-path set is the union defined in §5.23.

5.2.2 Between books #

A reference to another book leads with that book's short name:

A dependency is satisfied when the conditions of PSPU §5.21 hold.

The short name is the one declared in the book's own metadata — PCDS, PGSS, PSPK, PSPU. A reference to a manual names the component: the peipkg TRM §7.4.

5.2.3 Referring to a whole book #

All identifiers in this chapter conform to PCDS.

5.2.4 Prose and the reference are different things #

A citation MAY be accompanied by prose naming what is at the other end:

Sender authentication is performed by peer credential (§4.18).

The descriptor store article (§4.20) defines the retention rules.

The § reference is the durable part. The prose is a readability aid, and it MAY drift across revisions without invalidating the reference — which is also why prose alone is not a citation.

5.2.5 In code and in commit messages #

A code comment or a test referring to a documented rule SHOULD carry the full citation, so that a search finds every site depending on it:

/* Per PCDS §5.6: inherited ACEs precede explicit ones. */

Edit this page