From owner-freebsd-doc@FreeBSD.ORG Fri Oct 19 12:31:32 2012 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id A3866418; Fri, 19 Oct 2012 12:31:32 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) by mx1.freebsd.org (Postfix) with ESMTP id 51E058FC08; Fri, 19 Oct 2012 12:31:32 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id 6084714E5F21; Fri, 19 Oct 2012 14:31:31 +0200 (CEST) X-Virus-Scanned: amavisd-new at !change-mydomain-variable!.example.com Received: from server.mypc.hu ([127.0.0.1]) by server.mypc.hu (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id W5K49l9EzbJO; Fri, 19 Oct 2012 14:31:30 +0200 (CEST) Received: from [192.168.3.100] (unknown [194.29.130.243]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id BB70714DD68D; Fri, 19 Oct 2012 14:31:30 +0200 (CEST) Message-ID: <50814827.8030707@FreeBSD.org> Date: Fri, 19 Oct 2012 14:31:35 +0200 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:14.0) Gecko/20120713 Thunderbird/14.0 MIME-Version: 1.0 To: FBSD Doc project , www@freebsd.org Subject: RFC: standardizing SVN properties in the doc repo X-Enigmail-Version: 1.4.4 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 19 Oct 2012 12:31:32 -0000 Hi, currently, the proper use of SVN properties and dealing with file types are not standardized in the doc repo. I propose the following policy for the repo: - Use the .sh extension for shell scripts so that they can be easily identified as such - Always add the $FreeBSD$ keyword and set svn:keywords to FreeBSD=%H if you create a text non-binary file that support escaping it. - Only set fbsd:nokeywords for non-binary (i.e. human-readable) files if there are no ways to escape the keyword. - If SVN detects your non-binary file as binary (may happen with non-Latin encodings), DO NOT SET fbsd:nokeywords but use fbsd:notbinary. - If SVN complains that a binary file does not have the keyword, first try to set the correct mime-type (see below) and only set fbsd:nokeywords if SVN still rejects the file. .css text/css .dtd application/xml-dtd .ent application/xml-dtd .gif image/gif .gz application/gzip .html text/html .ico image/vnd.microsoft.icon .jpg image/jpeg .js application/javascript .log text/plain .pdf application/pdf .png image/png .rss application/rss+xml .sh text/plain .svg image/svg+xml .txt text/plain .xml application/xml .xsl application/xslt+xml If there are no objections, I'll give a sweep to the tree to make it consistent and I'll document this. Gabor