Bug 98115

Summary: Missing parts after rendering handbook to RTF format
Product: Documentation Reporter: Ivan Shatsky <rinaldo>
Component: Books & ArticlesAssignee: Gabor Kovesdan <gabor>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Ivan Shatsky 2006-05-30 03:00:32 UTC
There are missing parts in a RTF format of FreeBSD handbook. For example, as of 2006-05-29, both english and russian versions of handbook missing start of chapters "2.6 Choosing What to Install" and "27.8 Network Address Translation". Tested in MS Office XP, MS Office 2003 and OpenOffice 1.1.4.

How-To-Repeat: Extract and open RTF document from ftp://ftp.freebsd.org/pub/FreeBSD/doc/en_US.ISO8859-1/books/handbook/book.rtf.zip
Comment 1 murray.stokely 2008-12-27 21:37:11 UTC
I think this is just a matter of the FTP site being updated less
frequently than the documentation for all formats, and not a
particular problem with RTF.  If I take a look right now all of the
files in that FTP directory are 8 days old, but there have been
several changes to the handbook since then.

I'd like to see the process by which this FTP site gets updated
documented somewhere so we can understand if this is correct or not.

Murray
Comment 2 Gabor Kovesdan freebsd_committer freebsd_triage 2009-01-30 15:02:46 UTC
I've just verified this and it is a real bug actually, it isn't caused 
by the slow updating. The document has been updated on the mirror and 
the mentioned part is still missing.

-- 
Gabor Kovesdan

EMAIL: gabor@FreeBSD.org
WWW:   http://www.kovesdan.org
Comment 3 kaspars 2011-05-09 22:47:48 UTC
Currently this bug can be found in handbook after Figure 2-18 for
instance, and elsewhere. In that case the end of section 2.6.5 is
missing as well as 2.7.1.

Seems the problem might not be with docs themselves, but with the
textproc/fixrtf port, the utility used to embed PNG pictures into RTFs.

The book.rtf-nopng, produced by jade, is fine.

One of the last steps executed by "make FORMATS=rtf" is:

/usr/local/bin/fixrtf -i -p -e ISO-8859-1 < book.rtf-nopng > book.rtf

After that, many sections in book.rtf output file are missing.
Appearently fixrtf fails to parse the document in some places, and
replaces segments of text that follow the images.
Comment 4 Kaspars Bankovskis 2011-09-22 18:31:17 UTC
This is not a doc problem.
Please assign it to ports problems: textproc/fixrtf
Comment 5 Gabor Kovesdan freebsd_committer freebsd_triage 2014-01-22 13:39:19 UTC
State Changed
From-To: open->closed

We now a use a more mature toolchain so fixrtf is not used any more. 
Anyway, thank you for your report. 


Comment 6 Gabor Kovesdan freebsd_committer freebsd_triage 2014-01-22 13:39:19 UTC
Responsible Changed
From-To: freebsd-doc->gabor

We now a use a more mature toolchain so fixrtf is not used any more. 
Anyway, thank you for your report.