CVS commit: pkgsrc/doc/guide/files

["Nia Alarie" <nia%netbsd.org@localhost>]

Module Name:    pkgsrc
Committed By:   nia
Date:           Mon Jun 14 22:53:03 UTC 2021

Modified Files:
        pkgsrc/doc/guide/files: components.xml

Log Message:
guide: Recommend that PKGNAME be lowercase


To generate a diff of this commit:
cvs rdiff -u -r1.60 -r1.61 pkgsrc/doc/guide/files/components.xml

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: pkgsrc/doc/guide/files/components.xml
diff -u pkgsrc/doc/guide/files/components.xml:1.60 pkgsrc/doc/guide/files/components.xml:1.61
--- pkgsrc/doc/guide/files/components.xml:1.60  Fri Mar 26 17:43:20 2021
+++ pkgsrc/doc/guide/files/components.xml       Mon Jun 14 22:53:02 2021
@@ -1,4 +1,4 @@
-<!-- $NetBSD: components.xml,v 1.60 2021/03/26 17:43:20 gdt Exp $ -->
+<!-- $NetBSD: components.xml,v 1.61 2021/06/14 22:53:02 nia Exp $ -->
 
 <chapter id="components"> <?dbhtml filename="components.html"?>
 <title>Package components - files, directories and contents</title>
@@ -38,7 +38,12 @@ sections.</para>
     regular expression
     <varname>^[A-Za-z0-9][A-Za-z0-9-_.+]*$</varname>, that is, it
     starts with a letter or digit, and contains only letters, digits,
-    dashes, underscores, dots and plus signs.</para></listitem>
+    dashes, underscores, dots and plus signs.
+    New packages should have entirely lower-case names, with the exception
+    of some that must follow pre-existing conventions
+    (e.g. R packages begin with <varname>R-</varname>).
+    You can use the <code>:tl</code> variable modifier to lower-case
+    the package name.</para></listitem>
 
     <listitem><para><varname>CATEGORIES</varname> is a list of categories
     which the package fits in. You can choose any of the top-level