From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id DB0291396D9 for ; Tue, 21 Nov 2017 17:48:39 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 3678DE0F37; Tue, 21 Nov 2017 17:48:38 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 1954AE0F32 for ; Tue, 21 Nov 2017 17:48:38 +0000 (UTC) Received: from oystercatcher.gentoo.org (unknown [IPv6:2a01:4f8:202:4333:225:90ff:fed9:fc84]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 0FE4333D3C7 for ; Tue, 21 Nov 2017 17:48:37 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id C68D7A2BD for ; Tue, 21 Nov 2017 17:48:35 +0000 (UTC) From: "Michał Górny" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Michał Górny" Message-ID: <1511284954.5ba06543e8d104d86ee6823d16b2167b31ee3b87.mgorny@gentoo> Subject: [gentoo-commits] data/glep:glep-manifest commit in: / X-VCS-Repository: data/glep X-VCS-Files: glep-0074.rst X-VCS-Directories: / X-VCS-Committer: mgorny X-VCS-Committer-Name: Michał Górny X-VCS-Revision: 5ba06543e8d104d86ee6823d16b2167b31ee3b87 X-VCS-Branch: glep-manifest Date: Tue, 21 Nov 2017 17:48:35 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Archives-Salt: a6e6b1cc-38aa-4835-afb6-a4e7c2b067b4 X-Archives-Hash: f25674f3b134f921c4b3d43cfd8a1244 commit: 5ba06543e8d104d86ee6823d16b2167b31ee3b87 Author: Michał Górny gentoo org> AuthorDate: Tue Nov 21 17:22:34 2017 +0000 Commit: Michał Górny gentoo org> CommitDate: Tue Nov 21 17:22:34 2017 +0000 URL: https://gitweb.gentoo.org/data/glep.git/commit/?id=5ba06543 glep-0074: Specify slash as path separator, disallow backwards slash glep-0074.rst | 18 +++++++++++++----- 1 file changed, 13 insertions(+), 5 deletions(-) diff --git a/glep-0074.rst b/glep-0074.rst index d0750f5..6288175 100644 --- a/glep-0074.rst +++ b/glep-0074.rst @@ -134,10 +134,11 @@ be explicitly excluded via ``IGNORE``. All paths specified in the Manifest file must consist of characters corresponding to valid UTF-8 code points excluding the NULL character -(``U+0000``) and characters classified as whitespace in the current -version of the Unicode standard [#UNICODE]_. It is an error to use -Manifest files in directories containing files whose names contain -the disallowed characters. +(``U+0000``), the backwards slash (``\``) and characters classified +as whitespace in the current version of the Unicode standard +[#UNICODE]_. It is an error to use Manifest files in directories +containing files whose names contain the disallowed characters. +The forward slash (``/``) must be used as path separator. File verification @@ -570,7 +571,14 @@ technically problematic groups: written using C. Furthermore, it is not allowed in any known filesystem. -2. Whitespace characters are used to separate Manifest fields +2. The backwards slash character (``\``) is frequently used as an escape + character, in particular in the languages derived from C and in shell + script. Furthermore, it is used as path separator on Windows systems. + It is forbidden to avoid implementation mistakes (in particular, + attempting to use it to escape whitespace or as path separator + on Windows) but also reserved for possible future extension. + +3. Whitespace characters are used to separate Manifest fields and entries. While technically it would be enough to restrict space (``U+0020``) character that is normally used as the separator and newline (``U+000A``) character that is used to separate lines,