Matrix Games Forums

Forums  Register  Login  Photo Gallery  Member List  Search  Calendars  FAQ 

My Profile  Inbox  Address Book  My Subscription  My Forums  Log Out

RE: AGElint: AGEWiki docs vs. actual usage

 
View related threads: (in this forum | in all forums)

Logged in as: Guest
Users viewing this topic: none
  Printable Version
All Forums >> [Current Games From Matrix.] >> [World War I] >> Revolution Under Siege Gold >> Mods and Scenarios >> RE: AGElint: AGEWiki docs vs. actual usage Page: <<   < prev  3 4 [5] 6 7   next >   >>
Login
Message << Older Topic   Newer Topic >>
RE: AGElint: AGEWiki docs vs. actual usage - 1/8/2012 5:50:11 PM   
Chilperic


Posts: 964
Joined: 3/21/2010
Status: offline
BTW what means this:

sh: line 1: 8028 Segmentation fault (core dumped) /cygdrive/c/cygwin/home/Laurent/Games/AGEOD/agelint/agelint +la -g acw "GameData/Models/118USA_Gunboat.mdl" 2> /dev/null


I've a great fun with Memphis, TN .Will fix that.

_____________________________


(in reply to Chilperic)
Post #: 121
AGElint: excludes.???.dat - 1/8/2012 6:40:51 PM   
berto


Posts: 20708
Joined: 3/13/2002
From: metro Chicago, Illinois, USA
Status: offline

AGElint: excludes.???.dat

For all of the AGElint Perl *.pl scripts, you can exclude files from consideration by means of the excludes.???.dat "blacklist" mechanism.

There are six excludes files:

excludes.acw.dat
excludes.ncp.dat
excludes.pon.dat
excludes.rop.dat
excludes.rus.dat
excludes.wia.dat

For example, here is the excludes.rus.dat file:



# rus excludes
(Test|Parse|Samples|CzechLegion)
Scripts/Script.ini
Events/2-CzechLegion1918.sct
Events/2-CzechLegion1918Demo.sct
Events/AigarPolishrussowar.sct
Events/POLAIrpwar.sct
Events/RegistrySamples.sct



The second line is a pattern match. Any file name in part matching any of the strings in the pattern match are bypassed, excluded from the analysis.

So, in the example, all of the following files would be skipped:

Events/2-CzechLegion1918Demo.sct
Events/2-CzechLegion1918.sct
...
Includes/SubfactionsCzechLegion18.inc
Scripts/ScriptCzechLegion.ini



The third line and all following specify exact file names that should be skipped. (In the example, there is really no need to list the two CzechLegion1918 cases, since they would be excluded by the previous pattern match; i.e., listing them is redundant.)

You can exclude entire file categories with the appropriate pattern match. For example, to exclude all Models and Units file from the analysis, your excludes.rus.dat pattern match would look something like



(Test|Parse|Samples|CzechLegion|Models|Units)



You could exclude the entire GameData folder with



(Test|Parse|Samples|CzechLegion|GameData)



and focus just on Events files with



(Test|Parse|Samples|CzechLegion|GameData|Aliases|Includes|Scripts)



