From owner-freebsd-ports@FreeBSD.ORG  Thu Sep 25 10:07:38 2014
Return-Path: <owner-freebsd-ports@FreeBSD.ORG>
Delivered-To: freebsd-ports@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id E9531F8B
 for <freebsd-ports@freebsd.org>; Thu, 25 Sep 2014 10:07:38 +0000 (UTC)
Received: from mailrelay011.isp.belgacom.be (mailrelay011.isp.belgacom.be
 [195.238.6.178]) by mx1.freebsd.org (Postfix) with ESMTP id 8482327E
 for <freebsd-ports@freebsd.org>; Thu, 25 Sep 2014 10:07:38 +0000 (UTC)
X-Belgacom-Dynamic: yes
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: AnAGAMjoI1RbsISZ/2dsb2JhbABggw6BKtI4AYEHFwF6hAQBAQRWIxALGAklDxIYHgYTiCoDFQG7Lw2HIAEXjW6BfTMHhEsBBJsRgg+PD4ZGg2Q7L4JKAQEB
Received: from 153.132-176-91.adsl-dyn.isp.belgacom.be (HELO
 kalimero.tijl.coosemans.org) ([91.176.132.153])
 by relay.skynet.be with ESMTP; 25 Sep 2014 12:06:28 +0200
Received: from kalimero.tijl.coosemans.org (kalimero.tijl.coosemans.org
 [127.0.0.1])
 by kalimero.tijl.coosemans.org (8.14.9/8.14.9) with ESMTP id s8PA6RXs002752;
 Thu, 25 Sep 2014 12:06:27 +0200 (CEST)
 (envelope-from tijl@FreeBSD.org)
Date: Thu, 25 Sep 2014 12:06:27 +0200
From: Tijl Coosemans <tijl@FreeBSD.org>
To: Fernando =?ISO-8859-1?Q?Apestegu=EDa?= <fernando.apesteguia@gmail.com>
Subject: Re: On Docs option and custom build target
Message-ID: <20140925120627.2e8e6bc7@kalimero.tijl.coosemans.org>
In-Reply-To: <CAGwOe2Z1T68Fkeob5Vej0oFnZEGurB21_h_BvmVkPqwEoxAujQ@mail.gmail.com>
References: <CAGwOe2aJWSNnG8YBuBpxjtE7S_bN5NkWwaiKWDmQzJmWMQUDoQ@mail.gmail.com>
 <20140924205238.52054971@kalimero.tijl.coosemans.org>
 <CAGwOe2Z1T68Fkeob5Vej0oFnZEGurB21_h_BvmVkPqwEoxAujQ@mail.gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable
Cc: FreeBSD Mailing List <freebsd-ports@freebsd.org>
X-BeenThere: freebsd-ports@freebsd.org
X-Mailman-Version: 2.1.18-1
Precedence: list
List-Id: Porting software to FreeBSD <freebsd-ports.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-ports>,
 <mailto:freebsd-ports-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-ports/>
List-Post: <mailto:freebsd-ports@freebsd.org>
List-Help: <mailto:freebsd-ports-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-ports>,
 <mailto:freebsd-ports-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 25 Sep 2014 10:07:39 -0000

On Wed, 24 Sep 2014 23:54:19 +0200 Fernando Apestegu=EDa <fernando.apestegu=
ia@gmail.com> wrote:
> On Wed, Sep 24, 2014 at 8:52 PM, Tijl Coosemans <tijl@freebsd.org> wrote:
>> On Tue, 23 Sep 2014 23:23:31 +0200 Fernando Apestegu=EDa <fernando.apest=
eguia@gmail.com> wrote:
>>> I have a Makefile for an application that provides both examples and
>>> documentation. I created the two options in the Makefile (both enabled
>>> by default).
>>> The package doesn't provide any flags stock like --with-docs or
>>> --with-examples, so I have a custom target like this:
>>>
>>> do-build:
>>>         @cd ${BUILD_WRKSRC}/ && ${MAKE}
>>> .if ${PORT_OPTIONS:MDOCS}
>>>         @cd ${BUILD_WRKSRC}/ && ${MAKE_CMD} doc
>>> .endif
>>
>> You don't have to override do-build like this.  You can build the
>> documentation from a post-build target.
>=20
> Thanks. Changed.
>=20
>>> However, when I try to run this in poudriere, I get the following error:
>>>
>>> make[1]: don't know how to make doc. Stop
>>>
>>> make[1]: stopped in /wrkdirs/usr/ports/graphics/code-eli/work/.build
>>> *** Error code 2
>>
>> Does the makefile in BUILD_WRKSRC actually have a doc target?  Is doc
>> a subdirectory maybe?
>=20
> Yes it does.
>=20
> In fact, with "port test" builds fine with the same code (change
> directory and ${MAKE} doc). There is a doc.dir subdirectory in
> BUILD_WRKSRC/CMakeFiles. The doc target basically gets a Doxygen
> configuration file and runs doxygen on the whole library code.

Poudriere tests the port in a clean environment so check the build log
to see if any dependencies (like doxygen) are missing.