Merging upstream version 2.0.3+dfsg (Closes: #923993, #1042533, #1045145).

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 40 insertions, 0 deletions

diff --git a/src/go/pkg/matcher/doc.go b/src/go/pkg/matcher/doc.go
new file mode 100644
index 000000000..33b06988d
--- /dev/null
+++ b/src/go/pkg/matcher/doc.go
@@ -0,0 +1,40 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+
+/*
+Package matcher implements vary formats of string matcher.
+
+Supported Format
+
+	string
+	glob
+	regexp
+	simple patterns
+
+The string matcher reports whether the given value equals to the string ( use == ).
+
+The glob matcher reports whether the given value matches the wildcard pattern.
+The pattern syntax is:
+
+	pattern:
+	    { term }
+	term:
+	    '*'         matches any sequence of characters
+	    '?'         matches any single character
+	    '[' [ '^' ] { character-range } ']'
+	    character class (must be non-empty)
+	    c           matches character c (c != '*', '?', '\\', '[')
+	    '\\' c      matches character c
+
+	character-range:
+	    c           matches character c (c != '\\', '-', ']')
+	    '\\' c      matches character c
+	    lo '-' hi   matches character c for lo <= c <= hi
+
+The regexp matcher reports whether the given value matches the RegExp pattern ( use regexp.Match ).
+The RegExp syntax is described at https://golang.org/pkg/regexp/syntax/.
+
+The simple patterns matcher reports whether the given value matches the simple patterns.
+The simple patterns is a custom format used in netdata,
+it's syntax is described at https://docs.netdata.cloud/libnetdata/simple_pattern/.
+*/
+package matcher