lsb

footnote placement in single-file specs in error

Bug #1329857 reported by Jeff Johnson
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
lsb
Fix Committed
Medium
Unassigned
Mandriva
Fix Released
Medium

Bug Description

In the C++ specification, there are some footnotes in the text. They're fine
in the chunked html, but are completely misplaced in the single-file html.
Examples from the 4.1 released spec:

http://refspecs.linuxbase.org/LSB_4.1.0/LSB-CXX-generic/LSB-CXX-generic/cxxclasses.html#DATAREPRESENTATION

the footnoted references are in section 6.1.1.1, in the list below table 6-2.
The footnotes themselves appear at the end of the html page.

In the single-file specification (and also the text specifications, for that
matter), the footnotes appear at the very end of the file. See:

http://refspecs.linuxbase.org/LSB_4.1.0/LSB-CXX-generic/LSB-CXX-generic.html#CLASSES

and you have to scroll all the way to the very end, after the GNU FDL, to see
the notes.

This looks even sillier when the C++ ELF materials are merged into the LSB-Core
spec, as is the case for LSB 5.0.

Note I'm just reporting the one confirment instance. I'm quite sure this has
nothing to do with C++, rather with our layout and usage of the <footnote>
element. I haven't seen other instances of this problem, and in fact a spot
check indicates at least some others come out right.

For example,

http://refspecs.linuxbase.org/LSB_4.1.0/LSB-Core-generic/LSB-Core-generic/usernames.html

is just fine.

I wonder if it's a docbook quirk or bug. The troublesome stanza is footnotes
on items in an <orderedlist>, the above noted "as expected" usage is contained
inside a <table>.

Tags: spec
Changed in mandriva:
importance: Unknown → Medium
status: Unknown → Fix Released
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Related blueprints

Remote bug watches

Bug watches keep track of this bug in other bug trackers.