From owner-svn-doc-head@FreeBSD.ORG Mon Aug 4 12:32:32 2014 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 0666231B for ; Mon, 4 Aug 2014 12:32:32 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1 with cipher ECDHE-RSA-AES256-SHA (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id DBDC72611 for ; Mon, 4 Aug 2014 12:32:31 +0000 (UTC) Received: from mat (uid 986) (envelope-from mat@FreeBSD.org) id 50bd by svn.freebsd.org (DragonFly Mail Agent v0.9+); Mon, 04 Aug 2014 12:32:31 +0000 From: Mathieu Arnold Date: Mon, 4 Aug 2014 12:32:31 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r45398 - head/en_US.ISO8859-1/books/porters-handbook/uses X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Message-Id: <53df7d5f.50bd.6a5b6fba@svn.freebsd.org> X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 04 Aug 2014 12:32:32 -0000 Author: mat (ports committer) Date: Mon Aug 4 12:32:31 2014 New Revision: 45398 URL: http://svnweb.freebsd.org/changeset/doc/45398 Log: Document USES=cpe. Reviewed by: wblock, des, antoine Sponsored by: Absolight Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Mon Aug 4 08:49:01 2014 (r45397) +++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Mon Aug 4 12:32:31 2014 (r45398) @@ -166,6 +166,96 @@ pkg-plist. + + cpe + + (none) + + + Include Common Platform Enumeration + (CPE) information in package manifest + as a CPE 2.3 formatted string. See the + CPE + specification for details. To add + CPE information to a port, follow these + steps: + + + + Search for the official CPE entry for the + software product either by using the NVD's CPE + search engine or in the official + CPE dictionary (warning, + very large XML file). + Do not ever make up CPE + data. + + + + Add cpe to + USES and compare the result of + make -V CPE_STR to the + CPE dictionary entry. Continue + one step at a time until make -V + CPE_STR is correct. + + + + If the product name (second field, defaults to + PORTNAME) is incorrect, define + CPE_PRODUCT. + + + + If the vendor name (first field, defaults to + CPE_PRODUCT) is incorrect, define + CPE_VENDOR. + + + + If the version field (third field, defaults to + PORTVERSION) is incorrect, define + CPE_VERSION. + + + + If the update field (fourth field, defaults to + empty) is incorrect, define + CPE_UPDATE. + + + + If it is still not correct, check + Mk/Uses/cpe.mk for additional + details, or contact the &a.ports-secteam;. + + + + Derive as much as possible of the + CPE name from existing variables + such as PORTNAME and + PORTVERSION. Use variable + modifiers to extract the relevant portions from + these variables rather than hardcoding the + name. + + + + Always run make -V + CPE_STR and check the output before + committing anything that changes + PORTNAME or + PORTVERSION or any other variable + which is used to derive + CPE_STR. + + + + + desktop-file-utils