diff --git a/doc/jemalloc.xml.in b/doc/jemalloc.xml.in index 22b3d803..747cc071 100644 --- a/doc/jemalloc.xml.in +++ b/doc/jemalloc.xml.in @@ -375,7 +375,7 @@ The mallctlnametomib() function provides a way to avoid repeated name lookups for applications that repeatedly query the same portion of the namespace, by translating a name - to a “Management Information Base” (MIB) that can be passed + to a Management Information Base (MIB) that can be passed repeatedly to mallctlbymib(). Upon successful return from mallctlnametomib(), mibp contains an array of @@ -415,20 +415,21 @@ for (i = 0; i < nbins; i++) { function pointer and cbopaque data passed to write_cb, or malloc_message() if write_cb is NULL. The - statistics are presented in human-readable form unless "J" is specified as - a character within the opts string, in which case - the statistics are presented in JSON - format. This function can be called repeatedly. General - information that never changes during execution can be omitted by - specifying "g" as a character within the opts - string. Note that malloc_message() uses the + statistics are presented in human-readable form unless J is + specified as a character within the opts string, in + which case the statistics are presented in JSON format. This function can be + called repeatedly. General information that never changes during + execution can be omitted by specifying g as a character + within the opts string. Note that + malloc_message() uses the mallctl*() functions internally, so inconsistent statistics can be reported if multiple threads use these functions simultaneously. If is specified during - configuration, “m” and “a” can be specified to - omit merged arena and per arena statistics, respectively; “b” - and “l” can be specified to omit per size class statistics for - bins and large objects, respectively. Unrecognized characters are + configuration, m and a can be specified to + omit merged arena and per arena statistics, respectively; b + and l can be specified to omit per size class statistics + for bins and large objects, respectively. Unrecognized characters are silently ignored. Note that thread caching may prevent some statistics from being completely up to date, since extra locking would be required to merge counters that track thread cache operations. @@ -454,7 +455,7 @@ for (i = 0; i < nbins; i++) { The string specified via , the string pointed to by the global variable malloc_conf, the - “name” of the file referenced by the symbolic link named + name of the file referenced by the symbolic link named /etc/malloc.conf, and the value of the environment variable MALLOC_CONF, will be interpreted, in that order, from left to right as options. Note that @@ -891,12 +892,12 @@ for (i = 0; i < nbins; i++) { settings are supported if sbrk 2 is supported by the operating - system: “disabled”, “primary”, and - “secondary”; otherwise only “disabled” is - supported. The default is “secondary” if + system: disabled, primary, and + secondary; otherwise only disabled is + supported. The default is secondary if sbrk 2 is supported by the operating - system; “disabled” otherwise. + system; disabled otherwise. @@ -963,15 +964,16 @@ for (i = 0; i < nbins; i++) { r- [] - Junk filling. If set to "alloc", each byte of - uninitialized allocated memory will be initialized to - 0xa5. If set to "free", all deallocated memory will - be initialized to 0x5a. If set to "true", both - allocated and deallocated memory will be initialized, and if set to - "false", junk filling be disabled entirely. This is intended for - debugging and will impact performance negatively. This option is - "false" by default unless is specified - during configuration, in which case it is "true" by + Junk filling. If set to alloc, each byte + of uninitialized allocated memory will be initialized to + 0xa5. If set to free, all deallocated + memory will be initialized to 0x5a. If set to + true, both allocated and deallocated memory will be + initialized, and if set to false, junk filling be + disabled entirely. This is intended for debugging and will impact + performance negatively. This option is false by default + unless is specified during + configuration, in which case it is true by default. @@ -2445,7 +2447,7 @@ MAPPED_LIBRARIES: of run-time assertions that catch application errors such as double-free, write-after-free, etc. - Programs often accidentally depend on “uninitialized” + Programs often accidentally depend on uninitialized memory actually being filled with zero bytes. Junk filling (see the opt.junk option) tends to expose such bugs in the form of obviously incorrect @@ -2480,7 +2482,7 @@ MAPPED_LIBRARIES: this function is likely to result in a crash or deadlock. All messages are prefixed by - “<jemalloc>: ”. + <jemalloc>: . RETURN VALUES @@ -2666,9 +2668,9 @@ malloc_conf = "narenas:1";]]> calloc(), realloc(), and free() functions conform to ISO/IEC - 9899:1990 (“ISO C90”). + 9899:1990 (ISO C90). The posix_memalign() function conforms - to IEEE Std 1003.1-2001 (“POSIX.1”). + to IEEE Std 1003.1-2001 (POSIX.1). diff --git a/doc/stylesheet.xsl b/doc/stylesheet.xsl index bc8bc2a9..619365d8 100644 --- a/doc/stylesheet.xsl +++ b/doc/stylesheet.xsl @@ -5,6 +5,6 @@ - "" +