Skip to content

Commit 7413dd9

Browse files
Update ChatScript-Advanced-User-Manual.md
1 parent a90de71 commit 7413dd9

File tree

1 file changed

+30
-35
lines changed

1 file changed

+30
-35
lines changed

WIKI/ChatScript-Advanced-User-Manual.md

Lines changed: 30 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -346,25 +346,25 @@ The flags and their meanings are:
346346

347347
|flag | description
348348
|:----------------:|--------------
349-
|__`Random`__ | search rules randomly instead of linearly
350-
|__`NoRandom`__ | (default) search rules linearly
351-
|__`Keep`__ | do not erase responders ever. Gambits (and rejoinders) are not affected by this
352-
|__`Erase`__ | (default) erase responders that successfully generate output.<br>Gambits automatically erase unless you suppress them specifically.
353-
|__`NoStay`__ | do not consider this a topic to remain in, leave it (except for rejoinders)
354-
|__`Stay`__ | (default) make this a pending topic when it generates output
355-
|__`Repeat`__ | allow rules to generate output which has been output recently
356-
|__`NoRepeat`__ | (default) do not generate output if it matches output made recently
357-
|__`Priority`__ | raise the priority of this topic when matching keywords
358-
|__`Normal`__ | (default) give this topic normal priority when matching keywords
359-
|__`Deprioritize`__| lower the priority of this topic when matching keywords
360-
|__`System`__ | this is a system topic. It is automatically `NoStay`, `Keep`.<br>`Keep` automatically applies to gambits as well. The system never looks to these topics for gambits. System topics can never be considered pending (defined shortly). They can not have themselves or their rules be enabled or disabled. Their status/data is never saved to user files.
361-
|__`User`__ | (default) this is a normal topic
362-
|__`NoBlocking`__ | should not perform any blocking tests on this topic in `:verify`
363-
|__`NoPatterns`__ | should not perform any pattern tests on this topic in `:verify`
364-
|__`NoSamples`__ | should not perform any sample tests on this topic in `:verify`
365-
|__`NoKeys`__ | should not perform any keyword tests on this topic in `:verify`
366-
|__`More`__ | normally if you try to redeclare a concept, you get an error. `MORE` tells CS you intend to extend the concept and allows additional keywords.
367-
|__`Bot=name`__ | if this is given, only named bots are allowed to use this topic. See `ChatScript Multiple Bots manual`
349+
|__`random`__ | search rules randomly instead of linearly
350+
|__`norandom`__ | (default) search rules linearly
351+
|__`keep`__ | do not erase responders ever. Gambits (and rejoinders) are not affected by this
352+
|__`erase`__ | (default) erase responders that successfully generate output.<br>Gambits automatically erase unless you suppress them specifically.
353+
|__`nostay`__ | do not consider this a topic to remain in, leave it (except for rejoinders)
354+
|__`stay`__ | (default) make this a pending topic when it generates output
355+
|__`repeat`__ | allow rules to generate output which has been output recently
356+
|__`norepeat`__ | (default) do not generate output if it matches output made recently
357+
|__`priority`__ | raise the priority of this topic when matching keywords
358+
|__`normal`__ | (default) give this topic normal priority when matching keywords
359+
|__`deprioritize`__| lower the priority of this topic when matching keywords
360+
|__`system`__ | this is a system topic. It is automatically `nostay`, `keep`.<br>`keep` automatically applies to gambits as well. The system never looks to these topics for gambits. System topics can never be considered pending (defined shortly). They can not have themselves or their rules be enabled or disabled. Their status/data is never saved to user files.
361+
|__`user`__ | (default) this is a normal topic
362+
|__`noblocking`__ | should not perform any blocking tests on this topic in `:verify`
363+
|__`nopatterns`__ | should not perform any pattern tests on this topic in `:verify`
364+
|__`nosamples`__ | should not perform any sample tests on this topic in `:verify`
365+
|__`nokeys`__ | should not perform any keyword tests on this topic in `:verify`
366+
|__`more`__ | normally if you try to redeclare a concept, you get an error. `more` tells CS you intend to extend the concept and allows additional keywords.
367+
|__`bot=name`__ | if this is given, only named bots are allowed to use this topic. See [ChatScript Multiple Bots](ChatScript-Multiple-Bots.md) manual.
368368

369369

370370
## Rules that erase and repeat
@@ -1552,7 +1552,7 @@ early termination effects.
15521552
# System Functions
15531553

15541554
There are many system functions to perform specific tasks. These are enumerated in the
1555-
[ChatScript System Functions Manual](ChatScript-System-Functions-Manual.md) manual and the [ChatScript Fact Manual](ChatScript-Fact-Manual.md) manual.
1555+
[ChatScript System Functions Manual](ChatScript-System-Functions-Manual.md) and the [ChatScript Fact Manual](ChatScript-Fact-Manual.md).
15561556

15571557