(It is not necessary to list thing like Fonts, FrontEnd, Graphics, etc., since AGElint at present doesn't consider them anyway.)

In future, we might add an includes.???.dat file, to "whitelist" files.

For the technically inclined, here is the Perl code we use to achieve the file excludes. First, excludes.pl (called in chklint.pl for example by means of the statement 'require "excludes.pl";')



# excludes.pl - AGElint chk*.pl excludes routines                               

open(EXCLUDES, "$EXCLUDES");
while(<EXCLUDES>) {
    chomp;
    next if (/^\s*#/);
    $thing = $_;
    print "$thing\n" if $DEBUG;
    if ($thing =~ /^\(.+\)$/) {
        $EXCLPAT = $thing;
    } else {
        $excludes{"./$thing"}++;
    }
}
close(EXCLUDES);

...

1;  # required!


And in, for example, chklint.pl we achieve the bypasses with



    if ($excludes{$file}) {
        print "skipping $file\n" if $DEBUG;
        next;
    }

    if ($EXCLPAT && ($file =~ /($EXCLPAT)/)) {
        print "skipping $file\n" if $DEBUG;
        next;
    }



< Message edited by berto -- 1/8/2012 7:02:28 PM >


_____________________________

Campaign Series Legion https://cslegion.com/
Campaign Series Lead Coder https://www.matrixgames.com/forums/tt.asp?forumid=1515
Panzer Campaigns, Panzer Battles, Civil War Battles Lead Coder https://wargameds.com

(in reply to Chilperic)
Post #: 122
RE: AGElint: excludes.???.dat - 1/8/2012 7:14:22 PM   
Chilperic


Posts: 964
Joined: 3/21/2010
Status: offline
Thanks. It will help a lot.

_____________________________


(in reply to berto)
Post #: 123
AGElint: reformatting report output - 1/8/2012 7:35:15 PM   
berto


Posts: 20708
Joined: 3/13/2002
From: metro Chicago, Illinois, USA
Status: offline

Don't forget

reformatting chkaliases.pl output [post #56]

where I discuss various ways of reformatting report output.

I would recommend using the supplied dochk program, but I'm not sure how well the AGElint 1.00 version will work for you. I am in the process of revising dochk to use agelint.conf (and debugging the appearance of ' and spaces in file names ). When AGElint v1.10+ is released, be sure to consider dochk for all of your comprehensive bug checks.

< Message edited by berto -- 1/8/2012 8:58:31 PM >


_____________________________

Campaign Series Legion https://cslegion.com/
Campaign Series Lead Coder https://www.matrixgames.com/forums/tt.asp?forumid=1515
Panzer Campaigns, Panzer Battles, Civil War Battles Lead Coder https://wargameds.com

(in reply to Chilperic)
Post #: 124
RE: AGElint: reformatting report output - 1/8/2012 8:58:16 PM   
berto


Posts: 20708
Joined: 3/13/2002
From: metro Chicago, Illinois, USA
Status: offline

Here's a trick:

Try running agelint against a buggy file. If you see false positives on lines 15, 244, 532 & 1278, try rerunning the agelint command like, for example:



./agelint -n +w +e +c5 +u +x -S 15 244 532 1278 -g rus "Events/7-Drang1921.sct"



The -S option will squelch error reports for the specified lines.

And, since you can recall previous commands with cursor-up key presses (cursor-up and cursor-down to review and recall any earlier/later Linux/Cygwin commands), you can continue recalling earlier agelint commands, adding and subtracting line #s to your heart's content.

I will have much more to say about this, and how it factors into the AGElint 'make check' regression tests, soon -- probably by tomorrow morning.

Here's another hint: Look at the file squelches.chk.pl.

There's probably lots more you still don't know about AGElint!

< Message edited by berto -- 1/8/2012 9:02:40 PM >


_____________________________

Campaign Series Legion https://cslegion.com/
Campaign Series Lead Coder https://www.matrixgames.com/forums/tt.asp?forumid=1515
Panzer Campaigns, Panzer Battles, Civil War Battles Lead Coder https://wargameds.com

(in reply to berto)
Post #: 125
RE: AGElint: reformatting report output - 1/8/2012 9:05:23 PM   
Chilperic


Posts: 964
Joined: 3/21/2010
Status: offline
Thanks again

_____________________________


(in reply to berto)
Post #: 126
AGElint: more on false positives - 1/9/2012 11:05:49 AM   
berto


Posts: 20708
Joined: 3/13/2002
From: metro Chicago, Illinois, USA
Status: offline

more on false positives

This is an important post, so listen up!

Here is a typical chklint error report:



ERROR: in Events/3-November1918.sct, at (or near) line 1951: syntax error: #M# (0x4d), #MinDate#

in event evt_nam_Renforts_RED_AmurPartisanArmy:

1942 SetType = $uni_RED_Sup1
1943 SUFlavorName = 1st Co.|2nd Co.|3rd Co.|4th Co.
1944 SetName = Partisans Supply
1945 Apply
1946
1947 EndEvent
1948
1949 SelectFaction = $RED
1950 StartEvent = evt_nam_Renforts_RED_AmurPartisanArmy|1|1|NULL|NULL|NULL|NULL
1951> MinDate = 1919/01/01
1952 MaxDate = 1919/12/01
1953 Probability = 20
1954
1955 Actions
1956
1957 SelectFaction = $REd
1958 SelectFaction = $REd
1959 AddToRegList = $Mukhen
1960



False positive, right?

Not so fast!

Do you see the problem? If so, good for you! If not, it is: There is no 'Conditions' statement. After 'StartEvent ...', it goes immediately to listing conditions.

You may or may not think that's a real problem, but that's not the point. The point is that the



ERROR: in Events/3-November1918.sct, at (or near) line 1951: syntax error: #M# (0x4d), #MinDate#

...

1951> MinDate = 1919/01/01



are misleading. You see the 'MinDate = 1919/01/01', and you think: "What's the problem? There is none. False positive!"

Except that (if you agree with the analysis), no, it's a real error. But the chklint error statement not only misdiagnoses the problem -- "syntax error" -- it also (sometimes) gets the "offending" line number wrong! (Truly it is a syntax error. But just looking at the line 1951 but not at the surrounding context, you fail to see it.)

In my defense, I do state "at (or near) line ..." But that's easily overlooked. It's natural for you to focus just on the reported line number and ignore the surrounding context.

As written, I have removed most of the genericalness from the txt.y parser. In preparation for AGElint v1.10's release, I have begun vetting all (or almost all) reported errors in RUS 1.04 (and some of the other AGEOD games). Soon, I came across this example, and realized (again):

"Houston, we have a problem."

In the AGElint to-do list, I have written:

  • ...
  • Better pinpoint the exact line number of reported error.
  • Improve parser 'error' recovery, for detecting all errors etc. in a given data file.
  • ...

These are issues that, in my haste to get a functional AGElint, I had swept under the rug. Folks, there's a lot under that rug!

I am now confronting this issue straight on. I need to focus on the above two to-dos, and add another:

  • Better describe errors (and not so readily default to the generic, often uninformative "syntax error").

In part, this will require better implementation of the yacc 'error' statement, which deals with parser error recovery.

Let me explain. When the parser encounters an error, when the input violates the syntax rules, the parser gets confused (hopefully just momentarily). It reports an error, and ideally moves on to the next. But sometimes it gets so confused, it is so lost, that it just gives up -- on the entire file. At other times, it remains on the case, continues checking for errors, but glosses over one or more close-by errors until it can reorient itself properly, and resume normal error (warning etc.) checking. Usually, the parser gets it right -- stays with a file, and detects all errors. But in unusual circumstances, it gets it quite wrong.

This is why you can't get to the point of seeing just one last chklint-reported error, fix that error, then move on to the next file. No, it is important that you keep running agelint until, ideally, it reports zero errors. (Possibly with aid of the squelch mechanism, mentioned several posts above, and to be described in greater detail here soon.) The one error might be "masking" the presence of subsequent errors. If you remove the mask (fix the error), it might reveal other follow-on errors. So (ideally) keep looking for errors until you no longer find any.

Another thing I need to do is to have fewer "syntax error:" and more "warning:" and/or use more 'txterrmsg(_ERROR, ..., <explicit error message> ...)' function calls.

I have written that AGElint is "unfinished", "imperfect", a "work-in-progress", etc. I have also written many times about the issue of false positives. If you are frustrated by the problem of false positives, well, so am I! I pledge to keep working hard at this until I Get It Right.

Thank you for your patience!

< Message edited by berto -- 1/9/2012 9:45:52 PM >


_____________________________

Campaign Series Legion https://cslegion.com/
Campaign Series Lead Coder https://www.matrixgames.com/forums/tt.asp?forumid=1515
Panzer Campaigns, Panzer Battles, Civil War Battles Lead Coder https://wargameds.com

(in reply to Chilperic)
Post #: 127
RE: AGElint: more on false positives - 1/9/2012 12:06:33 PM   
berto


Posts: 20708
Joined: 3/13/2002
From: metro Chicago, Illinois, USA
Status: offline

More on the txt.y parser getting "confused":

Imagine you are learning a foreign language, Chinese say. You are listening to a Chinese speaker. He/she says a word or uses an expression or grammatical construct that you are unfamiliar with, else makes a real mistake, doesn't really matter. The point is that you are momentarily confused, you stop listening to the flow of words while you ponder the mistake (yours, or the speaker's). While you gather your thoughts, you might miss other things (unfamiliar stuff, speaker errors, ...). Sooner or later, you figure it out (or not), and you resume listening intently. (Or not.)

The parser interpreting the input stream: it's kind of like that.

Getting confused while listening to a spoken foreign language is part of the human condition. Similarly, the txt.y parser sometimes getting confused by the input stream is inherent to the (yacc) parsing technology.

We can try to minimize the problem, but we can't universally solve it.

One more reason why there will probably always be false positives and imperfectly precise error reports. Can't help it!

_____________________________

Campaign Series Legion https://cslegion.com/
Campaign Series Lead Coder https://www.matrixgames.com/forums/tt.asp?forumid=1515
Panzer Campaigns, Panzer Battles, Civil War Battles Lead Coder https://wargameds.com

(in reply to berto)
Post #: 128
RE: AGElint: more on false positives - 1/9/2012 12:23:31 PM   
berto


Posts: 20708
Joined: 3/13/2002
From: metro Chicago, Illinois, USA
Status: offline

Still more:

If you are a C (or Java or Perl or ...) programmer, you see this parser "confusion" effect if, for instance, you omit a required ; or } or some other "little" thing.

Then, when the program compiles (or runs), you see a spew of compiler errors filling your monitor screen. And maybe not also errors due to later-on coding mistakes.

You go back and fix the "little" mistake, and the thing then compiles cleanly (or reveals the earlier masked errors).

So you see, even the best of the C (and Java and Perl and ...) compilers can get confused. Again, it's an inherent limitation to the available parsing technology. Parser confusion -- can't help it!

_____________________________

Campaign Series Legion https://cslegion.com/
Campaign Series Lead Coder https://www.matrixgames.com/forums/tt.asp?forumid=1515
Panzer Campaigns, Panzer Battles, Civil War Battles Lead Coder https://wargameds.com

(in reply to berto)
Post #: 129
RE: AGElint: more on false positives - 1/9/2012 1:27:33 PM   
Chilperic


Posts: 964
Joined: 3/21/2010
Status: offline
When I can't discern first either a false positive or a real bug, I leave as is and reports nothing. A second look a few hours later has given sometimes better results. I've rrun agelint on FY several times too and I plan to do a new inspection on FY with the new version.

Once again, the number of false positive isn't that large and not even an hindrance. After all, once identified as a false positive, it is just a part of the agelint report to bin. The real bugs are anyway found and fixed in a few days rather than a few months ( I'm not kidding).


Missing Condition string is a not uncommon error indeed. Found occurence in AACW.Fixed in SVF


< Message edited by Chliperic -- 1/9/2012 2:51:25 PM >


_____________________________


(in reply to berto)
Post #: 130
AGElint: squelches & ignores - 1/9/2012 8:50:34 PM   
berto


Posts: 20708
Joined: 3/13/2002
From: metro Chicago, Illinois, USA
Status: offline

AGElint: squelches & ignores

Try running agelint against a buggy file. If you see false positives on lines 15, 244, 532 & 1278, try rerunning the agelint command like, for example:



./agelint -n +w +e +c5 +u +x -S 15 244 532 1278 -g rus "Events/7-Drang1921.sct"



The -S option will squelch error reports for the specified lines.

And, since you can recall previous commands with cursor-up key presses -- cursor-up and cursor-down to review and recall any earlier/later Linux/Cygwin commands; use the standard cursor-left, cursor-right, delete, etc. to edit earlier commands) -- you can continue recalling earlier agelint commands, adding and subtracting line #s to your heart's content.

We use this error (and warning & notice) squelch mechanism in the AGElint 'make check' regression test. In the AGElint Makefile, it says:



check:
./chklint.pl -n +w +e -v -s +u +x +q +c5 -S -g chk 2>&1 | tee ./chklint.chk.out



If you try that command adding the +G debuG option (and piping to 'less' for on-screen display)



./chklint.pl -n +w +e -v -s +u +x +q +c5 +G -S -g chk 2>&1 | less



you will see the -S Squelch mechanism in action:



...

Aliases/uni_Alias.ini
/home/berto/games/ageod/agelint/agelint -n +w +e -v -s +c5 +u +x +q -X -L -S 24 163 400 662 917 -g chk "Aliases/uni_Alias.ini" |


GameData/Research/104-RI_Modern_agricultural_techniques.res
/home/berto/games/ageod/agelint/agelint -n +w +e -v -s +c5 +u +x +q -X -L -S 12 19 25 31 -g chk "GameData/Research/104-RI_Modern_agricultural_techniques.res" |

...



In the CHK/Aliases/uni_Alias.ini file (where CHK is a pseudo install, within the agelintroot folder, for 'make check' regression tests), you will see deliberately buggy lines 24, 163, 400, 662 & 917. Likewise for lines 12, 19, 25 & 31 in the CHK/GameData/Research/104-RI_Modern_agricultural_techniques.res file.

Where do those line #s come from? From the squelches.chk.pl file, shown in part here:



...

# Aliases
$squelches{"Aliases/uni_Alias.ini"} .= "24 ";
$squelches{"Aliases/uni_Alias.ini"} .= "163 ";
$squelches{"Aliases/uni_Alias.ini"} .= "400 ";
$squelches{"Aliases/uni_Alias.ini"} .= "662 ";
$squelches{"Aliases/uni_Alias.ini"} .= "917 ";

...

# Research
$squelches{"GameData/Research/104-RI_Modern_agricultural_techniques.res"} .= "12 ";
$squelches{"GameData/Research/104-RI_Modern_agricultural_techniques.res"} .= "19 ";
$squelches{"GameData/Research/104-RI_Modern_agricultural_techniques.res"} .= "25 ";
$squelches{"GameData/Research/104-RI_Modern_agricultural_techniques.res"} .= "31 ";

...



Whenever chklint.pl runs with the -S Squelch option, it looks for a squelches.???.pl file in the agelintroot directory, where ??? matches the game specified in the -g option.

So, for example, if you were to run the command



./chklint.pl -n +w +e -v -s +u +x +q +c5 -S -g rus 2>&1 | tee ./chklint.rus.out



chklint.pl would look for the file (in agelintroot) squelches.rus.pl, which is currently empty:



# RUS 1.04



1; # required!



It is up for you to add squelch entries in that (and the other game squelches.???.pl files) as you wish.

