[ docbook-Bugs-1617448 ] html: text reordered in output

[SourceForge.net <no...@so...>]

Bugs item #1617448, was opened at 2006-12-18 02:43
Message generated for change (Settings changed) made by xmldoc
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=373747&aid=1617448&group_id=21935

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: XSL
Group: output: HTML
Status: Open
Resolution: Works For Me
Priority: 5
Private: No
Submitted By: Sam Steingold (sds)
Assigned to: Michael(tm) Smith (xmldoc)
>Summary: html: text reordered in output

Initial Comment:
XML input:
================================================
<varlistentry id="opt-memsize"><term><option>-m</option> &mems-r;</term>
 <listitem><para>Sets the amount of memory &clisp;
   tries to grab on startup. The amount may be given as
   <variablelist>
    <varlistentry><term><replaceable>nnnnnnn</replaceable></term>
     <listitem><simpara>measured in bytes
    </simpara></listitem></varlistentry>
    <varlistentry>
     <term><replaceable>nnnn</replaceable><command>K</command></term>
     <term><replaceable>nnnn</replaceable><command>KB</command></term>
     <listitem><simpara>measured in kilobytes
    </simpara></listitem></varlistentry>
    <varlistentry>
     <term>&n-r;<command>M</command></term>
     <term>&n-r;<command>MB</command></term>
     <listitem><simpara>measured in megabytes
   </simpara></listitem></varlistentry></variablelist>
   The default is 3 megabytes.
<!-- #if (oint_addr_len+addr_shift==24) -->
   The argument is constrained between 100 KB and 16 MB.
<!-- #elif (oint_addr_len+addr_shift==26) -->
   The argument is constrained between 100 KB and 64 MB.
<!-- #elif (oint_addr_len+addr_shift==28) -->
   The argument is constrained between 100 KB and 256 MB.
<!-- #else -->
   The argument is constrained above 100 KB.
<!-- #endif -->
   </para><simpara>This version of &clisp;
<!-- #if defined(SPVW_MIXED) && defined(SPVW_BLOCKS) -->
<!-- #ifdef GENERATIONAL_GC -->
   is not likely to actually use the entire &mems-r; since &gc;ion will
   periodically reduce the amount of used memory.
   It is therefore common to specify 10 MB even if only 2 MB are going
   to be used.
<!-- #else -->
   eventually uses the entire &mems-r;.
<!-- #endif -->
<!-- #else -->
   allocates memory dynamically. &mems-r; is essentially ignored
   (except that it determines the Lisp &STACK; size).
<!-- #endif -->
</simpara></listitem></varlistentry>
================================================

html output:
================================================
<dt><a id="opt-memsize"></a><span class="term"><code class="option">-m</code> <em class="replaceable"><code>memory-size</code></em></span></dt><dd><p>Sets the amount of memory <a href="http://clisp.cons.org" target="_top"><span><strong class="command">CLISP</strong></span></a>
   tries to grab on startup. The amount may be given as
   </p><div class="variablelist"><dl><dt><span class="term"><em class="replaceable"><code>nnnnnnn</code></em></span></dt><dd>measured in bytes
    </dd><dt><span class="term"><em class="replaceable"><code>nnnn</code></em><span><strong class="command">K</strong></span><br /></span><span class="term"><em class="replaceable"><code>nnnn</code></em><span><strong class="command">KB</strong></span></span></dt><dd>measured in kilobytes
    </dd><dt><span class="term"><em class="replaceable"><code>n</code></em><span><strong class="command">M</strong></span><br /></span><span class="term"><em class="replaceable"><code>n</code></em><span><strong class="command">MB</strong></span></span></dt><dd>measured in megabytes
   </dd></dl></div><p>

   <!--#endif-->

   The argument is constrained above 100 KB.

<!--#else-->

   The argument is constrained between 100 KB and 256 MB.

<!--#elif (oint_addr_len+addr_shift==28)-->

   The argument is constrained between 100 KB and 64 MB.

<!--#elif (oint_addr_len+addr_shift==26)-->

   The argument is constrained between 100 KB and 16 MB.

<!--#if (oint_addr_len+addr_shift==24)-->
   The default is 3 megabytes.

</p><p>This version of <a href="http://clisp.cons.org" target="_top"><span><strong class="command">CLISP</strong></span></a>

<!--#if defined(SPVW_MIXED) && defined(SPVW_BLOCKS)-->


<!--#ifdef GENERATIONAL_GC-->

   is not likely to actually use the entire <em class="replaceable"><code>memory-size</code></em> since <a href="impnotes.html#gc" class="olink">garbage-collect</a>ion will
   periodically reduce the amount of used memory.
   It is therefore common to specify 10 MB even if only 2 MB are going
   to be used.

<!--#else-->

   eventually uses the entire <em class="replaceable"><code>memory-size</code></em>.

<!--#endif-->


<!--#else-->

   allocates memory dynamically. <em class="replaceable"><code>memory-size</code></em> is essentially ignored
   (except that it determines the Lisp <a href="impnotes.html#vm" class="olink"><code class="literal">STACK</code></a> size).

<!--#endif-->

</p></dd>
================================================
note that the "The argument is constrained" lines are ordered differently in the input and output.

this is again CLISP documentation (man page this time).
in clisp/doc, do
make clisp.html

thanks!


----------------------------------------------------------------------

Comment By: Michael(tm) Smith (xmldoc)
Date: 2007-01-29 14:15

Message:
Logged In: YES 
user_id=118135
Originator: NO

Sam,

I'll try to help get this one figured out. One thing I did in this release
was to add some new parameters that should make it possible for you, going
forward, to upgrade to the latest stylesheets without needing to make any
changes to your man.xsl file. But this release will require some one-time
changes to your man.xsl -- specifically, we'll need to replace the
man.string.subst.map xsl param in that with man.string.subst.map.local.pre
and/or man.string.subst.map.local params. I will try to at least send you a
patch or that sometime soon.

----------------------------------------------------------------------

Comment By: Sam Steingold (sds)
Date: 2007-01-29 12:59

Message:
Logged In: YES 
user_id=5735
Originator: YES

Michael,
you pretty much wrote my man.xsl!
could you please help me fix it?
Thanks!

----------------------------------------------------------------------

Comment By: Michael(tm) Smith (xmldoc)
Date: 2007-01-19 13:17

Message:
Logged In: YES 
user_id=118135
Originator: NO

Sam,

I can reproduce this problem if I build clisp.html using your make/build
setup, but I can't reproduce it using the stock stylesheets. See the
attached output.

You're using some mechanism to copy over the comments from you source to
your output (the #elif stuff). I suspect that my be where your problem
lies. I can't see how this problem could be caused by the stock
stylesheets.

----------------------------------------------------------------------

Comment By: Michael(tm) Smith (xmldoc)
Date: 2007-01-19 13:17

Message:
Logged In: YES 
user_id=118135
Originator: NO

Sam,

I can reproduce this problem if I build clisp.html using your make/build
setup, but I can't reproduce it using the stock stylesheets. See the
attached output.

You're using some mechanism to copy over the comments from you source to
your output (the #elif stuff). I suspect that my be where your problem
lies. I can't see how this problem could be caused by the stock
stylesheets.

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=373747&aid=1617448&group_id=21935