Help File/Documentation Issues. (Discussion Only)

[Tlem]

Hi,

In Helpfile, history.htm stop at version 3.2.0.1. In autoit_changelog.txt we can see history until 3.0.32.

Is this wanted or is it related to the format of the version number that Gen_Changelog.au3 can not handle?

[mLipok]

From where you get/take this files ?

 

Edited March 17, 2018 by mLipok

[Tlem]

Hi,

You can find it in the sources files of the documentation here : https://www.autoitscript.com/autoit3/files/archive/autoit/

The last one is : https://www.autoitscript.com/autoit3/files/archive/autoit/autoit-docs-v3.3.14.5-src.zip

And the file is in \docs\autoit\english

[mLipok]

Oh now I understand your question, but I do not know the answer.

 

[BrewManNH]

When I open history.htm in "docs\autoit\english\html\" the file goes to 3.3.14.5 for me.

[mLipok]

I think he ask about start not end .... edit: first not last/recent information.

Edited March 19, 2018 by mLipok

[BrewManNH]

There's a link on that page to get the full history log.

As it states on that page, it's a summarized history of the changes, it's not supposed to be complete.

[Tlem]

I know all of that. I just want to know if it's wanted or if it's a bug of the file that compile the html file.

[BrewManNH]

I'd say it's deliberate because there's a link to the full changelog on that page, plus the beta helpfile only goes back that far as well.

[Tlem]

I take this answer as it is.
Thank you for this clarification

[mLipok]

As from Au3.3.14.3 AutoIt have _DebugArrayDisplay() and _ArrayDisplay() , I'm wondering whether this functions, should have any information in related, which will  linking them  together ?

 

[pixelsearch]

Help file : AutoItSetOption where all 30 Opt() are clearly explained + a grouped example in the end.
28 Opt() are correct : their default is the same in their explanation and in the final example.
2 Opt() show a default which is not the same in their explanation and in the final example, they are :

SendKeyDownDelay : Time in milliseconds to pause (default=5)
Opt("SendKeyDownDelay", 1) ;1 millisecond

WinSearchChildren ; 0 = (default) Only search top-level windows
Opt("WinSearchChildren", 1) ;0=no, 1=search children also

The help file should probably be updated, so all 30 Opt() will show the same default in their explanation and in the final example.

Thanks for reading 
 

[BrewManNH]

Those aren't defaults, they're settings. The SendKeyDownDelay isn't setting it to the default setting, it's setting it to a delay of 1 ms, as an example.

[pixelsearch]

2 hours ago, BrewManNH said:

Those aren't defaults, they're settings. The SendKeyDownDelay isn't setting it to the default setting, it's setting it to a delay of 1 ms, as an example.

Hi BrewManNH,

I agree, but when 28 examples out of 30 indicate clearly the default value, then why not all of them ?

It's not consistent at all, because when any user copies an example from this page and pastes it in his script, he can't always have in mind that 93.3% of the examples (28/30) indicate the default but 6.7% don't. I checked them all 1 by one 1 and guarantee that 28 examples out of 30 indicate the default.

Edited June 20, 2018 by pixelsearch

[BrewManNH]

Now that's just being anal or OCD. You're probably the only person that cares that 2 examples of 30 aren't using the default settings. Because it's been like that for many years, and this is the first time someone complained that it didn't meet their standards.

[JLogan3o13]

Additionally, why would a user just copy and run without actually reading the help file page? The entry for both shows the default. At some point, you have to be accountable for some level of common sense as the reader.

[pixelsearch]

Ok, I wont play this "who's right / who's wrong". If you don't like simple and clear things, I can't do anything about it.

 It was a pleasure being able to help some people during these last days, now it's time to close my account and leave the forum. Peace for all.
 

[JLogan3o13]

You're going to close your account because people disagree with your opinion? Childish much?

[StainlessS]

Example script stops with error,

"C:\Documents and Settings\root\My Documents\Downloads\test.au3" (4) : ==> Variable subscript badly formatted.:
Local $mMap[]
Local $mMap[^ ERROR

AutoIt/Function Referenece/Misc Management/VarGetType/

expandcollapse popup

#include <MsgBoxConstants.au3>

Local $aArray[2] = [1, "Example"]
Local $mMap[]
Local $dBinary = Binary("0x00204060")
Local $bBoolean = False
Local $pPtr = Ptr(-1)
Local $hWnd = WinGetHandle(AutoItWinGetTitle())
Local $iInt = 1
Local $fFloat = 2.0
Local $oObject = ObjCreate("Scripting.Dictionary")
Local $sString = "Some text"
Local $tStruct = DllStructCreate("wchar[256]")
Local $vKeyword = Default
Local $fuFunc = ConsoleWrite
Local $fuUserFunc = Test

MsgBox($MB_SYSTEMMODAL, "", _
        "Variable Types" & @CRLF & @CRLF & _
        "$aArray : " & @TAB & @TAB & VarGetType($aArray) & " variable type." & @CRLF & _
        "$mMap : " & @TAB & @TAB & VarGetType($mMap) & " variable type." & @CRLF & _
        "$dBinary : " & @TAB & @TAB & VarGetType($dBinary) & " variable type." & @CRLF & _
        "$bBoolean : " & @TAB & VarGetType($bBoolean) & " variable type." & @CRLF & _
        "$pPtr : " & @TAB & @TAB & VarGetType($pPtr) & " variable type." & @CRLF & _
        "$hWnd : " & @TAB & @TAB & VarGetType($hWnd) & " variable type." & @CRLF & _
        "$iInt : " & @TAB & @TAB & VarGetType($iInt) & " variable type." & @CRLF & _
        "$fFloat : " & @TAB & @TAB & VarGetType($fFloat) & " variable type." & @CRLF & _
        "$oObject : " & @TAB & VarGetType($oObject) & " variable type." & @CRLF & _
        "$sString : " & @TAB & @TAB & VarGetType($sString) & " variable type." & @CRLF & _
        "$tStruct : " & @TAB & @TAB & VarGetType($tStruct) & " variable type." & @CRLF & _
        "$vKeyword : " & @TAB & VarGetType($vKeyword) & " variable type." & @CRLF & _
        "MsgBox : " & @TAB & @TAB & VarGetType(MsgBox) & " variable type." & @CRLF & _
        "$fuFunc : " & @TAB & @TAB & VarGetType($fuFunc) & " variable type." & @CRLF & _
        "Func 'Test' : " & @TAB & VarGetType(Test) & " variable type." & @CRLF & _
        "$fuUserFunc : " & @TAB & VarGetType($fuUserFunc) & " variable type.")

Func Test()
EndFunc   ;==>Test

 

EDIT: AutoIt v3.3.14.5

So Maps are documented, but not yet implemented.

Edited July 17, 2018 by StainlessS

[Jos]

MAPs is a Beta version functionality and should not be in production yet.

Jos