View Issue Details
| ID | Project | Category | View Status | Date Submitted | Last Update |
|---|---|---|---|---|---|
| 0000694 | 1003.1(2013)/Issue7+TC1 | System Interfaces | public | 2013-05-09 18:36 | 2024-07-22 11:02 |
| Reporter | rhansen | Assigned To | |||
| Priority | normal | Severity | Editorial | Type | Omission |
| Status | New | Resolution | Open | ||
| Name | Richard Hansen | ||||
| Organization | BBN | ||||
| User Reference | |||||
| Section | mbsnrtowcs | ||||
| Page Number | |||||
| Line Number | |||||
| Interp Status | |||||
| Final Accepted Text | |||||
| 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. | ||||
|
|
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.) |
|
|
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? |
|
|
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 |
| 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 | => https://www2.opengroup.org/ogsys/publications/viewDocument.html?publicationid=13156&documentid=12131 |
| 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 | |
| 2024-07-22 11:02 | geoffclare | Project | Online Pubs => 1003.1(2013)/Issue7+TC1 |
