Re: [PATCH v2 02/15] genpt: Add Documentation/ files

On Mon, May 05, 2025 at 11:18:32AM -0300, Jason Gunthorpe wrote:

+Since each compilation unit can only access one underlying format at a time,
+code that is intended to be generic across multiple formats has to compile
+itself multiple times.
+
+In an implementation compilation unit the headers would normally be included as
+follows::
+
+	#include <linux/generic_pt/common.h>
+	#include "fmt/defs_amdv1.h"
+	#include "pt_defs.h"
+	#include "fmt/amdv1.h"
+	#include "pt_common.h"
+	#include "pt_iter.h"

What do you mean by compiling generic code multiple times? Including
their headers at multiple places like above?

+
+Which will build up all the definitions to operate an AMDv1 page table type.

"This will build up ..."

Thanks.

-- 
An old man doll... just what I always wanted! - Clara