When we find ourselves in vm_fault()'s "fast path", we check to see if the 4 KB page that we faulted on belongs to an existing 2 MB superpage. (Imagine that another process or processes with whom we share memory have already fully validated the superpage.) Moreover, we check to see if the current process has the entire superpage mapped in its address at the machine-independent layer (just not in its page table). If these conditions are met, then we instruct pmap_enter() to create a 2 MB page mapping, bypassing the promotion process. This change results in a significant reduction in the number of page faults for PostgreSQL.
Currently, there is one edge-case involving the use of pmap_enter(psind == 1) on the kernel pmap that isn't handled. Specifically, the patch doesn't handle an allocation failure for a radix trie node required to maintain the kernel page table page in reserve after creating the 2 MB page mapping. However, the fast path shouldn't be creating kernel mappings.
This paragraph has similar issues to the one from the other manual page reviewed by @bcr.