Skip to content

Commit 00b0548

Browse files
worksofliamworksofliam
committed
Simplification of CL docs
Signed-off-by: worksofliam <mrliamallan@live.co.uk>
1 parent 87abd67 commit 00b0548

File tree

3 files changed

+64
-30
lines changed

3 files changed

+64
-30
lines changed

‎.astro/astro/content.d.ts‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -439,6 +439,13 @@ declare module 'astro:content' {
439439
collection: "docs";
440440
data: InferEntrySchema<"docs">
441441
} & { render(): Render[".mdx"] };
442+
"tips/seuColours.mdx": {
443+
id: "tips/seuColours.mdx";
444+
slug: "tips/seucolours";
445+
body: string;
446+
collection: "docs";
447+
data: InferEntrySchema<"docs">
448+
} & { render(): Render[".mdx"] };
442449
"tips/terminals.mdx": {
443450
id: "tips/terminals.mdx";
444451
slug: "tips/terminals";

‎.astro/settings.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
22
"_variables": {
3-
"lastUpdateCheck": 1737379639185
3+
"lastUpdateCheck": 1740154876604
44
}
55
}

‎src/content/docs/extensions/clle/index.mdx‎

Lines changed: 56 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -25,73 +25,100 @@ Or it can be installed from the Extension view inside Visual Code.
2525
</CardGrid>
2626
## Content Assist
2727

28-
Content Assist is triggered by `Ctrl+space`. This is best explained by examples.
28+
Suppose you want to create a data area with the CRTDTAARA command. Enter CRTDTAARA __follwed by a space__, then press _Ctrl+Space_ to invoke Content Assist to produce a pick list like this:
2929

30-
### Content Assist Example 1
30+
![Example step 2](../../../../assets/clle/ExCL_02.png)
3131

32-
Suppose you want to create a data area with the CRTDTAARA command. Enter CRTDTAARA __follwed by a space__, like this: ![Example Step 1](../../../../assets/clle/ExCL_01.png)
32+
<CardGrid><Card>
3333

34-
Press `Ctrl+space` to invoke Content Assist to produce a pick list like this:
35-
![Example step 2](../../../../assets/clle/ExCL_02.png)
34+
Press _Enter_ or _Tab_ to accept the highlighted _All parameters_ from the pick list and a skeleton command is created.
3635

37-
Press `enter` or `tab` to accept the highlighted "`All parameters`" from the pick list and a skeleton command is created: ![Example step 3](../../../../assets/clle/ExCL_03.png)
36+
</Card><Card>
3837

39-
The cursors is in the first parameter value `DTAARA`. Enter the data area name, then press the `tab` key to move the cursor to the next parameter, `TYPE`: ![Example step 4](../../../../assets/clle/ExCL_04.png)
38+
![Example step 3](../../../../assets/clle/ExCL_03.png)
4039

41-
Press `Ctrl+space` to produce a pick list of valid types: ![Example step 5](../../../../assets/clle/ExCL_05.png)
40+
</Card></CardGrid>
4241

43-
Highlight `*CHAR`, then `tab` to move to the `LENGTH` parameter. Enter 20, then tab to `VALUE`. The value can be a text string or it can be a variable. Use`Ctrl+space` to get a pick list of variables (just one in this example): ![Example step 6](../../../../assets/clle/ExCL_06.png)
42+
<CardGrid><Card>
4443

45-
Chose the variable. Delete the other unneeded parameter and you have a completed command: ![Example step 7](../../../../assets/clle/ExCL_07.png)
44+
Use`Ctrl+space` to get a pick list of special values or available variables (just one in this example):
4645

46+
</Card><Card>
4747

48-
### Content Assist Example 2
48+
![Example step 5](../../../../assets/clle/ExCL_05.png)
4949

50-
If you are familar with a command, you do not have to create a skeleton with all parameters. Suppose you have typed this far: ![Example 2 step 1](../../../../assets/clle/ExCL_21.png)
50+
</Card></CardGrid>
5151

52-
When you type `t` a pick list of parameters that start with `t` is provided: ![Example 2 step 2](../../../../assets/clle/ExCL_22.png)
52+
### Content Assist Snippets
5353

