From patchwork Tue Apr 4 02:17:24 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Justin Vreeland X-Patchwork-Id: 88 Return-Path: Delivered-To: patchwork@archlinux.org Received: from nymeria.archlinux.org by nymeria.archlinux.org (Dovecot) with LMTP id NqOoITgC41g/IQAAtiB/HQ for ; Tue, 04 Apr 2017 04:17:28 +0200 Received: from nymeria.archlinux.org (localhost.localdomain [127.0.0.1]) by nymeria.archlinux.org (Postfix) with ESMTP id A33904033B; Tue, 4 Apr 2017 04:17:26 +0200 (CEST) X-Spam-Checker-Version: SpamAssassin 3.4.1 (2015-04-28) on nymeria.archlinux.org X-Spam-Level: X-Spam-Status: No, score=-4.2 required=2.5 tests=BAYES_00,RCVD_IN_DNSWL_MED shortcircuit=no autolearn=unavailable autolearn_force=no version=3.4.1 Received: from luna.archlinux.org (luna.archlinux.org [5.9.250.164]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by nymeria.archlinux.org (Postfix) with ESMTPS; Tue, 4 Apr 2017 04:17:26 +0200 (CEST) Received: from luna.archlinux.org (luna.archlinux.org [127.0.0.1]) by luna.archlinux.org (Postfix) with ESMTP id 50ABD2C0DD; Tue, 4 Apr 2017 02:17:26 +0000 (UTC) Authentication-Results: luna.archlinux.org; dkim=none Received: from luna.archlinux.org (luna.archlinux.org [127.0.0.1]) by luna.archlinux.org (Postfix) with ESMTP id C95072C0DC for ; Tue, 4 Apr 2017 02:17:23 +0000 (UTC) Received: from nymeria.archlinux.org (nymeria.archlinux.org [IPv6:2a00:1828:2000:547::2]) by luna.archlinux.org (Postfix) with ESMTPS for ; Tue, 4 Apr 2017 02:17:23 +0000 (UTC) Received: from nymeria.archlinux.org (localhost.localdomain [127.0.0.1]) by nymeria.archlinux.org (Postfix) with ESMTP id C0173401D2 for ; Tue, 4 Apr 2017 04:17:22 +0200 (CEST) Received: from mail.jvreeland.com (unknown [45.55.227.122]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by nymeria.archlinux.org (Postfix) with ESMTPS for ; Tue, 4 Apr 2017 04:17:22 +0200 (CEST) Received: from makise.localdomain (184-99-255-174.hlrn.qwest.net [184.99.255.174]) by mail.jvreeland.com (Postfix) with ESMTPSA id 597CD9F7B9; Mon, 3 Apr 2017 22:17:21 -0400 (EDT) From: Justin Vreeland To: arch-projects@archlinux.org Date: Mon, 3 Apr 2017 20:17:24 -0600 Message-Id: <20170404021724.13807-1-justin@jvreeland.com> X-Mailer: git-send-email 2.12.2 Subject: [arch-projects] [namcap][PATCH] Remove out of date rules section X-BeenThere: arch-projects@archlinux.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Arch Linux projects development discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Arch Linux projects development discussion Errors-To: arch-projects-bounces@archlinux.org Sender: "arch-projects" X-UID: 228 Status: X-Keywords: Content-Length: 4605 The differences between namcap --list and namcap(1) are confusing. Since FS#38562 already floats the idea of removing it, and --list uses python docstrings it seems to make sense to remove the RULES section. Signed-off-by: Justin Vreeland --- namcap.1 | 96 ---------------------------------------------------------------- 1 file changed, 96 deletions(-) diff --git a/namcap.1 b/namcap.1 index 28b3e6d..ef33860 100644 --- a/namcap.1 +++ b/namcap.1 @@ -29,102 +29,6 @@ RULELIST is a comma-separated list of rule names .TP .B "\-v, \-\-version" print version and exit -.SH RULES -.TP -.B arrays -Verifies that array variables are actually arrays and not strings -.TP -.B badbackups -Verifies that backup entries don't begin with / -.TP -.B carch -Looks for references to i686 and i586 and tells you to use $CARCH instead -.TP -.B capsnames -Checks a PKGBUILD to verify that the package name has no upper case characters -.TP -.B capsnamespkg -Checks a package to verify that the package name has no upper case characters -.TP -.B checksums -Makes sure that a PKGBUILD includes valid checksums -.TP -.B depends -This module runs ldd on all executables, gets the link-level dependencies, finds the smallest subset of dependencies that cover the link-level dependencies, and compares that list to the depends of the package. It returns messages in three cases: dependency detected and not included, dependency included but already satisfied, and dependency included and not needed. These suggestions are just guidelines and all package builders should take this into account (i.e. you're smarter than namcap is) - -Some cases where namcap fails are dlopen() and obscure links. dlopen()'d libraries don't show up because they are loaded at run time: in the case of a program that loads plugins. Obscure links are the cases where only a small portion of the package needs something to run; usually, the small portion won't be accessed unless that thing is installed (i.e. a java plugin for mozilla included in the java package). -.TP -.B directoryname -Checks the directory names in the package file list for standard directories (i.e. /etc, /usr/bin, /usr/lib). All files in directories that are non-standard are returned -.TP -.B elffiles -Gives an error if it finds ELF (binary) files outside the standard paths (/bin, /usr/bin, etc.) -.TP -.B emptydir -Looks for directories in a package that don't contain any files -.TP -.B extravars -Verifies that extra variables start with an underscore -.TP -.B fhsinfopages -Verifies correct installation of info pages -.TP -.B fhsmanpages -Verifies correct installation of man pages -.TP -.B fileownership -Verifies that all files are owned by root:root and not some other user or group -.TP -.B gnomemime -Checks for generated GNOME mime files -.TP -.B hicoloricons -Checks whether the hicolor icon cache is updated when a package installs -files in /usr/share/icons/hicolor -.TP -.B infodirectory -Verifies that a package does not contain the info directory file (/usr/share/info/dir) -.TP -.B invalidstartdir -Any PKGBUILDs that refer to files in $startdir are incorrect -.TP -.B libtool -Warns if libtool (*.la) files are present -.TP -.B license -Verifies that the licenses variable has been filled in in a PKGBUILD. -.TP -.B licensepkg -Verifies that the licenses variable has been filled in in a package. For packages with a custom license it -checks whether the license file has been installed in -/usr/share/licenses/$pkgname/ -.TP -.B perllocal -Searches for perllocal.pod. perllocal.pod is a nasty file that's included during most perl module installations -.TP -.B permissions -Checks basic file and and directory permissions. It returns warnings about world readable bits not being set, world writable bits being set, and world executable bit not being set for directories -.TP -.B rpath -Gives an error if a binary has RPATH set to something other than /usr/lib -.TP -.B scrollkeeper -Verifies that there aren't any scrollkeeper directories -.TP -.B sfurl -Warns if a PKGBUILD is downloading from a specific sourceforge mirror instead of the generic downloads.sourceforge.net -.TP -.B symlink -Finds out symbolic and hard links which do not point to a valid path in the package -.TP -.B tags -For package maintainers, this module verifies that we have remembered to add a Maintainer and Contributor comment. -.TP -.B url -Verifies that we have the url variable set in the PKGBUILD -.TP -.B urlpkg -Verifies that we have the url variable set in the package file .SH EXAMPLES .TP .B namcap foo.pkg.tar.gz