docs/157406: Building misc/freebsd-doc-en fails, etcetera

[J. Altman]

>Number:         157406
>Category:       docs
>Synopsis:       Building misc/freebsd-doc-en fails, etcetera
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun May 29 22:40:08 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator:     J. Altman
>Release:        8.1-RELEASE-p4 FreeBSD 8.1-RELEASE-p4
>Organization:
>Environment:
FreeBSD whisperer.chthonixia.net 8.1-RELEASE-p4 FreeBSD 8.1-RELEASE-p4
#0: Sat May 28 21:25:00 EDT 2011
root at whisperer.chthonixia.net:/usr/obj/usr/src/sys/WHISPERER  amd64


>Description:
First, please see my query to -questions for some more background:

http://lists.freebsd.org/pipermail/freebsd-questions/2011-May/230423.html

This is the content of my last message to -questions, in which I outline where I think the problems are for the handbook only:

After reading the thread referenced above, and looking at the output
of my build, I noticed that the build was failing in different areas.
So I decided to run make on the port multiple times, and eventually
the port installed successfully. However, the port in my tree (dated #
$FreeBSD: ports/misc/freebsd-doc-en/Makefile,v 1.36 2011/05/22
14:28:49 blackend Exp $) in a fresh tree made only through
2010, according to the copyright at the top of the
handbook. Individual files in that doc tree were variously dated; the
newest being 8/2010.

So I ran make, multiple times, on the source; and that gave me a doc
tree dated 2011. Most of the files there were dated 5/29/11. A few
exceptions were found in image files dated 3/2010, which all loaded in
SeaMonkey, except for some files in: advanced-networking, security,
vinum, geom. I may have missed others in other books.

To summarize:

1) It appears that make is, in this case, a hammer that must be
applied more than once to either the source or the port.

2) Not all images are seen as valid, and according to make may have
bad magic numbers. If building from source is used on a fresh tree, it
may be possible to have make ignore all the errors by using the -k
flag.

3) I have no idea how things will go with an upgrade to the doc
source; I normally use portupgrade, so I suppose I will find out
later.



>How-To-Repeat:
No idea, really; if the images don't change, then portupgrade may not fail. But I think it can be replicated if someone installs a new instance of FreeBSD, and tries to install either the freebsd-doc-en port, or the doc from source.
>Fix:
I think that certain images must be fixed. I think that for me, the port installation contained either some, or all, good images even though there were error messages about issues with some images in the port build. I did check in gimp; some images load in it, some do not, as outlined above for SeaMonkey.

>Release-Note:
>Audit-Trail:
>Unformatted: