From owner-freebsd-ports@FreeBSD.ORG  Thu Sep 25 20:58:47 2014
Return-Path: <owner-freebsd-ports@FreeBSD.ORG>
Delivered-To: freebsd-ports@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115])
 (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id 9990C5B3;
 Thu, 25 Sep 2014 20:58:47 +0000 (UTC)
Received: from mail-we0-x233.google.com (mail-we0-x233.google.com
 [IPv6:2a00:1450:400c:c03::233])
 (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits))
 (Client CN "smtp.gmail.com",
 Issuer "Google Internet Authority G2" (verified OK))
 by mx1.freebsd.org (Postfix) with ESMTPS id 0DCDCEC1;
 Thu, 25 Sep 2014 20:58:46 +0000 (UTC)
Received: by mail-we0-f179.google.com with SMTP id u56so723764wes.38
 for <multiple recipients>; Thu, 25 Sep 2014 13:58:45 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113;
 h=mime-version:in-reply-to:references:date:message-id:subject:from:to
 :cc:content-type:content-transfer-encoding;
 bh=9biEYegWQiqugWlwCU66svepkYSbfgqi3y7Z5iJ1Ikc=;
 b=WK53AiTOnXHh9TmGuLzHd6fsPCIHnw7jw2YNDj7+arKsoOxbTn4UIKRpZYceXJT3bh
 L5eV/IRyEThRwsslTuD/k6RkiilUS8SkOM9m0ZEwu4b3GtHSXxvmHWZVSeONP5s6zL+1
 5K/YJbf/ohNmydO2SCKyQbq6i2wFvYLOv70aArnmKTtQRAqy8qXPnyaMzNueQudCeLPr
 4uuztv52vtdvYb9lmMcqf5kFIHyeOP3J6AD9nYYrPNzWViddQdHo5Q+vH/MWSE6ejXLv
 6noK6Um0BkX7Qeud+h+oGLeLAntZPUHj9xHWIBfOpAKq9xHJR9D4WeZ7ZT0zTVEtzrBf
 tmHQ==
MIME-Version: 1.0
X-Received: by 10.180.183.163 with SMTP id en3mr41428538wic.36.1411678725264; 
 Thu, 25 Sep 2014 13:58:45 -0700 (PDT)
Received: by 10.180.104.66 with HTTP; Thu, 25 Sep 2014 13:58:45 -0700 (PDT)
In-Reply-To: <20140925120627.2e8e6bc7@kalimero.tijl.coosemans.org>
References: <CAGwOe2aJWSNnG8YBuBpxjtE7S_bN5NkWwaiKWDmQzJmWMQUDoQ@mail.gmail.com>
 <20140924205238.52054971@kalimero.tijl.coosemans.org>
 <CAGwOe2Z1T68Fkeob5Vej0oFnZEGurB21_h_BvmVkPqwEoxAujQ@mail.gmail.com>
 <20140925120627.2e8e6bc7@kalimero.tijl.coosemans.org>
Date: Thu, 25 Sep 2014 22:58:45 +0200
Message-ID: <CAGwOe2bS0pnrGVSrPc5jFqVYfuaHi5hcNwHUkaR1Y8W+DJGwOA@mail.gmail.com>
Subject: Re: On Docs option and custom build target
From: =?UTF-8?Q?Fernando_Apestegu=C3=ADa?= <fernando.apesteguia@gmail.com>
To: Tijl Coosemans <tijl@freebsd.org>
Content-Type: text/plain; charset=UTF-8
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 20:58:47 -0000

On Thu, Sep 25, 2014 at 12:06 PM, Tijl Coosemans <tijl@freebsd.org> wrote:
> On Wed, 24 Sep 2014 23:54:19 +0200 Fernando Apestegu=C3=ADa <fernando.ape=
steguia@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=C3=ADa <fernando.a=
pesteguia@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.
>>
>> Thanks. Changed.
>>
>>>> However, when I try to run this in poudriere, I get the following erro=
r:
>>>>
>>>> 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?
>>
>> Yes it does.
>>
>> 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.

That's it!

Thanks!