From owner-freebsd-doc@FreeBSD.ORG Mon May 17 13:20:18 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 0A7E116A4D0 for ; Mon, 17 May 2004 13:20:18 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7165743D46 for ; Mon, 17 May 2004 13:20:17 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) i4HKKHCL025110 for ; Mon, 17 May 2004 13:20:17 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i4HKKHhc025109; Mon, 17 May 2004 13:20:17 -0700 (PDT) (envelope-from gnats) Resent-Date: Mon, 17 May 2004 13:20:17 -0700 (PDT) Resent-Message-Id: <200405172020.i4HKKHhc025109@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Oliver Eikemeier Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 4705016A589 for ; Mon, 17 May 2004 13:17:55 -0700 (PDT) Received: from fillmore.dyndns.org (port-212-202-49-130.reverse.qsc.de [212.202.49.130]) by mx1.FreeBSD.org (Postfix) with ESMTP id D095343D3F for ; Mon, 17 May 2004 13:17:53 -0700 (PDT) (envelope-from eikemeier@fillmore-labs.com) Received: from [172.16.0.2] (helo=fillmore-labs.com) by fillmore.dyndns.org with esmtp (Exim 4.34; FreeBSD) id 1BPoYQ-00048M-Su for freebsd-gnats-submit@FreeBSD.org; Mon, 17 May 2004 22:17:53 +0200 Message-Id: <40A91DDB.3080203@fillmore-labs.com> Date: Mon, 17 May 2004 22:17:31 +0200 From: Oliver Eikemeier To: freebsd-gnats-submit@FreeBSD.org Subject: docs/66775: Clarification that port names should not contain version numbers X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 17 May 2004 20:20:18 -0000 >Number: 66775 >Category: docs >Synopsis: Clarification that port names should not contain version numbers >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Mon May 17 13:20:17 PDT 2004 >Closed-Date: >Last-Modified: >Originator: Oliver Eikemeier >Release: FreeBSD 4.10-STABLE i386 >Organization: Fillmore Labs - http://www.fillmore-labs.com >Environment: System: FreeBSD nuuk.fillmore-labs.com 4.10-STABLE >Description: Ports documentation should state more clearly that the version number of a port should not be part of its name. >How-To-Repeat: >Fix: The Committers Guide has the following sentence: "Upgrade the copied port to the new version (remember to change the PORTNAME so there are not duplicate ports with the same name)." Which should probably read "Upgrade the copied port to the new version (remember to change the LATEST_LINK so there are not duplicate ports with the same name)." since changing the ports name is usually a bad idea. Also there is is new tool chkmodules, which could be called before or after operations on modules: env PORTSDIR=/path/to/ports CVSROOT=/path/to/cvsroot /path/to/ports/Tools/scripts/chkmodules.pl The Porter's Handbook should contain something about port names, like: "The version number should not be part of the ports name (PORTNAME), if you have a port of apache httpd 2.1, use PORTNAME=apache PORTVERSION=2.1 and set LATEST_LINK=${PKGNAMEPREFIX}apache21${PKGNAMESUFFIX} to avoid conflicts with other versions of apache ports." >Release-Note: >Audit-Trail: >Unformatted: