From nobody Mon Jul 19 07:36:43 2021
X-Original-To: freebsd-ports@mlmmj.nyi.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1])
	by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id D387212AE520
	for <freebsd-ports@mlmmj.nyi.freebsd.org>; Mon, 19 Jul 2021 07:36:44 +0000 (UTC)
	(envelope-from bapt@FreeBSD.org)
Received: from smtp.freebsd.org (smtp.freebsd.org [96.47.72.83])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
	 key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256
	 client-signature RSA-PSS (4096 bits) client-digest SHA256)
	(Client CN "smtp.freebsd.org", Issuer "R3" (verified OK))
	by mx1.freebsd.org (Postfix) with ESMTPS id 4GStvc5lrcz4pdX;
	Mon, 19 Jul 2021 07:36:44 +0000 (UTC)
	(envelope-from bapt@FreeBSD.org)
Received: from aniel.nours.eu (nours.eu [176.31.115.77])
	(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
	(Client did not present a certificate)
	(Authenticated sender: bapt)
	by smtp.freebsd.org (Postfix) with ESMTPSA id 92CD12E301;
	Mon, 19 Jul 2021 07:36:44 +0000 (UTC)
	(envelope-from bapt@FreeBSD.org)
Received: by aniel.nours.eu (Postfix, from userid 1001)
	id 6BB7373E7A; Mon, 19 Jul 2021 09:36:43 +0200 (CEST)
Date: Mon, 19 Jul 2021 09:36:43 +0200
From: Baptiste Daroussin <bapt@FreeBSD.org>
To: probono <probono@puredarwin.org>
Cc: freebsd-ports@freebsd.org
Subject: Re: Proposal: Include the Application Name in Ports and Packages
Message-ID: <20210719073643.7jprvntogwl2y7i6@aniel.nours.eu>
References: <CAADtZXBiy0=fn7Mz1x8hCAEf0ePOLp=sdH=uSN6EAmcWZAfYyg@mail.gmail.com>
 <20210708235149.7x3sbgz4764x7ayp@aniel.nours.eu>
 <CAADtZXCVwm+8UT-N1Zjmgitk_A_7Nkwy4XCwzpeGmz8uZFhziQ@mail.gmail.com>
List-Id: Porting software to FreeBSD <freebsd-ports.freebsd.org>
List-Archive: https://lists.freebsd.org/archives/freebsd-ports
List-Help: <mailto:ports+help@freebsd.org>
List-Post: <mailto:ports@freebsd.org>
List-Subscribe: <mailto:ports+subscribe@freebsd.org>
List-Unsubscribe: <mailto:ports+unsubscribe@freebsd.org>
Sender: owner-freebsd-ports@freebsd.org
X-BeenThere: freebsd-ports@freebsd.org
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <CAADtZXCVwm+8UT-N1Zjmgitk_A_7Nkwy4XCwzpeGmz8uZFhziQ@mail.gmail.com>
X-ThisMailContainsUnwantedMimeParts: N

On Sun, Jul 18, 2021 at 12:55:05PM +0200, probono wrote:
> On Fri, Jul 9, 2021 at 1:51 AM Baptiste Daroussin <bapt@nours.eu> wrote:
> > Simply add a new annotation to the package with the Application Name(s) when it
> > is relevant. I add plural because some ports do provide multiple Application
> > Name(s).
> > And you will have the information everywhere.
> > See how CPE is implemented in the ports tree to see how to do that.
> 
> Hello bapt, thanks for your response. I have a couple of questions though:
> 
> 1. What key should we use for the Application Name(s)?
> 
> For CPE, there is e.g., 'CPE_VENDOR' and 'CPE_PRODUCT'. However none
> of those contains the "human-readable" name "Apache HTTP Server" (as
> used, e.g., on https://httpd.apache.org/).
> 
> CPE_VENDOR=     apache
> CPE_PRODUCT=    http_server
> 
> So what I am looking for is
> 
> SOME_KEY_NAME=   Apache HTTP Server

A simple APPLICATION_NAMES= name1 name2 should do the trick, and the magic
should be added to bsd.port.mk
> 
> 2. If there is more than one main application inside the same package,
> then just repeat this key/value combination multiple times?

yes, it depends on how want to implement it. for a given key there can only be
one value in pkg, but one can be clever
> 
> 3. How would we go about getting those into the
> standard/documentation/lint tools?

provide patch, nothing more
> 
> 4. Would new keys (annotations) automatically end up in
> package/repository metadata, or would something special need to be
> done to get them inherited there?

automatic.

Bapt