View Issue Details

IDProjectCategoryView StatusLast Update
0001334Online PubsRationalepublic2020-04-08 08:29
Reporterandras_farkas Assigned To 
PrioritynormalSeverityEditorialTypeError
Status AppliedResolutionAccepted As Marked 
NameAndras Farkas
Organization
User Reference
URL
SectionPortability Considerations
Summary0001334: Possible bad troff to HTML conversion in Portability Considerations section of XRAT
DescriptionIn D.2.10 Command Language:
https://pubs.opengroup.org/onlinepubs/9699919799/xrat/V4_port.html#tag_24_02_10
In the list of commands, we have:

sleep, tee, test, CONVERSION ERROR (.Cm) time *,1 true, wait,

The conversion error text seems erroneous. time is also not a hyperlink to time.html, unlike the other commands in the list.
Desired ActionGet rid of
"CONVERSION ERROR (.Cm) "
text and make time a hyperlink to the intended time utility.
TagsNo tags attached.

Activities

Don Cragun

2020-04-07 23:35

manager   bugnote:0004815

In the PDF (P3771, L129440-129443) the only hyperlink is to Section 2.14. It would be nice if the utilities in that list were hyperlinks as in the on-line version.

The conversion error does not appear in the PDF. Note that time utility has a footnote in both the HTML and the PDF, but there is an extra space between "time" and "*" in the HTML that isn't in the PDF. I would guess that there is a bug in the .Cm macro processing when producing the HTML.

geoffclare

2020-04-08 08:04

manager   bugnote:0004819

Last edited: 2020-04-08 08:05

It looks like the HTML translation tool doesn't correctly handle a footnote marker in a macro argument. The source here has:
.Cm time *,\*F
I looked for other places where "\*F" appears on a line beginning with "." and found there is only one other such place, and it also has a translation problem. It's in XRAT Section E Subprofiling Considerations under POSIX_SYMBOLIC_LINKS, where the troff source:
.Fn lchown ,\*F
is rendered in the HTML version as:

,,()href="#tag_foot_2">2

agadmin

2020-04-08 08:12

administrator   bugnote:0004820

This conversion error and two other conversion errors in XRAT have been corrected.

agadmin

2020-04-08 08:28

administrator   bugnote:0004821

The lchown conversion has also been fixed.

Files updated in XRAT:
V4_subprofiles.html
V4_xbd_chap12.html
V4_xbd_chap03.html
V4_port.html

Download bundles have been updated.

Issue History

Date Modified Username Field Change
2020-04-07 19:28 andras_farkas New Issue
2020-04-07 19:28 andras_farkas Name => Andras Farkas
2020-04-07 19:28 andras_farkas Section => Portability Considerations
2020-04-07 23:35 Don Cragun Note Added: 0004815
2020-04-08 08:04 geoffclare Note Added: 0004819
2020-04-08 08:04 geoffclare Project 1003.1(2016/18)/Issue7+TC2 => Online Pubs
2020-04-08 08:05 geoffclare Note Edited: 0004819
2020-04-08 08:12 agadmin Note Added: 0004820
2020-04-08 08:28 agadmin Note Added: 0004821
2020-04-08 08:29 agadmin Status New => Applied
2020-04-08 08:29 agadmin Resolution Open => Accepted As Marked