docs/66775: Clarification that port names should not contain version numbers

[Oliver Eikemeier]

>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
  <http://www.freebsd.org/doc/en_US.ISO8859-1/articles/committers-guide/ports.html#Q12.2.3.>
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
  <http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/makefile-naming.html#PORTING-PKGNAME>
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: