Initial import of libdpf.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Ryan Henry 2026-09-24 14:08:32 -06:00
commit e4e666f459
4563 changed files with 1690372 additions and 0 deletions

269
doc/libdpf.md Normal file
View file

@ -0,0 +1,269 @@
\mainpage notitle
<a id="mainpage"/>
[TOC]
![](libdpf-tagline.png)
%LIBDPF_INCLUDE_GETTING_STARTED_INTRODUCTION%
- - -
<div style="float:left; color:#999;">&larr;&nbsp;Prev</div>
<div style="float:right;">[Next&nbsp;&rarr;](@ref basics)</div>
<!-- PAGE SEPARATOR -->
\page basics DPF Basics
[TOC]
%LIBDPF_INCLUDE_GETTING_DPF_BASICS%
- - -
<div style="float:left; color:#999;">[&larr;&nbsp;Prev](mainpage)</div>
<div style="float:right;">[Next&nbsp;&rarr;](@ref getting_started)</div>
<!-- PAGE SEPARATOR -->
\page getting_started Getting Started
[TOC]
The getting started guide consists of the following subsections.
- \subpage input_types
- \subpage output_types
- \subpage evaluation
- \subpage iterables
- - -
<div style="float:left;">[&larr;&nbsp;Prev](@ref mainpage)</div>
<div style="float:right;">[Next&nbsp;&rarr;](@ref input_types)</div>
<!-- PAGE SEPARATOR -->
\page input_types Input Types
[TOC]
%LIBDPF_INCLUDE_GETTING_STARTED_INPUT_TYPES%
- - -
<div style="float:left;">[&larr;&nbsp;Prev](@ref getting_started)</div>
<div style="float:right;">[Next&nbsp;&rarr;](@ref output_types)</div>
<!-- PAGE SEPARATOR -->
\page output_types Output Types
[TOC]
%LIBDPF_INCLUDE_GETTING_STARTED_OUTPUT_TYPES%
- - -
<div style="float:left;">[&larr;&nbsp;Prev](@ref input_types)</div>
<div style="float:right;">[Next&nbsp;&rarr;](@ref evaluation)</div>
<!-- PAGE SEPARATOR -->
\page evaluation Evaluating DPFs
[TOC]
%LIBDPF_INCLUDE_GETTING_STARTED_EVALUATION%
- - -
<div style="float:left;">[&larr;&nbsp;Prev](@ref output_types)</div>
<div style="float:right;">[Next&nbsp;&rarr;](@ref iterables)</div>
<!-- PAGE SEPARATOR -->
\page iterables Iterables
[TOC]
%LIBDPF_INCLUDE_GETTING_STARTED_ITERABLES%
- - -
<div style="float:left;">[&larr;&nbsp;Prev](@ref evaluation)</div>
<div style="float:right;">[Next&nbsp;&rarr;](@ref pir)</div>
<!-- PAGE SEPARATOR -->
\page pir PIR
[TOC]
The getting started guide consists of the following subsections.
- \subpage pir1
- \subpage pir2
- - -
<div style="float:left;">[&larr;&nbsp;Prev](@ref iterable)</div>
<div style="float:right;">[Next&nbsp;&rarr;](@ref pir1)</div>
\page pir1 PIR1
[TOC]
%LIBDPF_INCLUDE_PIR_PIR1%
- - -
<div style="float:left;">[&larr;&nbsp;Prev](@ref evaluation)</div>
<div style="float:right;">[Next&nbsp;&rarr;](@ref miscellany)</div>
\page miscellany Miscellany
[TOC]
The miscellany page consists of the following subpages.
- \subpage bugs
- \subpage changes
- \subpage todo
- \subpage submodules
- \subpage authors
- \subpage license
- - -
<div style="float:left;">[&larr;&nbsp;Prev](@ref pir)</div>
<div style="float:right;">[Next&nbsp;&rarr;](@ref bugs)</div>
<!-- PAGE SEPARATOR -->
\page bugs Bugs
[TOC]
%LIBDPF_INCLUDE_MISC_BUGS%
- - -
<div style="float:left;">[&larr;&nbsp;Prev](@ref miscellany)</div>
<div style="float:right;">[Next&nbsp;&rarr;](@ref changes)</div>
<!-- PAGE SEPARATOR -->
\page changes CHANGELOG
[TOC]
%LIBDPF_INCLUDE_MISC_CHANGES%
- - -
<div style="float:left;">[&larr;&nbsp;Prev](@ref bugs)</div>
<div style="float:right;">[Next&nbsp;&rarr;](@ref todo)</div>
<!-- PAGE SEPARATOR -->
\page todo TODO list
[TOC]
%LIBDPF_INCLUDE_MISC_TODO%
- - -
<div style="float:left;">[&larr;&nbsp;Prev](@ref changes)</div>
<div style="float:right;">[Next&nbsp;&rarr;](@ref submodules)</div>
<!-- PAGE SEPARATOR -->
\page submodules Submodules
[TOC]
%LIBDPF_INCLUDE_MISC_SUBMODULES%
- - -
<div style="float:left;">[&larr;&nbsp;Prev](@ref todo)</div>
<div style="float:right;">[Next&nbsp;&rarr;](@ref authors)</div>
<!-- PAGE SEPARATOR -->
\page authors Authors
[TOC]
%LIBDPF_INCLUDE_MISC_AUTHORS%
- - -
<div style="float:left;">[&larr;&nbsp;Prev](@ref submodules)</div>
<div style="float:right;">[Next&nbsp;&rarr;](@ref license)</div>
<!-- PAGE SEPARATOR -->
\page license License
[TOC]
%LIBDPF_INCLUDE_MISC_LICENSE%
- - -
<div style="float:left;">[&larr;&nbsp;Prev](@ref authors)</div>
<div style="float:right;">[Next&nbsp;&rarr;](@ref listings)</a></div>
<!-- PAGE SEPARATOR -->
\page listings Code Listings
[TOC]
%LIBDPF_INCLUDE_CODE_LISTINGS%
- - -
<div style="float:left;">[&larr;&nbsp;Prev](@ref license)</div>
<div style="float:right; color:#999;">Next&nbsp;&rarr;</div>