Austin Group Defect Tracker

Aardvark Mark IV

Viewing Issue Simple Details Jump to Notes ] Issue History ] Print ]
ID Category Severity Type Date Submitted Last Update
0000694 [Online Pubs] System Interfaces Editorial Omission 2013-05-09 18:36 2013-05-17 04:47
Reporter rhansen View Status public  
Assigned To
Priority normal Resolution Open  
Status New  
Name Richard Hansen
Organization BBN
User Reference
URL [^]
Section mbsnrtowcs
Summary 0000694: missing PDF bookmark for mbsnrtowcs()
Description The PDF for Issue7+TC1 contains hierarchical bookmarks (PDF metadata) to help the reader easily jump between sections. These bookmarks are missing an entry for mbsnrtowcs() (to jump to page 1289) under XSH Chapter 3.

(The HTML version is OK -- the link to mbsnrtowcs() is not missing.)
Desired Action add the missing PDF bookmark
Tags No tags attached.
Attached Files

- Relationships

-  Notes
geoffclare (manager)
2013-05-10 09:05

The bookmarks in the PDF are to pages, not functions. There is no
separate mbsnrtowcs() page, and therefore no bookmark.

If you look carefully at the log*() family of functions, it should
become clear what's going on. There is a bookmark for log2 but none
for log2f or log2l, because those are all on one page and there are
no "pointer pages" for log2f and log2l. However, there are bookmarks
for both log and logf (but not logl) because even though log, logf and
logl are on one page, there is a logf pointer page (which has logl on
it as well).

(The rule for pointer pages is that a pointer page is not included
if it would be adjacent to the page it points to.)
rhansen (manager)
2013-05-10 15:52

The PDF spec allows multiple bookmarks to point to the same page (and can actually point to a location within a page). Perhaps the script/Makefile used to convert the troff source into a PDF can be coaxed into creating entries per function or section heading instead of per page?
ajosey (manager)
2013-05-17 04:47

Comment 1601 is making an assumption about the implementation of the bookmarks that does not hold. The build tool uses the groff pdfmark macros. It would need some investigation and would not be addressed without a rework of the toolset which is unlikely to occur in the short term. In the meanwhile the work around is to manually add bookmarks if you wish

- Issue History
Date Modified Username Field Change
2013-05-09 18:36 rhansen New Issue
2013-05-09 18:36 rhansen Name => Richard Hansen
2013-05-09 18:36 rhansen Organization => BBN
2013-05-09 18:36 rhansen URL => [^]
2013-05-09 18:36 rhansen Section => mbsnrtowcs
2013-05-10 09:05 geoffclare Note Added: 0001598
2013-05-10 15:52 rhansen Note Added: 0001601
2013-05-17 04:47 ajosey Note Added: 0001612

Mantis 1.1.6[^]
Copyright © 2000 - 2008 Mantis Group
Powered by Mantis Bugtracker