@@ -5,7 +5,7 @@ macro is:
5
5
6
6
* enclosed in symbols ` @ ` or ` @@ ` (unless escaped with ` \ ` )
7
7
* has a name which a combination of word chars (` \w ` in regexp terms) and colons
8
- ` : `
8
+ ` : `
9
9
* can be either a configuration variable or a macro function
10
10
11
11
In this document we will call macro functions just _ macro_s in this document
@@ -83,7 +83,7 @@ nested macros, functions are generally separated into two groups:
83
83
- One group takes the input text as-is. It is then up to the macro itself at
84
84
which point it would do the expansion.
85
85
- For another group (named _ preexpanded macros_ for convenience) the text first
86
- gets expanded by the macros subsystem and then passed in as the parameter.
86
+ gets expanded by the macros subsystem and then passed in as the parameter.
87
87
88
88
For example:
89
89
@@ -125,7 +125,7 @@ is considered to be the most reliable way to get the job done.
125
125
## Contexts
126
126
127
127
Contexts are a concept of ` NQP::Config ` module which is heavily utilized by
128
- ` NQP::Macros ` .
128
+ ` NQP::Macros ` .
129
129
130
130
A context is a state structure which keeps configuration properties and
131
131
variables. While properties are not generally available for the expansion
@@ -152,7 +152,7 @@ For simplicity, macros in this section are not enclosed with `@`.
152
152
153
153
_ Pre-expand_
154
154
155
- See Perl 5 ` chomp ` function.
155
+ See Perl's ` chomp ` function.
156
156
157
157
### expand(text)
158
158
@@ -184,7 +184,7 @@ _Pre-expanded_
184
184
185
185
The macro name stands for Normalize File Path. Converts Unix-style paths with
186
186
` / ` directory separator into what is suitable for the current OS. Most typical
187
- example is Windows where slashes are replaced with backslashes.
187
+ example is Windows where slashes are replaced with backslashes.
188
188
189
189
If a path contains whitespaces it will be quoted following the quoting rules of
190
190
the current platform. For example:
@@ -231,7 +231,7 @@ like `src/Perl6/Actions.nqp src/Perl6/PodActions.nqp`.
231
231
_ Pre-expanded_
232
232
233
233
Quotes path by using rules valid for the shell of the current
234
- platform.
234
+ platform.
235
235
236
236
```
237
237
target: $(DEPS)
@@ -310,7 +310,7 @@ the template file in templates directory defined by `templates_dir`
310
310
confgiguration variable (` @base_dir@/tools/templates ` normally). If current
311
311
context defines ` ctx_subdir ` variable then this subdirectory within the
312
312
templates directory is checked first. Then if no file is found the macro falls
313
- back to the default ` @templates_dir@ ` .
313
+ back to the default ` @templates_dir@ ` .
314
314
315
315
It is a good practice to have template's filename to end with ` .in ` extension.
316
316
But the actual order of filenames tried check for this extension last. First the
@@ -460,8 +460,8 @@ Condition can be of one of the following very simple forms:
460
460
- ` config_variable ` – checks if a configuration variable is defined
461
461
- ` !config_variable ` – variable is not defined
462
462
- ` config_variable==value ` , ` config_variable!=value ` – if variable value ` eq ` or
463
- ` ne ` to the _ value_ , respectively.
464
-
463
+ ` ne ` to the _ value_ , respectively.
464
+
465
465
_ Note_ that the value is used as is, no spaces allowed and no quoting/escaping
466
466
supported for it.
467
467
@@ -514,7 +514,7 @@ _Pre-expanded_
514
514
515
515
Produce ` echo ` command for Makefile. Takes into consideration current platform
516
516
and quotes text properly.
517
-
517
+
518
518
### nop(text)
519
519
520
520
Does nothing, returns the parameter text as is. Can be used as an escape macro
@@ -541,7 +541,7 @@ Would result in:
541
541
542
542
The following variables are set by the ` NQP::Config ` as defaults:
543
543
544
- - ` perl ` Perl 5 executable.
544
+ - ` perl ` Perl executable.
545
545
- ` slash ` Directory separator, used by the current OS
546
546
- ` shell ` Default shell
547
547
- ` base_dir ` Where ` Configure.pl ` is located. In other words, the directory
@@ -558,4 +558,3 @@ The following variables are set by the `NQP::Config` as defaults:
558
558
- ` cpsep ` Separator of pathlists for the current OS. ` ; ` for Windows, ` : `
559
559
otherwise.
560
560
- ` runner_suffix ` Set from ` bat ` variable for now.
561
-
0 commit comments