From owner-freebsd-questions@freebsd.org  Sun Dec 18 19:04:19 2016
Return-Path: <owner-freebsd-questions@freebsd.org>
Delivered-To: freebsd-questions@mailman.ysv.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by mailman.ysv.freebsd.org (Postfix) with ESMTP id EFBEDC8786D
 for <freebsd-questions@mailman.ysv.freebsd.org>;
 Sun, 18 Dec 2016 19:04:19 +0000 (UTC)
 (envelope-from wblock@wonkity.com)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client CN "wonkity.com", Issuer "wonkity.com" (not verified))
 by mx1.freebsd.org (Postfix) with ESMTPS id C47441F3F
 for <freebsd-questions@freebsd.org>; Sun, 18 Dec 2016 19:04:19 +0000 (UTC)
 (envelope-from wblock@wonkity.com)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.15.2/8.15.2) with ESMTPS id uBIJ4FVX097609
 (version=TLSv1.2 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO);
 Sun, 18 Dec 2016 12:04:15 -0700 (MST)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.15.2/8.15.2/Submit) with ESMTP id uBIJ4FuJ097606;
 Sun, 18 Dec 2016 12:04:15 -0700 (MST)
 (envelope-from wblock@wonkity.com)
Date: Sun, 18 Dec 2016 12:04:15 -0700 (MST)
From: Warren Block <wblock@wonkity.com>
To: scrat <baho-utot@columbus.rr.com>
cc: freebsd-questions@freebsd.org
Subject: Re: Building documentation
In-Reply-To: <3d19a8d7-53bc-4293-58a9-0600d1effdc9@columbus.rr.com>
Message-ID: <alpine.BSF.2.20.1612181202410.95850@wonkity.com>
References: <3d19a8d7-53bc-4293-58a9-0600d1effdc9@columbus.rr.com>
User-Agent: Alpine 2.20 (BSF 67 2015-01-07)
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII; format=flowed
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.6.1
 (wonkity.com [127.0.0.1]); Sun, 18 Dec 2016 12:04:16 -0700 (MST)
X-BeenThere: freebsd-questions@freebsd.org
X-Mailman-Version: 2.1.23
Precedence: list
List-Id: User questions <freebsd-questions.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/freebsd-questions>, 
 <mailto:freebsd-questions-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-questions/>
List-Post: <mailto:freebsd-questions@freebsd.org>
List-Help: <mailto:freebsd-questions-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/freebsd-questions>, 
 <mailto:freebsd-questions-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 18 Dec 2016 19:04:20 -0000

On Sun, 18 Dec 2016, scrat wrote:

> I am trying to build the documentation and building with FORMATS="html 
> html-split" works.  I then tried to build the pdf version it complained about 
> textproc/fop so I built and installed it.
>
> cd /usr/doc/en_US.ISO8859-1/books/handbook
> make FORMATS=pdf DESTDIR=/tmp install
>
> It will build a pdf but when I view it in okular all I get is ###### #### etc 
> for most of the words.  I am assuming that I need to install a font, if so 
> which ones as it is not pointed out in fdp-primer.  Also I think under the 
> "2.1. Required Tools" section fop should be listed as textproc/docproj 
> doesn't install it.

fop is an optional dependency which can be selected if the port is 
installed.  It will not be installed by the package, which uses the 
default options.  Yes, the instructions could stand to be updated.