summaryrefslogtreecommitdiff
path: root/doc/guide
diff options
context:
space:
mode:
authornia <nia@pkgsrc.org>2021-06-14 22:53:02 +0000
committernia <nia@pkgsrc.org>2021-06-14 22:53:02 +0000
commit605415ee520d2bb025b8892e2ad6d6ddebd4819e (patch)
tree6ac37b2fb9024c39be00b6a3e09a825773bc3495 /doc/guide
parentfa9614d2e2adc69cce399fd60fa8f7defb4aeddb (diff)
downloadpkgsrc-605415ee520d2bb025b8892e2ad6d6ddebd4819e.tar.gz
guide: Recommend that PKGNAME be lowercase
Diffstat (limited to 'doc/guide')
-rw-r--r--doc/guide/files/components.xml9
1 files changed, 7 insertions, 2 deletions
diff --git a/doc/guide/files/components.xml b/doc/guide/files/components.xml
index ddf99edb554..933c002779c 100644
--- a/doc/guide/files/components.xml
+++ b/doc/guide/files/components.xml
@@ -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