If you run agelint with the +q (as in '+|-q show/don't show squelches') option, for example



[root@telemann agelint]# ./agelint -n +w +e -v -s +u +x +q +c5 -g chk "Aliases/uni_Alias.ini" 2>&1 | less



you will see something like



ERROR: in ./CHK/Aliases/uni_Alias.ini, at (or near) line 24: syntax error: #$# (0x24), #$uni_RED_Div23#

19 $uni_RED_Div18 = 18
20 $uni_RED_Div19 = 19
21 $uni_RED_Div20 = 20
22 $uni_RED_Div21 = 21
23 $uni_RED_Div22 22
24> $uni_RED_Div23 = 23
25 $uni_RED_Div24 = 24
26 $uni_RED_Div25 = 25
27 $uni_RED_Div26 = 26
28 $uni_RED_Div27 = 27
29 $uni_RED_Div28 = 28

$squelches{"Aliases/uni_Alias.ini"} .= "24 ";


ERROR: in ./CHK/Aliases/uni_Alias.ini, at (or near) line 163: syntax error: #u# (0x75), #uni_RED_VOKhR2#

158 $uni_RED_MilAG = 157
159 $uni_RED_Cav21 = 158
160 $uni_RED_Reb = 159
161 $uni_RED_Tck = 160
162 $uni_RED_VOKhR1 = 161
163> uni_RED_VOKhR2 = 162
164 $uni_RED_Sla = 163
165 $uni_RED_Ins1 = 164
166 $uni_RED_Str1 = 165
167 $uni_RED_Wsu = 166
168 $uni_RED_Mer = 167

$squelches{"Aliases/uni_Alias.ini"} .= "163 ";


...



NOTE: For chklint.pl, you use the -S without line #s. For agelint, you use the -S with line #s.

The agelint +q (show squelches) option displays lines like



$squelches{"Aliases/uni_Alias.ini"} .= "24 ";



for each offending error (or warning or notice) line. You can cut-and-paste these ready-made squelch lines into your customized squelches.???.pl files.

"Hey, this is handy. Why don't I create a customized squelches.rus.pl file stuffed with all those pesky false positives?" you may be thinking to yourself. Be careful! If you add or delete lines from that file, you will offset the numbers in squelches.rus.pl, rendering many or all squelch line #s useless.

That is why agelint doesn't invoke any of the squelches.???.pl files. Only chklint.pl does that. And so far, only the 'make check', which calls chklint.pl on an invariant (to you) squelches.chk.pl file with unchanging line #s.

So, begin populating your customized squelches.???.pl files, and use them with chklint.pl, but use at your own risk!

In addition to the agelint (and chklint.pl) squelch mechanism, there is also the ignore mechanism.

Try editing the file ./agelintroot/CHK/GameData/Religions/8-Protestant.rel, adding a 'Q' before 'UID' in the first line like so:



QUID = 8
Name = Protestant
Alias = relProtestant
Color = colLavenderBlush3



Then run a standard agelint command against that file:



[root@telemann agelint]# ./agelint -n +w +e -v -s +u +x +q +c5 -g chk "GameData/Religions/8-Protestant.rel" 2>&1

ERROR: in ./CHK/GameData/Religions/8-Protestant.rel, at (or near) line 1: syntax error: #=# (0x3d), #=#

1> QUID = 8
2 Name = Protestant
3 Alias = relProtestant
4 Color = colLavenderBlush3

$squelches{"GameData/Religions/8-Protestant.rel"} .= "1 ";



As expected, agelint complains about the unknown 'QUID' in line #1.

Try squelching that error by adding '-S 1' to the command line:



[root@telemann agelint]# ./agelint -n +w +e -v -s +u +x +q +c5 -S 1 -g chk "GameData/Religions/8-Protestant.rel" 2>&1



No error reported. Great, the '-S 1' is working as expected.

Now, instead try ignoring the first line by adding '-I 1' to the command line:



[root@telemann agelint]# ./agelint -n +w +e -v -s +u +x +q +c5 -I 1 -g chk "GameData/Religions/8-Protestant.rel" 2>&1

ERROR: in ./CHK/GameData/Religions/8-Protestant.rel, at (or near) line 2: syntax error: #N# (0x4e), #Name#

1 QUID = 8
2> Name = Protestant
3 Alias = relProtestant
4 Color = colLavenderBlush3

$squelches{"GameData/Religions/8-Protestant.rel"} .= "2 ";



Hmm, what's going on here?

In this case, the '-I 1' says to ignore the first line as if it doesn't exist. The agelint parser simply ignores it entirely. A consequence of that is this Religions file appears to lack the required opening 'UID =' line, which is certainly an error. When the parser sees



2> Name = Protestant



as if it were the very first actual data line (it's ignoring the first line, remember?), the parser "thinks": "Where is the opening 'UID ='? Error!"

If this is all unclear to you, you might try experimenting with the '-S <#s>' squelch option vs. the '-I <#s>' ignore option to gain a better understanding of their differences.

Note that you can just as easily combine '-S' with '-I' in the same agelint command line, as in:



[root@telemann agelint]# ./agelint -n +w +e -v -s +u +x +q +c5 -S 1 -I 4 -g chk "GameData/Religions/8-Protestant.rel" 2>&1



That tells agelint to squelch the report of error in line #1, and totally ignore line #4 (which is also erroneous, since 'Color =' requires an alias parameter; note the missing '$' before 'colLavenderBlush3').

NOTE: You may use -S (without line #s) with chklint.pl, but for that program -I is not a valid option. That is, you may squelch and/or ignore with agelint, but with chklint.pl you may only squelch. (There are also no ignores.???.pl files corresponding to the squelches.???.pl files. That is WAD.)

This may all seem a bit confusing, but play around. Usually squelches are appropriate, but maybe ignores will sometimes suit your purpose. Experiment!

(If you edited the ./agelintroot/CHK/GameData/Religions/8-Protestant.rel to add a 'Q' before 'UID' in the first line, you should undo that edit now. Unless you want to experiment some more.)

< Message edited by berto -- 1/9/2012 9:03:58 PM >


_____________________________

Campaign Series Legion https://cslegion.com/
Campaign Series Lead Coder https://www.matrixgames.com/forums/tt.asp?forumid=1515
Panzer Campaigns, Panzer Battles, Civil War Battles Lead Coder https://wargameds.com

(in reply to Chilperic)
Post #: 131
RE: AGElint: squelches & ignores - 1/9/2012 11:05:28 PM   
Chilperic


Posts: 964
Joined: 3/21/2010
Status: offline
To let aside the question of false positive, should it be possible to check event names? As I use a lot of long chains of events ( until 40, rarely of course ), one of the most frequent error is a mispelling in the event name when used in the EvalEvent condition. This could be a tremendous addition, even for options giving +5 infantry replacements for 3 EPs, which are simpler but sometimes bugged

_____________________________


(in reply to berto)
Post #: 132
RE: AGElint: squelches & ignores - 1/9/2012 11:37:34 PM   
berto


Posts: 20708
Joined: 3/13/2002
From: metro Chicago, Illinois, USA
Status: offline

Sure. That's planned. But probably not for the very next AGElint v1.10 (due out later this week).

_____________________________

Campaign Series Legion https://cslegion.com/
Campaign Series Lead Coder https://www.matrixgames.com/forums/tt.asp?forumid=1515
Panzer Campaigns, Panzer Battles, Civil War Battles Lead Coder https://wargameds.com

(in reply to Chilperic)
Post #: 133
actions in Conditions: errors or false positives? - 1/10/2012 10:21:28 AM   
berto


Posts: 20708
Joined: 3/13/2002
From: metro Chicago, Illinois, USA
Status: offline

Consider this example:



ERROR: in Events/3-November1918.sct, at (or near) line 6565: syntax error: #A# (0x41), #AlterCuSubUnit#

in event evt_nam_Renforts_CMN_JapaneseIntervention2:

6556 SelectRegion = $Verkhneudinsk
6557 StartEvent = evt_nam_Renforts_CMN_JapaneseIntervention2|1|1|NULL|NULL|$Verkhneudinsk|NULL
6558
6559 Conditions
6560 MinDate = 1918/11/01
6561 Probability = 10
6562
6563 SelectFaction = $RED
6564 SelectSubUnits = Area $EventArea_JapaneseIntervention2;FactionTags RED
6565> AlterCuSubUnit = ApplytoList;Move $Shilka
6566
6567 Actions^M
6568 DescEvent = evt_desc_Renforts_CMN_JapaneseIntervention2
6569
6570 SelectFaction = $WH3
6571 SelectRegion = $Verkhneudinsk
6572
6573 SelectFaction = $WH3
6574 SelectRegion = $Verkhneudinsk



There is nothing wrong with the AlterCuSubUnit statement in isolation. But looking at the surrounding context, agelint says "syntax error", because the AlterCuSubUnit statement is in Conditions, not in Actions.

A false positive?

There are not a few cases like this: where an action statement (and therefore not a logical test) is found to be in Conditions. Are these genuine errors?

< Message edited by berto -- 1/10/2012 11:56:31 AM >


_____________________________

Campaign Series Legion https://cslegion.com/
Campaign Series Lead Coder https://www.matrixgames.com/forums/tt.asp?forumid=1515
Panzer Campaigns, Panzer Battles, Civil War Battles Lead Coder https://wargameds.com

(in reply to berto)
Post #: 134
RE: actions in Conditions: errors or false positives? - 1/10/2012 11:45:25 AM   
berto


Posts: 20708
Joined: 3/13/2002
From: metro Chicago, Illinois, USA
Status: offline

Action statements appearing in the Conditions section -- one way to handle this "problem" (?) is by giving warnings:



cond:             conditions { txterrmsg(_ERROR, FALSE, lineno, "duplicate Conditions statement"); }

                | actordisabled
                | actorenabled
...
                | selunqunit
                | turnindex

		| altercusubunit { txterrmsg(_WARNING, TRUE, linenorhs, "suspicious, unusual use of %s in Conditions section", "AlterCuSubUnit"); }
...

                ;


And similarly for condition statements appearing in the Actions section:



act:              actions { txterrmsg(_ERROR, FALSE, lineno, "duplicate Actions statement"); }

                | absorbfaction
                | addnationalregions
...
		| winparams
                | winparamsvp

                | probability { txterrmsg(_WARNING, TRUE, linenorhs, "suspicious, unusual use of %s in Actions section", "Probability"); }
...

                ;


By giving explicit warning messages, we avoid the more generic, and possibly confusing, "syntax error" messages.

Chliperic, I genuinely, really, truly appreciate your open-mindedness, cooperativeness, and patience. And your feedback.

As with most things in life, you get one chance to make your impression. With many people, you don't get a second chance.

As I develop AGElint and promote its use, I try to understand the, at best, indifference and, at worst, hostility it sometimes engenders.

I suspect that some people are looking for excuses to write me off, seizing for example the issue of false positives to disparage AGElint. They see false positives, and think: "Berto is a doofus. He doesn't know what he's doing. AGElint sucks." I think: "No, I know what I'm doing, in large part. I just need to do a better job of clarifying the AGElint error/warning statements [among other refinements, improvements, and bug fixes]."

That's what I suspect, anyway.

But thanks again, Chliperic, for your help in working through these difficult, thorny issues. I am grateful for it. Together, and as a community, we debug and fix and mod and build better games.

< Message edited by berto -- 1/10/2012 2:19:15 PM >


_____________________________

Campaign Series Legion https://cslegion.com/
Campaign Series Lead Coder https://www.matrixgames.com/forums/tt.asp?forumid=1515
Panzer Campaigns, Panzer Battles, Civil War Battles Lead Coder https://wargameds.com

(in reply to berto)
Post #: 135
RE: AGElint: more on false positives - 1/10/2012 3:23:04 PM   
berto


Posts: 20708
Joined: 3/13/2002
From: metro Chicago, Illinois, USA
Status: offline

quote:

ORIGINAL: berto

Still more:

If you are a C (or Java or Perl or ...) programmer, you see this parser "confusion" effect if, for instance, you omit a required ; or } or some other "little" thing.

Then, when the program compiles (or runs), you see a spew of compiler errors filling your monitor screen. And maybe not also errors due to later-on coding mistakes.

You go back and fix the "little" mistake, and the thing then compiles cleanly (or reveals the earlier masked errors).

So you see, even the best of the C (and Java and Perl and ...) compilers can get confused. Again, it's an inherent limitation to the available parsing technology. Parser confusion -- can't help it!

Returning to the C etc. example...

When a C compiler chokes on a coder syntax error, it (a) usually spews forth lots of (b) often cryptic, misleading error messages.

The Perl compiler is no different. The AGElint chkaliases.pl Perl script begins (more or less) like so:



#!/usr/bin/perl                                                                 

require "common.pl";

# register all localisations in the %locals hash                                
open(LOCALS, "cd \"$GAMEDIR\"; find -name \\*.csv -exec cut --delimiter=\\; -f 1 {} \\; | egrep -v \"^//\" | egrep \"[a-zA-Z]\" | sort | uniq |");
while (<LOCALS>) {
    chomp;
    $local = $_;
    print "LOC1 #$local#\n" if $DEBUG;
    if ($local =~ /^\s*(\S.+\S)\s*$/) {  # strip leading/trailing whitespace    
        $local = $1;
        print "LOC2 #$local#\n" if $DEBUG;
        # now convert to all lower case                                         
        $local = lc($local);
        print "LOC3 #$local#\n" if $DEBUG;
        $locals{$local}++;
    }
}
close(LOCALS);


If you remove the ; semi-colon at the end of the 'open(LOCALS, ...)' line, line 6



open(LOCALS, "cd \"$GAMEDIR\"; find -name \\*.csv -exec cut --delimiter=\\; -f 1 {} \\; | egrep -v \"^//\" | egrep \"[a-zA-Z]\" | sort | uniq |")


then run the script, you will see something like this:



[root@telemann agelint]# ./chkaliases.pl +i +E -g rus
syntax error at ./chkaliases.pl line 7, near ") {"
syntax error at ./chkaliases.pl line 19, near "}"
Execution of ./chkaliases.pl aborted due to compilation errors.



Wait a minute! The Perl compiler reports errors at lines 7 & 19, and makes no mention of the missing ; semi-colon in line 6!

If you remove the very first line of agelint.h (shown here are the first four lines of that file):



/*                                                                              
   agelint.h -- AGElint common header file for all binaries                        
                                                                                
 */


then try to compile using 'make', you will see something like



gcc -O2 -Wall -Wshadow -Wconversion -Wpointer-arith -Wcast-qual -c agelint.c -o agelint.o
In file included from agelint.c:6:0:
agelint.h:2:11: error: expected ‘=’, ‘,’, ‘;’, ‘asm’ or ‘__attribute__’ before ‘.’ token
In file included from agelint.h:10:0,
                 from agelint.c:6:
/usr/include/sys/types.h:34:18: error: expected ‘=’, ‘,’, ‘;’, ‘asm’ or ‘__attribute__’ before ‘u_char’
agelint.c: In function ‘checkcfg’:
agelint.c: In function ‘init’:
agelint.c: In function ‘getroot’:
agelint.c: In function ‘date2days’:
make[1]: *** [agelint.o] Error 1
make[1]: Leaving directory `/home/berto/games/ageod/agelint'


No mention of the missing '/*' in line #1 in any of that gobbledygook!

So I don't feel so bad if my humble agelint parser obfuscates and misleads when reporting syntax errors. Compared to the mighty and exalted C and Perl compilers, it actually compares favorably.

Having said all that...

I have decided to generalize the solution in post #135 above: I will add all actions statements to the parser cond: (Conditions) section, but give txterrmsg() warnings; and add all conditions statements to the parser act: (Actions) section, and likewise give txterrmsg() warnings.

That should remove any 'syntax error ...' ambiguity. If you use an action statement in Conditions, or vice versa, agelint should report your mistake (with a warning) clearly and explicitly!

< Message edited by berto -- 1/10/2012 3:30:40 PM >


_____________________________

Campaign Series Legion https://cslegion.com/
Campaign Series Lead Coder https://www.matrixgames.com/forums/tt.asp?forumid=1515
Panzer Campaigns, Panzer Battles, Civil War Battles Lead Coder https://wargameds.com

(in reply to berto)
Post #: 136
RE: actions in Conditions: errors or false positives? - 1/10/2012 9:00:13 PM   
Chilperic


Posts: 964
Joined: 3/21/2010
Status: offline
quote:

ORIGINAL: berto


Action statements appearing in the Conditions section -- one way to handle this "problem" (?) is by giving warnings:



cond:             conditions { txterrmsg(_ERROR, FALSE, lineno, "duplicate Conditions statement"); }

                | actordisabled
                | actorenabled
...
                | selunqunit
                | turnindex

		| altercusubunit { txterrmsg(_WARNING, TRUE, linenorhs, "suspicious, unusual use of %s in Conditions section", "AlterCuSubUnit"); }
...

                ;


And similarly for condition statements appearing in the Actions section:



act:              actions { txterrmsg(_ERROR, FALSE, lineno, "duplicate Actions statement"); }

                | absorbfaction
                | addnationalregions
...
		| winparams
                | winparamsvp

                | probability { txterrmsg(_WARNING, TRUE, linenorhs, "suspicious, unusual use of %s in Actions section", "Probability"); }
...

                ;


By giving explicit warning messages, we avoid the more generic, and possibly confusing, "syntax error" messages.

Chliperic, I genuinely, really, truly appreciate your open-mindedness, cooperativeness, and patience. And your feedback.

As with most things in life, you get one chance to make your impression. With many people, you don't get a second chance.

As I develop AGElint and promote its use, I try to understand the, at best, indifference and, at worst, hostility it sometimes engenders.

I suspect that some people are looking for excuses to write me off, seizing for example the issue of false positives to disparage AGElint. They see false positives, and think: "Berto is a doofus. He doesn't know what he's doing. AGElint sucks." I think: "No, I know what I'm doing, in large part. I just need to do a better job of clarifying the AGElint error/warning statements [among other refinements, improvements, and bug fixes]."

That's what I suspect, anyway.



Let me tell you a story, as I've been in the modding field since ten years for several games. One dev of a game was a really gifted one. Unfortunately, he paired himself with a pure asshole, who was as much arrogant than unable to create something of value. he had some competences, which for the far-sighted seemed to be a proof of competence. Of course, he was always right. When he was wrong, he denied the reality, and if needed, modified on the spot offcial docs to hinder the error he made.He finally succeed to empty the communauty of his most dedicated members, and especially modders who were exchanging with the devs. He couldn't tolerate others could get a hand on the dev work. Uncompetence is often tied to vanity.He had always a reason to object, or at last he wanted to be the mandatory channel to authorize the idea.

I will not name this experience. Until I was bored with the engine, I just did my modding stuff a few more months, discovering even in the wargaming field, there are persons struggling for power against those trying to enhance things.

It's a lesson I will always keep in mind. Fatal Years is what can be done both for AI and historicity and I have dancing behind my eyes what will be SVF. I've so much fun to play FY I'm just hooked, and I know by the comments done I'm not the only one. In this year of hard work, I've got betatesters like I rarely saw, help by programer like you, suggestions by people speaking Russian and knwowing a bit the RCW, other having discovered this neglected period of history.

In one word, cheers to all. I'm happy. for those you mentionned, they will never know what freedom and openm ind may give as pleasure. They will live between wishful thinking, half-baked grandiose projects, and this constant necessity to deny their errors on scapegoats.

Let them. Build the games which are worth playing.


< Message edited by Chliperic -- 1/10/2012 9:05:26 PM >


_____________________________


(in reply to berto)
Post #: 137
RE: AGElint: more on false positives - 1/10/2012 10:39:12 PM   
berto


Posts: 20708
Joined: 3/13/2002
From: metro Chicago, Illinois, USA
Status: offline

quote:

ORIGINAL: berto

Another thing I need to do is to have fewer "syntax error:" and more "warning:" and/or use more 'txterrmsg(_ERROR, ..., <explicit error message> ...)' function calls.

Consider another seeming agelint false positive:



ERROR: in Events/ANMAI.sct, at (or near) line 644: syntax error: #E# (0x45), #EndEvent#

in event evt_nam_ANA_BreakAlliance_Tracker:

635 EvalRgnOwned = $Dobropole;NOT
636
637 Actions
638
639
640
641 SetControl = $Dobropole 5
642
643
644> EndEvent
645
646
647 SelectFaction = $ANM
648 StartEvent = evt_nam_AI_ANMlocalMC11|999|0|NULL|NULL|NULL|NULL
649
650 Conditions
651 EvalEvent = evt_nam_ANA_BreakAlliance_Tracker;=;1
652 CheckAILevel = 1
653 MinDate = 1919/01/01



You might think: "What's the problem? There is an Actions statement, and if you look in the actual Events/ANMAI.sct file, you see too that there are appropriate StartEvent and Conditions statements. Everything seems in order here. False positive!"

Except it's not a false positive, rather yet another misleading ERROR: line.

The problem is the missing ; field separator in the preceding statement



641 SetControl = $Dobropole 5



It should instead be



641 SetControl = $Dobropole;5



as the usage database shows



[root@telemann agelint]# ./kwddat SetControl
1 SetControl = $Achit;80
1 SetControl = $Chaikovskiy;80
1 SetControl = $Ertarskiy;80
1 SetControl = $Kamensk-Uralskiy;80
1 SetControl = $Kataysk;80
1 SetControl = $Krasnoufimsk;80
1 SetControl = $Kueda;80
1 SetControl = $Kungur;80
1 SetControl = $Miass;80
1 SetControl = $Ozersk;80
1 SetControl = $Redva;80
1 SetControl = $Shalya;80
1 SetControl = $Vassilevsko-Chaitanski;80
1 SetControl = $Vishnevogorsk;80
14 SetControl = 35
22 SetControl = 65
47 SetControl = 45
72 SetControl = 55
91 SetControl = 15
106 SetControl = 95
133 SetControl = 5
156 SetControl = 10
157 SetControl = 90
173 SetControl = 70
180 SetControl = 30
180 SetControl = 85
191 SetControl = 25
252 SetControl = 40
276 SetControl = 60
428 SetControl = 20
434 SetControl = 80
483 SetControl = 75
775 SetControl = 50
5487 SetControl = 0
112441 SetControl = 100



and as the AGEWiki page for the SetControl statement suggests. (But note: the AGEWiki is in error, because it stipulates | as the field separator; but again actual usage shows ; instead!)

In keeping with my vow to add clearer, more numerous explicit txterrmsg() errors and warnings, and reduce the frequency of ambiguous, misleading "syntax error" messages, I have modified the setcontrol parser rule to be:



setcontrol:       _SETCONTROL eq pct
                | _SETCONTROL eq alsval sc pct
                | _SETCONTROL eq alsval pct { txterrmsg(_ERROR, TRUE, linenorhs, "missing ; field separator"); }
                | _SETCONTROL eq alsval { txterrmsg(_ERROR, TRUE, linenorhs, "missing ; field separator, else missing value"); }
                {
                /*
                http://www.ageod.net/agewiki/SetControl
                Syntax:  SetControl = [RegionUID;]Value
                */
                }
                ;


Why the two different error cases? It's because AGE aliases can contain spaces (<sigh> ), so the txt.l lexer might view the '$Dobropole 5' as an alsval alone, not an alsval pct.

Do you begin (or continue) to see how difficult this all is, how much detailed attention, care, patience, skill and even artistry is necessary to Do It Right?

With that change, and after recompiling agelint and running it against the Events/ANMAI.sct file, we now get:



ERROR: in Events/ANMAI.sct, at (or near) line 641: missing ; field separator, else missing value

632 CheckAILevel = 1
633 MinDate = 1919/01/01
634 MaxDate = 1923/01/01
635 EvalRgnOwned = $Dobropole;NOT
636
637 Actions
638
639
640
641> SetControl = $Dobropole 5
642
643
644 EndEvent
645
646
647 SelectFaction = $ANM
648 StartEvent = evt_nam_AI_ANMlocalMC11|999|0|NULL|NULL|NULL|NULL
649
650 Conditions



Error pinpointed at the offending SetControl statement, no more misdirection to the correct EndEvent statement, "false positive" eradicated, mission accomplished!

I have lots of work ahead of me. In every case where common AGE script and data file coding errors lead to ambiguous, contextual "syntax error" complaints, I will have to account for those errors with new txt.y parser cases with meaningful, informative txterrmsg(_ERROR, ...) calls like the above.

Adding all of that will take time. The next official AGElint release will be delayed, I'm sad to say.

In order to minimize the wait, I will likely -- as pledged -- focus on RUS, ACW & ROP -- and just ignore the other games for now. Work on the other games will follow in the weeks ahead.

The good news is that I have mainly finished the work of adding all actions statements to the parser cond: (Conditions) section, but give txterrmsg() warnings; and adding all conditions statements to the parser act: (Actions) section, and likewise give txterrmsg() warnings.

Thank you for your continuing patience and interest!

< Message edited by berto -- 1/10/2012 10:59:20 PM >


_____________________________

Campaign Series Legion https://cslegion.com/
Campaign Series Lead Coder https://www.matrixgames.com/forums/tt.asp?forumid=1515
Panzer Campaigns, Panzer Battles, Civil War Battles Lead Coder https://wargameds.com

(in reply to berto)
Post #: 138
RE: AGElint: more on false positives - 1/10/2012 11:05:10 PM   
Chilperic


Posts: 964
Joined: 3/21/2010
Status: offline
Grr...fixed this for the ANA, and forgot for their brothers ANM. next version

Thanks

_____________________________


(in reply to berto)
Post #: 139
RE: AGElint: more on false positives - 1/11/2012 8:01:00 AM   
berto


Posts: 20708
Joined: 3/13/2002
From: metro Chicago, Illinois, USA
Status: offline

I am making good progress toward the next official AGElint release.

If you wish, I can post an RC sooner rather than later. This RC would vet the RUS errors & warnings. But it would leave undone the ACW & ROP vetting, also tying up some loose ends. That would follow in the official release.

So, shall I release a RUS-ready RC soon, or just wait for the official?

_____________________________

Campaign Series Legion https://cslegion.com/
Campaign Series Lead Coder https://www.matrixgames.com/forums/tt.asp?forumid=1515
Panzer Campaigns, Panzer Battles, Civil War Battles Lead Coder https://wargameds.com

(in reply to Chilperic)
Post #: 140
RE: AGElint: AGEWiki docs vs. actual usage - 1/11/2012 9:05:47 AM   
berto


Posts: 20708
Joined: 3/13/2002
From: metro Chicago, Illinois, USA
Status: offline

Another puzzler...

AI.SetParams

shows



Syntax

AI.SetParams = <Param1 Value1> [;<Param2 Value 2>] [;<Param3 Value 3>] ...



but actual usage shows



[root@berto agelint]# ./kwddat AI.SetParams
1 AI.SetParams = aiLRV_HarborValCoef 90;aiLRV_RailVal 20;aiLRV_DestRailVal 13
1 AI.SetParams = aiLRV_HarborValCoef;90;aiLRV_RailVal ;20;aiLRV_DestRailVal;13
6 AI.SetParams = aiLRV_HarborValCoef 80;aiLRV_RailVal 20;aiLRV_DestRailVal 13
7 AI.SetParams = aiLRV_HarborValCoef;80;aiLRV_RailVal ;20;aiLRV_DestRailVal;13



that is, a ; semi-colon separating the Param from Value.

edit>In some cases. I looked again, and I can see that the actual usages show both.

Do I decide that the AGEWiki is authoritative and accurate? Or do I decide that the actual usage is authoritative and accurate? For now, I have decided in favor of the former. In either case, one usage or the other would generate a warning, and invite closer inspection.

So, I am handling this discrepancy between the AGEWiki docs and actual usage in this way:



aisetparams:      _AISETPARAMS eq anynamnoscintsclist
                | _AISETPARAMS eq namintsclist { txterrmsg(_WARNING, TRUE, linenorhs, "suspicious, undocumented use of ; separating Param from Value", "turnindex"); }
                {
                /*
                http://www.ageod.net/agewiki/AI.SetParams
                Syntax:  AI.SetParams = <Param1 Value1> [;<Param2 Value 2>] [;<Param3 Value 3>] ...
                */
                }
                ;




And so it goes...

< Message edited by berto -- 1/11/2012 11:58:39 AM >


_____________________________

Campaign Series Legion https://cslegion.com/
Campaign Series Lead Coder https://www.matrixgames.com/forums/tt.asp?forumid=1515
Panzer Campaigns, Panzer Battles, Civil War Battles Lead Coder https://wargameds.com

(in reply to berto)
Post #: 141
RE: AGElint: more on false positives - 1/11/2012 9:34:04 AM   
berto


Posts: 20708
Joined: 3/13/2002
From: metro Chicago, Illinois, USA
Status: offline

One more...



ERROR: in Events/RUSSiberianearlypath.sct, at (or near) line 4508: syntax error: #S# (0x53), #SelectFaction#

4499
4500 Actions
4501 ChangeFacMorale = 1
4502
4503
4504 EndEvent
4505
4506
4507
4508> SelectFaction = RED
4509 StartEvent = evt_nam_WH3_Perm_control_end_reco|1|0|NULL|NULL|NULL|NULL
4510
4511 Conditions
4512
4513 MinDate = 1918/06/01
4514
4515
4516 EvalEvent = evt_nam_WH3_Perm_control;>=;1
4517 EvalRgnOwned = $Perm;



Another false positive, right?

Wrong!

The usage database clearly, overwhelmingly shows a $ character before the SelectFaction FAC name.

In this case, the fix is in the txt.l lexer:



SelectFaction{W}*={W}*$?{C}{DC}{2}/{nDC} {
                          ECHO;
                          if (! strchr(yytext, '$')) {
                            txterrmsg(_ERROR, TRUE, lineno, "missing $ before FAC name");
                          }
                          FREE(factionselect);
                          factionselect = strdup(yytext+yyleng-3);
                          DECHO("FACTIONSELECT");
                          if (islist_selects) {
                            fprintf(stdout, "%s:%d:%s\n", txtfile, lineno, yytext);
                          }
                        /* the arbitrarily placed SelectFaction wreaks havoc
                           with the grammar, so we "cheat" by not returning
                           it to the parser
                         */
        	        /* RETURNCMD(_SELECTFACTION); */
        	        }


And similarly for SelectionRegion.

With that change, agelint now reports the error as



ERROR: in Events/RUSSiberianearlypath.sct, at (or near) line 4508: missing $ before FAC name



And so it goes...

_____________________________

Campaign Series Legion https://cslegion.com/
Campaign Series Lead Coder https://www.matrixgames.com/forums/tt.asp?forumid=1515
Panzer Campaigns, Panzer Battles, Civil War Battles Lead Coder https://wargameds.com

(in reply to berto)
Post #: 142
RE: AGElint: more on false positives - 1/11/2012 11:21:14 AM   
Chilperic


Posts: 964
Joined: 3/21/2010
Status: offline
No need to hurry, I'm yet this week a bit RL heavy, so I couldn't even really test a new version.

_____________________________


(in reply to berto)
Post #: 143
RE: AGElint: AGEWiki docs vs. actual usage - 1/11/2012 11:44:41 AM   
Chilperic


Posts: 964
Joined: 3/21/2010
Status: offline

quote:

ORIGINAL: berto


Another puzzler...

AI.SetParams

shows



Syntax

AI.SetParams = <Param1 Value1> [;<Param2 Value 2>] [;<Param3 Value 3>] ...



but actual usage shows



[root@berto agelint]# ./kwddat AI.SetParams
1 AI.SetParams = aiLRV_HarborValCoef 90;aiLRV_RailVal 20;aiLRV_DestRailVal 13
1 AI.SetParams = aiLRV_HarborValCoef;90;aiLRV_RailVal ;20;aiLRV_DestRailVal;13
6 AI.SetParams = aiLRV_HarborValCoef 80;aiLRV_RailVal 20;aiLRV_DestRailVal 13
7 AI.SetParams = aiLRV_HarborValCoef;80;aiLRV_RailVal ;20;aiLRV_DestRailVal;13



that is, a ; semi-colon separating the Param from Value.

Do I decide that the AGEWiki is authoritative and accurate? Or do I decide that the actual usage is authoritative and accurate? For now, I have decided in favor of the former. In either case, one usage or the other would generate a warning, and invite closer inspection.

So, I am handling this discrepancy between the AGEWiki docs and actual usage in this way:



aisetparams:      _AISETPARAMS eq anynamnoscintsclist
                | _AISETPARAMS eq namintsclist { txterrmsg(_WARNING, TRUE, linenorhs, "suspicious, undocumented use of ; separating Param from Value", "turnindex"); }
                {
                /*
                http://www.ageod.net/agewiki/AI.SetParams
                Syntax:  AI.SetParams = <Param1 Value1> [;<Param2 Value 2>] [;<Param3 Value 3>] ...
                */
                }
                ;




And so it goes...



As far I remember, I did test these events and they worked. Now I will do a new try with the current PBEMS I will begin soon.

Stay tuned.

_____________________________


(in reply to berto)
Post #: 144
RE: AGElint: AGEWiki docs vs. actual usage - 1/11/2012 12:00:58 PM   
berto


Posts: 20708
Joined: 3/13/2002
From: metro Chicago, Illinois, USA
Status: offline

I looked again, and I can see that the actual usages show both.

Yes, I will await the results of your tests.

_____________________________

Campaign Series Legion https://cslegion.com/
Campaign Series Lead Coder https://www.matrixgames.com/forums/tt.asp?forumid=1515
Panzer Campaigns, Panzer Battles, Civil War Battles Lead Coder https://wargameds.com

(in reply to Chilperic)
Post #: 145
ACW, For Want of a Nail, the Butterfly Effect, and quir... - 1/11/2012 12:48:34 PM   
berto


Posts: 20708
Joined: 3/13/2002
From: metro Chicago, Illinois, USA
Status: offline

Again: For Want of a Nail

http://en.wikipedia.org/wiki/For_want_of_a_nail

aka The Butterfly Effect.

We are seeing RUS improve by leaps and bounds.

As for AGEOD ACW, since the game's release, we have seen unending reports of strange and quirky ACW AI behavior.

I'm wondering if, aided by AGElint, SVF 2.0 combined with a thoroughly debugged and cleaned up game data set might eliminate such strange AI behaviors.

I am reminded of PON on first release, where so many bad alias refs were defaulting to 0 -- in PON, the North Pole!

So, for example, maybe in ACW bad alias refs are sending AI-led forces to some strange place(s).

And mangled AI commands are sending AI-led forces hither and yon in sometimes silly directions on sometimes silly missions.

Whenever I played AGEOD ACW, I observed this quirkiness, and I must say it was turn-off, and induced me to set the game aside.

If you develop a truly competent and, to me even more important, *plausible* AI behavior, I will finally begin to take ACW very seriously, and actually play the grand campaigns (not just scenarios)!

What are the prospects?

< Message edited by berto -- 1/11/2012 12:53:55 PM >


_____________________________

Campaign Series Legion https://cslegion.com/
Campaign Series Lead Coder https://www.matrixgames.com/forums/tt.asp?forumid=1515
Panzer Campaigns, Panzer Battles, Civil War Battles Lead Coder https://wargameds.com

(in reply to berto)
Post #: 146
RE: ACW, For Want of a Nail, the Butterfly Effect, and ... - 1/11/2012 1:05:38 PM   
Chilperic


Posts: 964
Joined: 3/21/2010
Status: offline
err...I will not comment the AI events in PON, BOA2. ROP 1.03 has a very basic intuition of I developped later, it was my first real try. For AACW, there are almost absent, as far I know. Let's say AACW is showing what the generic AI may do.

RUS AI events are mine. FY AI events are yet more polished and improved. There are certainly between 700 and 1,000 AI events.

SVF should need much less, with only 2 factions.

_____________________________


(in reply to berto)
Post #: 147
RE: ACW, For Want of a Nail, the Butterfly Effect, and ... - 1/11/2012 11:25:45 PM   
gamer78

 

Posts: 536
Joined: 8/17/2011
Status: offline
I have tried a few times AACW against the AI while it is good game it has horrible AI that can not defend any strategic location or produce anything worthwhile. It is indeed not worth the time arranging armies with anticipating there will be few smart moves from AI. I have tried PBem but I have found myself entrenching with Lee in Richmond while all my objective cities taken.So I couldn't enjoy properly from AACW,.

quote:

ORIGINAL: Chliperic

err...I will not comment the AI events in PON, BOA2. ROP 1.03 has a very basic intuition of I developped later, it was my first real try. For AACW, there are almost absent, as far I know. Let's say AACW is showing what the generic AI may do.

RUS AI events are mine. FY AI events are yet more polished and improved. There are certainly between 700 and 1,000 AI events.

SVF should need much less, with only 2 factions.


IF ROP has primitive AI then I know little about playing games
If it can improved further please do so And also WIA worth mentioning. While it has much better AI than AACW I guess there is so much bonus given to her

(in reply to Chilperic)
Post #: 148
AGElint v1.1 progress report - 1/12/2012 3:11:03 PM   
berto


Posts: 20708
Joined: 3/13/2002
From: metro Chicago, Illinois, USA
Status: offline

I am making very good progress towards releasing the next version of AGElint, v1.1. Probably by this weekend; if not, then very soon after that.

The biggest advances in the next release:

  • Removing genericalness from the txt.y parser.
  • Better describing errors, and not so readily defaulting to the generic, often uninformative "syntax error".

agelint errors are categorized as (a) ERRORs, including "syntax errors"; (b) WARNINGs; and (c) NOTICEs.

Here are the latest ERRORs, with instance counts, for RUS (1.04):



[root@berto agelint]# $ROOT/games/ageod/agelint/counterrs rus
errors in rus:

problematic cases:

2 FixedDate
2 ListParams1
1 SetName
1 DescEvent
1 CustomNames
1 ChgRgnDecisionFP
1 MinDate

fully vetted and confirmed:

1 Attributes
1 CheckPowerRatio
1 $Imgfam0
1 MindDate
1 NULL
1 Objectives
1 SetLevel
1 Side1
1 StrParam0
2 AddSubFacRgn
2 ChangeActorPool
2 ChgEvtOccurs
2 EvalAreaPowerRatio
2 SelectRegion
2 SetAdvRevolt
3 EvalUnqUnit
3 NULL
3 SetEvtOccurs
5 FlavorName
5 PickFromRegList
6 Effect_Str_Success
8 EvalLoyalty
9 SetUnitPoolInfos
11 StartEvent
13 SelectFaction
18 SetControl
19 AI.SetLocalInterest
36 AlterCuSubUnit
43 EvalEvent
62 SelectSubUnits



"Problematic cases" are a (very small) handful of cases where I can't yet discern the error, else I can see the error but programming a meaningful ERROR (or WARNING) message will be rather difficult. As you can see, there are just a very few remaining problematic cases. Most of the ERROR instances are fully vetted and real.

Those are just the ERRORs. Not shown are the WARNINGs and NOTICEs. There are many more WARNINGs and NOTICEs, so all in all we're looking at hundreds and hundreds of bugs of all types.

Not shown, too, are errors for the various chk*.pl scripts (such as chkaliases.pl). The above error counts are agelint-reported errors only.

Here are the latest agelint-reported ERRORs, with instance counts, for four of the other AGEOD games (no results for PON):



[root@berto agelint]# $ROOT/games/ageod/agelint/counterrs acw
errors in acw:

1 ActorUnderUse
1 AddXPtoGroup
1 $Alpine
1 BlockadeCoo
1 BuildLevel
1 BusieCost
1 EvalMorale
1 Families
1 $Imgfam0
1 MaxDate
1 PickFromRegList
1 ScenDuration
1 SetAIPoolRatios
2 Alias
2 CommandMinima
2 DisplayTag
2 EvalBlockade
2 FixType
2 SetEvtOccurs
3 RemoveCuUnit
3 StartEvent
4 AddToRegList
4 PickUnit
5 HQStackBadNb
5 IsCityScape
8 Kentucky
8 SelRegFromArea
17 CountUnits
86 ChangeActorPool
112 EvalSubUnitCount
166 CustomNames

[root@berto agelint]# $ROOT/games/ageod/agelint/counterrs ncp
errors in ncp:

1 $-1
1 Actions
1 AdjectiveF
1 $Alpine
1 BusieCost
1 ChgFactionTag
1 CustomNames
1 EvalVP
1 FactionFileID
1 GenMsg
1 $Imgfam0
1 IsCityScape
1 MaxDate
1 MaxRank
1 Objectives
1 OffFire
1 SetLevel
1 SetName
1 StrParam0
1 test.sct
2 NumCreate
2 Text
5 CountUnits
12 SelectSubUnits

[root@berto agelint]# $ROOT/games/ageod/agelint/counterrs rop
errors in rop:

1 Actions
1 BusieCost
1 EndEvent
1 FillAmmo
1 $FRA
1 $Imgfam0
1 SetLevel
1 $Steppe
1 StrParam0
2 GenTextMsg
2 StartEvent
5 AI.SetLocalInterest
6 Text
15 AddGarrison
39 AltercuSubUnit
106 SelectSubUnits

[root@berto agelint]# $ROOT/games/ageod/agelint/counterrs wia
errors in wia:

1 BusieCost
1 ChangeRgnOwner
1 $ENG
1 FixedDate
1 GenMsg
1 $Imgfam0
1 IsCityScape
1 ListParams0
1 ScenText
1 StrParam0
1 Z
3 ScenDispName
3 SelectRegInArea
5 Actions
8 RemoveStructure
9 EvalUnqUnit
10 Leader
30 SelectSubUnits
138 CountUnits



For the four games, none of these results have been vetted yet. From experience, I infer that cases with high instance counts, such as



86 ChangeActorPool
112 EvalSubUnitCount
166 CustomNames



are likely not genuine. Probably they require txt.y parser refinements to accommodate nuances particular to each game. The smaller the instance counts, such as



1 ActorUnderUse
1 AddXPtoGroup
1 $Alpine
1 BlockadeCoo
1 BuildLevel
1 BusieCost
1 EvalMorale
1 Families
1 $Imgfam0
1 MaxDate
1 PickFromRegList
1 ScenDuration
1 SetAIPoolRatios
2 Alias
2 CommandMinima
2 DisplayTag
2 EvalBlockade
2 FixType
2 SetEvtOccurs
3 RemoveCuUnit
3 StartEvent
4 AddToRegList
4 PickUnit
5 HQStackBadNb
5 IsCityScape
8 Kentucky
8 SelRegFromArea
17 CountUnits



the more likely they signal genuine errors. ('8 Kentucky' looks to me like a quite obvious error.)

NOTE: I will not be releasing full bug reports (with agelint ERRORs, WARNINGs, NOTICEs; also chk*.pl and other errors) for RUS or any of the other games as I have done in the past. I make tools only. It's up to you to make use of those tools, and to run your own bug reports.

Anyway, at this point, I draw encouragement from these results. For AGElint v1.1, I want to fully vet results for RUS, ACW, and probably also NCP. I may decide to release before fully vetting the ROP & WIA results. (PON is back-burnered, off the stove even.) The vetting process for all games will continue in the weeks ahead -- involving, importantly, user feedback here at the forum.

So, things are looking good. You can expect to see a new and improved AGElint release sooner rather than later. Stay tuned.

_____________________________

Campaign Series Legion https://cslegion.com/
Campaign Series Lead Coder https://www.matrixgames.com/forums/tt.asp?forumid=1515
Panzer Campaigns, Panzer Battles, Civil War Battles Lead Coder https://wargameds.com

(in reply to gamer78)
Post #: 149
RE: AGElint v1.1 progress report - 1/12/2012 7:58:04 PM   
Chilperic


Posts: 964
Joined: 3/21/2010
Status: offline
quote:


ERROR: in Events/RUSSiberianearlypath.sct, at (or near) line 4508: syntax error: #S# (0x53), #SelectFaction#

4499
4500 Actions
4501 ChangeFacMorale = 1
4502
4503
4504 EndEvent
4505
4506
4507
4508> SelectFaction = RED
4509 StartEvent = evt_nam_WH3_Perm_control_end_reco|1|0|NULL|NULL|NULL|NULL
4510
4511 Conditions
4512
4513 MinDate = 1918/06/01
4514
4515
4516 EvalEvent = evt_nam_WH3_Perm_control;>=;1
4517 EvalRgnOwned = $Perm;



I've done a test: RED without $ is working.

_____________________________


(in reply to berto)
Post #: 150
Page:   <<   < prev  3 4 [5] 6 7   next >   >>
All Forums >> [Current Games From Matrix.] >> [World War I] >> Revolution Under Siege Gold >> Mods and Scenarios >> RE: AGElint: AGEWiki docs vs. actual usage Page: <<   < prev  3 4 [5] 6 7   next >   >>
Jump to:





New Messages No New Messages
Hot Topic w/ New Messages Hot Topic w/o New Messages
Locked w/ New Messages Locked w/o New Messages
 Post New Thread
 Reply to Message
 Post New Poll
 Submit Vote
 Delete My Own Post
 Delete My Own Thread
 Rate Posts


Forum Software © ASPPlayground.NET Advanced Edition 2.4.5 ANSI

1.078