From nobody Tue Sep 6 19:04:10 2022 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 4MMZYn6qXWz4bSR3 for ; Tue, 6 Sep 2022 19:04:13 +0000 (UTC) (envelope-from se@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 4MMZYn6Hcrz3bvy; Tue, 6 Sep 2022 19:04:13 +0000 (UTC) (envelope-from se@freebsd.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1662491053; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=MVUMexizSsK88jWpPBSFKdtLA4UbrtYCqw2Oterkxik=; b=XqlJCj4CbRfXVN88Xn7loX8Up+FfPfybZsmQ/UkLwzdexV5E0Res6b2u5rJLMsUQKyzW+4 r9+DbpiU3aQaDEBZrp0HirEC+kvWAMG9Y7YvKRWlb3lVQpW4iREy2xo08CWziWVEg9tWqb KNnvc0L8l3t6jnAashRFVD+SXdDu889MlAhaEwdOvhXPU/0cLx3ByE9e8xCGnZ1CwiKSIo sqBWhVgeHzYMkqfHHWTpPwxRGlpuiUXouKiMgMzU/2p814t2X77HkVo8EmWP+xc7idrnH/ l9eQiL5kHpR30I5AvZQPHL/6QExMkLYnguKwiiAwoXaV2AKTBFzfaNMe777Gag== Received: from [IPV6:2003:cd:5f1e:4500:c028:7c3b:8173:9d47] (p200300cd5f1e4500c0287c3b81739d47.dip0.t-ipconnect.de [IPv6:2003:cd:5f1e:4500:c028:7c3b:8173:9d47]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (Client did not present a certificate) (Authenticated sender: se/mail) by smtp.freebsd.org (Postfix) with ESMTPSA id 4MMZYn0p8yz10sV; Tue, 6 Sep 2022 19:04:12 +0000 (UTC) (envelope-from se@freebsd.org) Message-ID: <16ecf008-56db-a553-97cc-6183e56674a4@FreeBSD.org> Date: Tue, 6 Sep 2022 21:04:10 +0200 List-Id: Porting software to FreeBSD List-Archive: https://lists.freebsd.org/archives/freebsd-ports List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-ports@freebsd.org X-BeenThere: freebsd-ports@freebsd.org MIME-Version: 1.0 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:102.0) Gecko/20100101 Thunderbird/102.2.1 From: Stefan Esser Subject: Re: HEADS-UP: Upcoming move of WWW definitions in all ports Content-Language: de-DE, en-US To: sgk@troutmask.apl.washington.edu Cc: FreeBSD ports , portmgr References: <8a896af9-b41e-d939-c71c-3b0b6b8366b6@FreeBSD.org> In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1662491053; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=MVUMexizSsK88jWpPBSFKdtLA4UbrtYCqw2Oterkxik=; b=KngRXoom5Po7nvsYlPkRYkZ2OzYdksOMfiv9KATiBWb1SFEZfpfxjTUA/qmVDW9D/moo/M 6effuGFrUaez5iOvV6wwSBSm4y0osR7duL8dMmTb6DIvNuP+PYB8+McvGcMuO0SUSWEOm7 3RmUWWb5vtMMER5QoEuFekVVbY9wCatRR1cRit2drOSCsjLUCtywtwJ/IKg667kxLSta3c oE/eXbPvZMdpT399CcTqMT/6uFS0Qy93WWKUU6mP1iQ8vzKnbVpoZiS7DTmD3H2HscOiSL hQcSOvQLhGYkGBTorfOBLh3RjiBFqnpOIoLiAtYcnhiTHT6Uj3LCNe5sAOan8Q== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1662491053; a=rsa-sha256; cv=none; b=At0EBzTb/Ra3NPDNzR4zqppl2L2DV/nvt478+nPo5X+CAODx68BJl01fM3BipLYofBAKMm 30BOme+eTByCIDinSMcdPRP7wEvGD5WXAFxUcnnyPEG6sue8T7hDsTB+Y4ZBgvqQwah467 vmBWNMMODv16/iB3610NRac9nWRIJ76qVwK2VjQHPCuZ+wklb62nwVF/Un+HzOTyeO6x+I kBp9mrn9TwLyo9+yHiPkBBsn7vOptG2K4N5fMCnncf2lSUT7zABlWRKaPkIxjkwdsTwaUu lwGMUHlKcw53ARTW0sXzaUmZvAQZRrQjv65YMKLZghNWLvGnnhgsLrKCIKwnjg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N Am 06.09.22 um 20:31 schrieb Steve Kargl: > On Tue, Sep 06, 2022 at 08:09:24PM +0200, Stefan Esser wrote: >> PortMgr has just accepted a change that has been in the making for some time: >> >> The move of the "WWW:" entries at the end of the ports' pkg-descr files into >> the ports' Makefiles in the form of "WWW=" definitions. >> >> The WWW lines will be put into the maintainer block, immediately following >> the MAINTAINER and COMMENT lines. >> >> If there is more than one WWW: line a pkg-descr file, one URL will be >> selected to be moved into the Makefile, the other URLs will get a label >> "See also:" instead of "WWW:". >> > > You've told us the "What" and suggested a "When". So, what is > the "Why?" > > % find . -name pkg-descr -maxdepth 3 | wc -l > 29110 > % find . -name Makefile -maxdepth 3 | wc -l > 30343 > > Assuming 90% of the files are touched, 54000 files suffering cosmetic churn? The idea to move the WWW entry from the pkg-descr to the Makefile has come up multiple times in the past, back in 2015 for the first time that I know of, see https://reviews.freebsd.org/D2949. The question whether the churn caused by commits to 2 files of nearly all ports has been discussed within the PortMgr team for some time. The decision to go ahead has now been made, after all prerequisites have been met. The WWW field is the only parameter in the INDEX file or in package manifests that is not derived from some variable in the ports' Makefiles. It has become stale in quite a number of ports over time, one reason might be that the pkg-descr files are seldom touched after the initial commit. And many of the URLs did not follow the rules laid out in the porters' handbook. The most relevant WWW: entry in each pkg-descr file should be in the last line (if there are multiple WWW: lines) and this line is currently extracted using awk when the INDEX is built. But in fact, many ports have the relevant URL in some other line and thus do not get any useful URL in the INDEX. Moving the WWW value into the Makefile will make it easier to maintain and test whether it is still valid. It removes processing overhead from "make index" and it is a chance to select the most relevant entry from multiple URLs in many of the pkg-descr files. Best regards, STefan