X86/XEN: Add few lines explaining simple semantic for x86_init.paging.pagetable_init...

- Explain the purpose of the hook
- Report execution constraints

diff --git a/arch/x86/include/asm/x86_init.h b/arch/x86/include/asm/x86_init.h
index b6104e8cd00400ee24601faa4488c1f493cc6654..3055fa9f6cebe2b6d6c65ffecd13a16294f02c8b 100644 (file)
--- a/arch/x86/include/asm/x86_init.h
+++ b/arch/x86/include/asm/x86_init.h
@@ -97,6 +97,11 @@ struct x86_init_mapping {
 /**
  * struct x86_init_paging - platform specific paging functions
  * @pagetable_init:            platform specific paging initialization call
+ *
+ * It does setup the kernel pagetables and prepares accessors functions to
+ * manipulate them.
+ * It must be called once, during the boot sequence and after the direct
+ * mapping for phys memory is setup.
  */
 struct x86_init_paging {
        void (*pagetable_init)(void);