From owner-freebsd-ports@FreeBSD.ORG Fri Sep 26 06:37:19 2014 Return-Path: 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 1544C6EE; Fri, 26 Sep 2014 06:37:19 +0000 (UTC) Received: from prod2.absolight.net (mx3.absolight.net [IPv6:2a01:678:2:100::25]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (Client CN "plouf.absolight.net", Issuer "CAcert Class 3 Root" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id CB28423D; Fri, 26 Sep 2014 06:37:18 +0000 (UTC) Received: from prod2.absolight.net (localhost [127.0.0.1]) by prod2.absolight.net (Postfix) with ESMTP id 2A384BDC5D; Fri, 26 Sep 2014 08:37:17 +0200 (CEST) Received: from atuin.in.mat.cc (unknown [213.222.32.10]) by prod2.absolight.net (Postfix) with ESMTPA id E916BBDC1D; Fri, 26 Sep 2014 08:37:16 +0200 (CEST) Received: from localhost (localhost [127.0.0.1]) by atuin.in.mat.cc (Postfix) with ESMTP id F230414CBE00; Fri, 26 Sep 2014 09:37:15 +0300 (EEST) Date: Fri, 26 Sep 2014 09:37:15 +0200 From: Mathieu Arnold To: Matthias Andree , ports-committers@freebsd.org Subject: Re: lack of framework and pkg documentation (was: svn commit: r369281 - in head/dns: dnsmasq dnsmasq-devel) Message-ID: <725C3E552E769ADCC3E4E150@atuin.in.mat.cc> In-Reply-To: <5425084F.9020205@FreeBSD.org> References: <201409251827.s8PIRur9020228@svn.freebsd.org> <54246002.2080408@FreeBSD.org> <5425084F.9020205@FreeBSD.org> X-Mailer: Mulberry/4.0.8 (Mac OS X) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Content-Disposition: inline Cc: freebsd-ports@FreeBSD.org, portmgr@FreeBSD.org X-BeenThere: freebsd-ports@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: Porting software to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 26 Sep 2014 06:37:19 -0000 +--On 26 septembre 2014 08:31:43 +0200 Matthias Andree wrote: | Am 25.09.2014 um 20:33 schrieb Bryan Drewery: |> On 9/25/2014 1:27 PM, Matthias Andree wrote: |>> Author: mandree |>> Date: Thu Sep 25 18:27:56 2014 |>> New Revision: 369281 |>> URL: http://svnweb.freebsd.org/changeset/ports/369281 |>> QAT: https://qat.redports.org/buildarchive/r369281/ |>> |>> Log: |>> Update to new upstream version 2.72, disabling dnsmasq-devel again. |>> |>> Remove @dir* stuff from pkg-plist. @sample isn't documented properly |>> and isn't up to handling files with non-.sample suffix, so stay |>> away from that part of pkg-plist. |> |> https://www.freebsd.org/doc/en/books/porters-handbook/plist-config.html |> https://www.freebsd.org/doc/en/books/porters-handbook/plist-keywords.htm |> l#plist-keywords-sample | | yeah, quite explicitly states that if the file isn't named *.sample, | @sample does not work. It states that the sample file have to be named .sample, so that it's consistent across every package. | plist-keywords.html does not appear to suggest a way to have two | arguments for a keyword, or to use @sample(.example) to provide a | different extension... It also states, in a *big* gray box, that if for historical reasons (meaning it's always been there and it can't be changed) you can use bla bla bla. | The other issue I'm having with that is that the technical side of | Keywords/* - it's not documented or visible how these are actually used, | grep -ri keywords Mk comes up mostly empty, there's only the definition | - and it's a leftover from the times when we still had awk scripts to | wire this into pkg_create/pkg_install. All keywords are documented. How to use one, how to write one. | And I mean documentation (for the user) *and* specification. Like I said, it *is* documented, but it is true that if you don't even bother to look for the documentation, you won't find it. -- Mathieu Arnold