$ show p4lang/p4-spec
The p4lang/p4-spec repository hosts the P4 language specification and related artifacts, including the Portable Switch Architecture (PSA) definition, example P4 programs, and documentation build tools. It contains versioned specifications for P4_14 (in maintenance mode) and P4_16 (active), along with PSA compliance requirements and illustrative examples such as mTag edge/aggregation switches and PSA-based programs for counters, registers, and telemetry. The repository includes a documentation pipeline composed of Makefiles, AsciiDoc/Latex sources, and custom scripts (e.g., pretext.py, trim-asciidoc-tag-comments.py) that generate PDF and HTML outputs, ensuring consistent specification publication. Additionally, it provides utility scripts for font license compliance and grammar validation, supporting the maintenance of the specification as a technical standard for programmable network data planes.
The LLM identified 2 files worth highlighting for reuse:
A Makefile-driven documentation pipeline that processes AsciiDoc and LaTeX sources to generate PDF and HTML outputs. Includes custom scripts for conditional content handling and grammar validation, demonstrating a reusable pattern for technical specification maintenance.
A shell script that automates the addition of copyright notices to font files based on their licenses. Solves the recurring problem of font license compliance in documentation projects, demonstrating a non-obvious data engineering skill in metadata handling and license adherence.