5 Goalfile - introduction, tutorial, and reference for writing goal files
15 =head2 Standard Functions
21 sort (["c", "b", "b", "a"]) ⇒ ["a", "b", "c"]
23 This takes a list of strings and sorts it, removing duplicates.
25 =head3 subst (from, to, text)
29 subst ("aa", "AA", "aabbccaa") ⇒ "AAbbccAA"
30 subst ("a.*c", "b", "aaacac") ⇒ "bb"
32 This function works something like make’s C<subst> function, except
33 that C<from> is a regular expression, specifically a L<sed(1)>
34 extended regular expression.
36 =head3 wildcard (pattern)
40 wildcard ("*.c") ⇒ ["bar.c", "foo.c"]
42 The single parameter is a wildcard which is expanded into a list of
43 files using ordinary globbing rules.
45 =head3 wrap (wrapper, list)
49 wrap ("*file", ["bar.c", "foo.c"]) ⇒ [*file("bar.c"), *file("foo.c")]
51 Each element in C<list> is wrapped into a call to C<wrapper(element)>.
52 There are two common uses for this: either to add explicit tactics
53 (such as C<*file>) to a plain list of strings as in the example above;
54 or to turn a list of strings into a list of goal or function calls.
62 Richard W.M. Jones <rjones@redhat.com>
66 Copyright (C) 2020 Richard W.M. Jones
68 Copyright (C) 2020 Red Hat Inc.
70 This program is free software; you can redistribute it and/or modify
71 it under the terms of the GNU General Public License as published by
72 the Free Software Foundation; either version 2 of the License, or
73 (at your option) any later version.
75 This program is distributed in the hope that it will be useful,
76 but WITHOUT ANY WARRANTY; without even the implied warranty of
77 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
78 GNU General Public License for more details.
80 You should have received a copy of the GNU General Public License along
81 with this program; if not, write to the Free Software Foundation, Inc.,
82 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.