From cbcd4408e3dd5700289b8618c887eb04541366ff Mon Sep 17 00:00:00 2001
From: Clayton Craft <clayton@craftyguy.net>
Date: Sat, 18 Feb 2023 21:41:54 -0800
Subject: [PATCH] doc/mkinitfs.1: Fill in DEVICEINFO section

---
 doc/mkinitfs.1.scd | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/doc/mkinitfs.1.scd b/doc/mkinitfs.1.scd
index 1dde2de..5f5bb29 100644
--- a/doc/mkinitfs.1.scd
+++ b/doc/mkinitfs.1.scd
@@ -26,7 +26,19 @@ boot-related items onto the system.
 
 # DEVICEINFO
 
-TODO: where is this specified?
+The canonical deviceinfo "specification" is at
+https://wiki.postmarketos.org/wiki/Deviceinfo_reference
+
+mkinitfs reads deviceinfo values from */etc/deviceinfo*. The following variables
+are *required* by mkinitfs:
+
+	- deviceinfo_initfs_compression
+	- deviceinfo_mesa_driver
+	- deviceinfo_modules_initfs
+	- deviceinfo_uboot_boardname
+
+It is a design goal to keep the number of required variables from deviceinfo to
+a bare minimum, and to require only variables that don't hold lists of things.
 
 # DIRECTORIES