llvm/libc/docs/ground_truth_specification.rst
Siva Chandra Reddy b47f9eb55d [libc] Add a TableGen based header generator.
Summary:
* The Python header generator has been removed.
* Docs giving a highlevel overview of the header gen scheme have been
  added.

Reviewers: phosek, abrachet

Subscribers: mgorny, MaskRay, tschuett, libc-commits

Tags: #libc-project

Differential Revision: https://reviews.llvm.org/D70197
2019-11-22 13:02:24 -08:00

12 lines
649 B
ReStructuredText

The ground truth of standards
=============================
Like any modern libc, LLVM libc also supports a wide number of standards and
extensions. To avoid developing headers, wrappers and sources in a disjointed
fashion, LLVM libc employs ground truth files. These files live under the
``spec`` directory and list ground truth corresponding the ISO C standard, the
POSIX extension standard, etc. For example, the path to the ground truth file
for the ISO C standard is ``spec/stdc.td``. Tools like the header generator
(described in the header generation document), docs generator, etc. use the
ground truth files to generate headers, docs etc.