Use <quote>...</quote> rather than &ldquo;...&rdquo; or "..." in XML.

This commit is contained in:
Jason Evans 2016-11-01 13:25:42 -07:00
parent 0ba5b9b618
commit 2a2d1b6e86
2 changed files with 33 additions and 31 deletions

View File

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

View File

@ -5,6 +5,6 @@
<xsl:call-template name="inline.monoseq"/> <xsl:call-template name="inline.monoseq"/>
</xsl:template> </xsl:template>
<xsl:template match="mallctl"> <xsl:template match="mallctl">
"<xsl:call-template name="inline.monoseq"/>" <quote><xsl:call-template name="inline.monoseq"/></quote>
</xsl:template> </xsl:template>
</xsl:stylesheet> </xsl:stylesheet>