From: SourceForge.net <no...@so...> - 2007-01-20 15:20:03
|
Bugs item #1596018, was opened at 2006-11-14 01:27 Message generated for change (Comment added) made by wsfulton You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=101645&aid=1596018&group_id=1645 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: documentation Group: None >Status: Closed >Resolution: Rejected Priority: 5 Private: No Submitted By: Dave Yost (daveyost) Assigned to: Nobody/Anonymous (nobody) Summary: SWIGDocumentation.pdf page numbering Initial Comment: This doc has pages numbered i - xx 1 - 689 Nowadays it is custom to begin the arabic numerals from where the roman numerals left off, so that printing subranges of pages works properly without the user having to correct for the offset caused by the initial roman-numeral pages. So, the pages should be numbered i - xx 21-709 or why not simply 1 - 709 ---------------------------------------------------------------------- >Comment By: William Fulton (wsfulton) Date: 2007-01-20 15:20 Message: Logged In: YES user_id=242951 Originator: NO The htmldoc guys don't think there is anything wrong with it after posting on their forums a couple of months back and it all looks logical to me and the approach is pretty much industry standard so I'm closing this bug. The page numbering printing works in Acrobat which is the de-facto standard pdf reader. I suggest you raise a bug with Apple application to sort out the numbering problems when printing. ---------------------------------------------------------------------- Comment By: Dave Yost (daveyost) Date: 2006-11-29 09:13 Message: Logged In: YES user_id=330919 Originator: YES Printing subranges of pages from Apple's Preview app does not work properly without the user having to correct for the offset caused by the initial roman-numeral pages. (I didn't try Adobe Reader until now, and I see that it displays both the page number of the page and the sequence number for use with print ranges, so it's not a problem with Adobe Reader.) Sorry I don't have chapter and verse on the Roman numeral numbering scheme I advocate. It's just usage I started to see in the modern era of electronic composition of documents. ---------------------------------------------------------------------- Comment By: William Fulton (wsfulton) Date: 2006-11-28 21:53 Message: Logged In: YES user_id=242951 Originator: NO The pdf documentation is generated by the htmldoc tool. The page numbering you see is the default output from this tool. If htmldoc supports this numering scheme, I don't mind changing the page numbering to whatever the modern way is, but do you have any supporting evidence for this? The ISO/ANSI C and C++ standards for example use the same approach that we do. I'm not entirely sure what is wrong with the current approach, it makes more sense for the body to start at page 1 than some arbitrary number depending on the length of the table of contents. Acrobat handles the page numbering nicely so there is no problem there either ... ie if I type in vii or 25, it will take me to the pages numbered vii or 25 respectively. ---------------------------------------------------------------------- Comment By: Dave Yost (daveyost) Date: 2006-11-14 04:14 Message: Logged In: YES user_id=330919 Actually, it's worse than that. The title page has no numbering at all. ---------------------------------------------------------------------- You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=101645&aid=1596018&group_id=1645 |