15581558
## Randomized Output Revisited `[ ]`
@@ -1995,7 +1995,7 @@ $tmp = ##first
19951995

19961996
## Defining private Queries
19971997

1998-
see [ChatScript Fact Manual](ChatScript-Fact-Manual.md) manual.
1998+
see [ChatScript Fact Manual](ChatScript-Fact-Manual.md).
19991999

20002000

20012001
## Documenting variables, functions, factsets, and match variables
@@ -2211,7 +2211,7 @@ The user prompt wants to use the user's login name so it is a format string, whi
22112211
processed and stored on the user prompt variable. The botprompt wants to force a space
22122212
at the end, so it also uses a format string to store on the bot prompt variable.
22132213

2214-
### In color.tbl is there a reason that the color grey includes both building and ~building?
2214+
___In color.tbl is there a reason that the color grey includes both building and ~building?___
22152215

22162216
Yes. Rules often want to distinguish members of sets that have supplemental data from
22172217
ones that don't. The set of ~musician has extra table data, like what they did and doesn't
@@ -2221,7 +2221,7 @@ has supplemental data available.
22212221
This is made clearer when the set is named something list `~xxxlist`.
22222222
But the system evolved and is not consistent.
22232223

2224-
### How are double-quoted strings handled?
2224+
___How are double-quoted strings handled?___
22252225

22262226
First, note that you are not allowed strings that end in punctuation followed by a space.
22272227
This string _"I love you. "_ is illegal. There is no function adding that space serves.
@@ -2262,7 +2262,7 @@ spacing and punctuation, and stripping off the double quotes.
22622262
u: (test) ^"This $var is good." # if $var is kid the result is This kid is good.
22632263
```
22642264

2265-
### What really happens on the output side of a rule?
2265+
___What really happens on the output side of a rule?___
22662266

22672267
Well, really, the system "evaluates" every token. Simple English words and punctuation
22682268
always evaluate to themselves, and the results go into the output stream. Similarly, the
@@ -2303,7 +2303,7 @@ value.
23032303
Calling a function discards any output stream generated and aside from other side
23042304
effects means did the function fail (return a fail code) or not.
23052305

2306-
### How does the system tell a function call w/o ^ from English ?
2306+
___How does the system tell a function call w/o ^ from English?___
23072307

23082308
If like is defined as an output macro and if you write:
23092309
```
@@ -2319,7 +2319,7 @@ When it is a user function, it looks to see if the
23192319
Contiguous is treated as a function call and apart is treated as English.
23202320
This is not done for built-ins because it's more likely you spaced it accidently than that you intended it to be English.
23212321

2322-
### How should I go about creating a responder?
2322+
___How should I go about creating a responder?___
23232323

23242324
First you have to decide the topic it is in and insure the topic has appropriate keywords if
23252325
needed.
@@ -2330,7 +2330,7 @@ sentence. This will tell you how the system will tokenize it and what concepts i
23302330
trigger. This will help you decide what the structure of the pattern should be and how
23312331
general you can make important keywords.
23322332

2333-
### What really happens with rule erasure?
2333+
___What really happens with rule erasure?___
23342334

23352335
The system's default behavior is to erase rules that put output into the output stream, so
23362336
they won't repeat themselves later. You can explicitly make a rule erase with `^erase()` and
@@ -2347,12 +2347,11 @@ These can never erase themselves directly, so the erasure will again rebound to
23472347

23482348
Note that a topic declared system NEVER erases its rules, neither gambits nor responders,
23492349
even if you put ^erase() on a rule.
2350-
2351-
> How can I get the original input when I have a pattern like
23522350
```
23532351
u: (~emogoodbye)
23542352
```
2355-
### How can I get the original input when I have a pattern like `u: (~emogoodbye)` ?
2353+
2354+
___How can I get the original input when I have a pattern like `u: (~emogoodbye)` ?___
23562355

23572356
To get the original input, you need to do the following:
23582357
```
@@ -2562,8 +2561,7 @@ does a "cd ChatScript" to be in the right directory, and then runs ChatScript wi
25622561
following parameters:
25632562

25642563
```
2565-
ChatScript livedata=../LIVEDATA english=LIVEDATA/ENGLISH
2566-
system=LIVEDATA/SYSTEM
2564+
ChatScript livedata=../LIVEDATA english=LIVEDATA/ENGLISH system=LIVEDATA/SYSTEM
25672565
```
25682566

25692567
Normally while you might override various substitutes files, you would not override the
@@ -2592,6 +2590,3 @@ them when you run CS.
25922590

25932591
[[Wiki home](/WIKI/README.md)] - [[Basic User Manual](ChatScript-Basic-User-Manual.md)]
25942592

2595-
---
2596-
2597-
© Bruce Wilcox, mail: gowilcox@gmail.com web: www.brilligunderstanding.com revision: 12/7/2016 cs6.91

0 commit comments

Comments
 (0)