ports/140583: ports/print/acroread - handbook and port fail to mention that linux emulation must be already on before attempting port build

[Frank Durda IV]

>Number:         140583
>Category:       ports
>Synopsis:       ports/print/acroread - handbook and port fail to mention that linux emulation must be already on before attempting port build
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-ports-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Nov 15 20:40:00 UTC 2009
>Closed-Date:
>Last-Modified:
>Originator:     Frank Durda IV
>Release:        8.0 RC3
>Organization:
>Environment:
FreeBSD walkoff.lonestar.org 8.0-RC3 FreeBSD 8.0-RC3 #0: Tue Nov 10 07:50:36 UTC
 2009     root at almeida.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC  i386

>Description:
When following instructions from Handbook (6.4.1), it
states that to build acroread you merely need to

>How-To-Repeat:
On a freshly installed system where linux emulation
is not yet enabled, follow the instructions shown in the
handbook for building acroread7 (or alter that to build
acroread8 or acroread9).



>Fix:
Enabling emulation, rebooting and re-attempting the
make install clean appears to work as expected.
This appears to solve the issue for acroread7, 8 and 9
ports.

The linux_enable="YES prerequisite for the build to work
(never mind for operation, which can be understood)
should at least be mentioned in the handbook instructions,
and certainly stated in a README or something in the port
directory themselves where that dependency exists.

Alternatively, is there a way for the make file for the
port to turn emulation on before it gets going?  That might
be the most elegant solution.


>Release-Note:
>Audit-Trail:
>Unformatted:
 ># cd /usr/ports/print/acroread7
 ># make install clean
 
 (the example may be out of date - we are up to version 9 now),
 
 However, whichever is built, the make install clean fails because
 it appears make files for some of the dependent items require
 linux_enable="yes" to already be in effect before the make
 begins.