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 73F99139084 for ; Sat, 25 Nov 2017 20:49:50 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 56489E0E7C; Sat, 25 Nov 2017 20:49:40 +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 37870E0E7C for ; Sat, 25 Nov 2017 20:49:40 +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 7E15633FE49 for ; Sat, 25 Nov 2017 20:49:39 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id D8FE1A787 for ; Sat, 25 Nov 2017 20:49: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: <1511642956.a9afe58c29b0d3be183a75c23ffbb4ea25af5ca9.mgorny@gentoo> Subject: [gentoo-commits] data/glep:master 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: a9afe58c29b0d3be183a75c23ffbb4ea25af5ca9 X-VCS-Branch: master Date: Sat, 25 Nov 2017 20:49: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: 71fbeed3-79bc-4e97-85c5-3834cbfa058b X-Archives-Hash: b8b03b20a0a514328efa0de54a690d95 commit: a9afe58c29b0d3be183a75c23ffbb4ea25af5ca9 Author: Michał Górny gentoo org> AuthorDate: Tue Nov 21 17:22:34 2017 +0000 Commit: Michał Górny gentoo org> CommitDate: Sat Nov 25 20:49:16 2017 +0000 URL: https://gitweb.gentoo.org/data/glep.git/commit/?id=a9afe58c 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,