From ce9e9c2dbec71841d5ac5311f6d18ffb78bce9d3 Mon Sep 17 00:00:00 2001 From: Chandan Singh Date: Sun, 30 Dec 2018 21:35:17 +0000 Subject: doc: Add note about valid element names --- doc/source/format_declaring.rst | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/doc/source/format_declaring.rst b/doc/source/format_declaring.rst index 57ea4488a..714e1fa33 100644 --- a/doc/source/format_declaring.rst +++ b/doc/source/format_declaring.rst @@ -526,3 +526,27 @@ read-only variables are also dynamically declared by BuildStream: build, support for this is conditional on the element type and the build system used (any element using 'make' can implement this). + + +Naming elements +--------------- +When naming the element files, use the following rules: + +* The name of the file must have ``.bst`` extension. + +* All characters in the name must be printable 7-bit ASCII characters. + +* Following characters are reserved and must not be part of the name: + + - ``<`` (less than) + - ``>`` (greater than) + - ``:`` (colon) + - ``"`` (double quote) + - ``/`` (forward slash) + - ``\`` (backslash) + - ``|`` (vertical bar) + - ``?`` (question mark) + - ``*`` (asterisk) + +BuildStream will attempt to raise warnings when any of these rules are violated +but that may not always be possible. -- cgit v1.2.1