[ docbook-Bugs-2889817 ] informalequation in toe and numbering

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

Bugs item #2889817, was opened at 2009-10-31 02:47
Message generated for change (Tracker Item Submitted) made by kbr
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=373747&aid=2889817&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: None
Priority: 5
Private: No
Submitted By: Kai Brommann (kbr)
Assigned to: Nobody/Anonymous (nobody)
Summary: informalequation in toe and numbering

Initial Comment:
TDG-V0.0.25 for V5.0 states for the equation element:
[Processing systems that number equations or build a table of equations at the beginning of a document may have difficulty correctly formatting documents that contain both equations with titles and equations without titles. You are advised to use informalequation for equations without titles.]

Assuming this caveat doesn't say that such difficulty is a feature and not a bug, here is a detailed description of the problem:

Informalequation doesn't have a title, so probably it makes no sense to have it included in the table of equations, instead only equations (which should have a title as quoted above, the title may be optional rather than required according to TDG nevertheless) are to be listed there. Otherwise the result is an empty row in the table of equations.
More generally speaking, every time an informal equation is linked to, it should not be tried to include its title while linking, because it has not title.
Perhaps it could be fixed by some customization layer, but if it's a bug it better should be fixed in the stylesheets directly.

Directly related is the question of numbering, let's say you have in the same chapter

equation1 with title1
equation2 with title2
informalequation1
informalequation2
informalequation3

then the numbering (displayed together with the respective element) should go as follows:
Equation 1. Title1
Equation 2. Title2
(1)
(2)
(3)

so equation and informalequation should have separate counters, and the equation is accompanied with the term Equation and its title (same as table and figure), while the informalequation should only have its number in parentheses or the like. The current (buggy) behaviour is:
Equation 1. Title1
Equation 2. Title2
Equation 2.
Equation 2.
Equation 2.

so for informalequations the counter of the equations is reused as well (but not incremented on the other hand), and the not-existing title is of course empty, so should not be tried to be displayed.

Instead, while linking, the two types can easily be distinguished, the desired behaviour would process the input (see ...) as:  

(see Equation 1.Title1)

 versus 

(see (1))

For an actual example how it should be done, you can also see the dblatex tool please where it is done properly for pdf.

Thanx for your effort.

(no error messages, Xalan-2.7.1 and docbook-xsl-ns-1.75.2/xhtml-1_1/chunk.xsl toolchain, no test document necessary, no customization layer)

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

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