diff --git a/doc/jemalloc.xml.in b/doc/jemalloc.xml.in
index bbccabd7..d7b33582 100644
--- a/doc/jemalloc.xml.in
+++ b/doc/jemalloc.xml.in
@@ -1191,7 +1191,8 @@ malloc_conf = "xmalloc:true";]]>
the jeprof command, which is based on the
pprof that is developed as part of the gperftools
- package.
+ package. See HEAP PROFILE
+ FORMAT for heap profile format documentation.
@@ -2623,6 +2624,53 @@ typedef struct {
+
+ HEAP PROFILE FORMAT
+ Although the heap profiling functionality was originally designed to
+ be compatible with the
+ pprof command that is developed as part of the gperftools
+ package, the addition of per thread heap profiling functionality
+ required a different heap profile format. The jeprof
+ command is derived from pprof, with enhancements to
+ support the heap profile format described here.
+
+ In the following hypothetical heap profile, [...]
+ indicates elision for the sake of compactness. The following matches the above heap profile, but most
+tokens are replaced with <description> to indicate
+descriptions of the corresponding fields. /
+ : : [: ]
+ [...]
+ : : [: ]
+ [...]
+ : : [: ]
+ [...]
+@ [...] [...]
+ : : [: ]
+ : : [: ]
+ : : [: ]
+[...]
+
+MAPPED_LIBRARIES:
+/maps>]]>
+
+
DEBUGGING MALLOC PROBLEMSWhen debugging, it is a good idea to configure/build jemalloc with