54-
If a pick list is too long, you can enter additional characters to reduce it. In this case, if you entered `ty` only `TYPE` would appear in the pick list.
54+
Prompting of most CL commands requires a connection to a server. However, there are a number of commands that are provided as snippets, which don't require a connection. `DCL`, for example, is provided as a snippet.
5555

56-
Select `TYPE` and the cursor is in the type value field where you can do `Ctrl+space` to get a pick list of valid types: ![Example 2 step 3](../../../../assets/clle/ExCL_23.png)
56+
<CardGrid><Card>
5757

58+
To declare a variable, enter just `d` and get a list of commands that begin with `d`:
5859

59-
### Content Assist Snippets
60+
</Card><Card>
6061

61-
Prompting of most CL commands requires a connection to a server. However, there are a number of commands that are provided as snippets, which don't require a connection. `DCL`, for example, is provided as a snippet.
62+
![Command assist](../../../../assets/clle/assist_01.png)
6263

63-
Commands that are provided as snippets are preceeded by a "box": ![Example 2 step 3](../../../../assets/clle/ExCL_Box.png)
64+
</Card></CardGrid>
6465

65-
To declare a variable, enter just "d" and get a list of commands that begin with "d":
66+
<CardGrid><Card>
6667

67-
![Command assist](../../../../assets/clle/assist_01.png)
68+
Since the `DCL` command is highlighted, hit enter and get a pick list of available parameters:
6869

69-
Since the "`DCL`" command is highlighted, hit enter and get a pick list of available parameters:
70+
</Card><Card>
7071

7172
![Command assist all keywords](../../../../assets/clle/assist_02.png)
7273

73-
The "`VAR`" parameter value is selected, so enter the variable name, then tab to the "`TYPE`" parameter value:
74+
</Card></CardGrid>
75+
76+
<CardGrid><Card>
77+
78+
The `VAR` parameter value is selected, so enter the variable name, then tab to the `TYPE` parameter value:
79+
80+
</Card><Card>
81+
82+
![Command assist parameter](../../../../assets/clle/assist_03.png)
83+
84+
</Card></CardGrid>
85+
86+
<CardGrid><Card>
87+
88+
If all the valid valued for `TYPE` are know, just enter a valid value, for example `*CHAR`. Or delete the highlighted value and key _Ctrl+Space_ to get a pick list of the valid values:
89+
90+
</Card><Card>
7491

7592
![Command assist parameter](../../../../assets/clle/assist_03.png)
7693

77-
If all the valid valued for "`TYPE`" are know, just enter a valid value, for example "*CHAR". Or delete the highlighted value and key `Ctrl+Space` to get a pick list of the valid values:
94+
</Card></CardGrid>
95+
96+
<CardGrid><Card>
97+
98+
If all the valid valued for `TYPE` are know, just enter a valid value, for example `*CHAR`. Or delete the highlighted value and key _Ctrl+Space_ to get a pick list of the valid values:
99+
100+
</Card><Card>
78101

79102
![Command assist parameter](../../../../assets/clle/assist_04.png)
80103

104+
</Card></CardGrid>
105+
81106
## CL Code Runner
82107

83-
A CL command may be executed by highlighting the command and pressing `Ctrl+r`.
108+
A CL command may be executed by highlighting the command and pressing _Ctrl+R_.
84109

85110
### Code Runner Example
86-
The two lines of the `CRTMSGF` command are highlighted:
87-
![Run CL example 1](../../../../assets/clle/RunCL_01.png)
88111

89-
Press `Ctrl+r` and success is reported:![Run CL example 1](../../../../assets/clle/RunCL_02.png)
112+
The two lines of the `CRTMSGF` command are highlighted:
90113

91-
Click `Open output` if you want more detail or if the command fails: ![Run CL example 1](../../../../assets/clle/RunCL_03.png)
114+
![Run CL example 1](../../../../assets/clle/RunCL_01.png)
92115

116+
Press _Ctrl+R_ and success is reported:
93117

118+
![Run CL example 1](../../../../assets/clle/RunCL_02.png)
94119

120+
Click _Open output_ if you want more detail or if the command fails:
95121

96-
Not all CL commands may be executed.
122+
![Run CL example 1](../../../../assets/clle/RunCL_03.png)
97123

124+
Not all CL commands may be executed.

0 commit comments

Comments
 (0)