Post Documentation Bugs Here

CyberSlug · February 20, 2004

Need to address string-comparsion better; might be one for the FAQ

If $x == $y Then ...

If $x = $y Then ...

If $x <> $y Then ...

If Not ($x == $y) Then ...

CyberSlug · February 21, 2004

WinActivte and WinActivate: Make sure to fix in docs AND any syntax files for text editors.

Also: @userprofiledir In Win98, returning empty string

Antother, maybe: command-line issue on Windows 95

Edited February 22, 2004 by CyberSlug

oompah · February 21, 2004

Would you use feedback like the following? (Not saying you need it.)

LOCATION: AutoIt

> AutoIt v3 Hompage

ITEM: Hompage

CHANGE TO: Homepage

LOCATION: AutoIt

> but the syntax in v3 is poweful enough for general

> purpose scripting

ITEM: poweful

CHANGE TO: powerful

LOCATION: Running Scripts

> Although AutoIt v3 scripts are just plain-text file

ITEM: file

CHANGE TO: files

LOCATION: Running Scripts

> Although AutoIt v3 scripts are just plain-text file

> they are usually

ITEM: file they

CHANGE TO: file, they

LOCATION: Running Scripts

> Here is an example script, notice that ; is used for

> comments

COMMENT: Comma splice

(Ref.: http://www.bartleby.com/68/42/1342.html)

LOCATION: Running Scripts

> More complicated scripts may use functions which are

> usually placed at the end of a script.

CHANGE TO: More complicated scripts may use functions, which are usually placed at the end of a script.

COMMENT: Non-restrictive relative clause requires a comma.

(Ref.: http://www.bartleby.com/68/65/5065.html)

LOCATION: Running Scripts

> So if your script is run like this:

> AutoIt3.exe myscript.au3 param1 "this is another param"

> $CmdLine[0] = 2

> $CmdLine[1] = "param"

COMMENT: Should the words param1 and param be idectical?

LOCATION: Compiling Scripts

> standalone

COMMENT: Styled stand-alone in Webster's 11th, Micosoft Manual of Style 3.0, Can. Oxford

LOCATION: Compiling Scripts

> the option to bind additional files (also

> compressed/encrypted) to the exe using the FileInstall

ITEM: exe

COMMENT: Micosoft Manual of Style 3.0:

<quote>

Use executable and .exe as adjectives only, never as nouns. Use the article an, not a, with .exe, as in "an .exe file."

Correct

an executable program

the .exe file

Incorrect

an executable

the .exe

</quote>

LOCATION: Compiling Scripts

> 1. Open the start menu and browse to the AutoIt v3

> group.

ITEM: start menu

CHANGE TO: Start menu

COMMENT: Micosoft Manual of Style 3.0:

<quote>

start, Start (the menu)

In general, use start, as in "start a program," instead of boot, initiate, initialize, issue, launch, turn on , and so on. Capitalize references to the Start menu and the Start button on the taskbar, and always specify which one you are referring to.

Avoid "click the Windows Start button."

Correct

Start Windows, and then click the Start button to start your programs.

On the taskbar, click the Start button, and then click Run.

</quote>

LOCATION: Compiling Scripts

> 4. Use the Browse buttons to select you input (.au3)

> and output (.exe) files.

ITEM: you

CHANGE TO: your

LOCATION: Compiling Scripts

> 5. If you like you can change the icon of the

> resulting .exe

ITEM: .exe

COMMENT: As above

LOCATION: Compiling Scripts

> the decompression speed (when the .exe is run) is the

> same

ITEM: .exe

COMMENT: As above

LOCATION: Compiling Scripts

> 1. In Explorer browse to the .au3 file that you wish

> to compile.

ITEM: Explorer

COMMENT: FYI only, Micosoft Manual of Style 3.0:

<quote>

Explorer

Always use Windows Explorer or Microsoft Internet Explorer, depending on the program; do not shorten to Explorer or the Explorer.

</quote>

LOCATION: Compiling Scripts

> When compiling in this way current icon/compression

> settings

CHANGE TO: When compiling in this way, current icon/compression settings

COMMENT: Comma

LOCATION: Compiling Scripts

> When compiling in this way

COMMENT: Dangler

(dangling modifiers: http://www.bartleby.com/64/C001/021.html)

LOCATION: Compiling Scripts

> When compiling in this way current icon/compression

> settings are used

ITEM: icon/compression

CHANGE TO: icon and compression ?

COMMENT: Slash means "or"; sentence may require "and"

LOCATION: Compiling Scripts

> i.e. the encryption is two-way

ITEM: i.e.

CHANGE TO: i.e.,

LOCATION: Compiling Scripts

> For this reason you should regard the compiled exe as

> being encoded

ITEM: exe

COMMENT: As above. Cf. ".exe file" later in paragraph.

LOCATION: Compiling Scripts

> unless I was sure that the end-user would not have easy

> access

ITEM: end-user

CHANGE TO: end user

COMMENT: Micosoft Manual of Style 3.0:

<quote>

end user (n), end-user (adj)

Avoid; use user, customer, or you instead. Okay to use end user, however, to differentiate between types of users when, for example, there are both an administrator and end users or when referring to a programmer's audience in programming documentation.

</quote>

Josbe · February 21, 2004

Wow! oopah,

This one is a list of grammatical properness.!! :angry:

Me too, have to check a everything, them also in cases as "stand-alone" and others. (for the translations). :lmao:

thxs.

I also have seen in some cases AuotIt instead of AutoIt. But are small mistakes writing. :evil: :whistle:

CyberSlug · February 22, 2004

AutoIt 3.0.100 unstable has been posted, so I'll begin doc updates.

CyberSlug · February 23, 2004

I'm using docs-v3.0.94-beta-sr..> 21-Feb-2004 04:05 540k as the basis for the documentation fixes.

From jlandes:

@UserProfileDir - Path to current user's Profile folder.

@HomeDrive - Drive letter of drive containing current user's home directory.

@HomePath - Directory part of current user's home directory. To get the full path, use in conjunction with @HomeDrive.

@HomeShare - Server and share name containing current user's home directory.

@LogonServer - Logon server.

@LogonDomain - Logon Domain.

@LogonDNSDomain - Logon DNS Domain.

CyberSlug · February 24, 2004

Well, since I've put off the doc updates until now :whistle: , I'll use

docs-v3.0.100-beta-s..> 24-Feb-2004 01:56 540k

Jon · February 24, 2004

Well, since I've put off the doc updates until now , I'll use
docs-v3.0.100-beta-s..> 24-Feb-2004 01:56 540k

But, Flash, we only have 2 days left to save Earth!

Valik · February 24, 2004

ProcessWait lists the wrong return values (In the 3.0.94 docs, at least). It should be:

Success: Returns 1.

Failure: Returns 0 if wait timed out.

not:

Success: Returns 0.

Failure: Returns 1 if the wait timed out.

This both matches how the function works and also how ProcessWaitClose works (This caused me a couple minutes of confusion when I was testing those 2 functions the other day...)

Edited February 24, 2004 by Valik

BobHansen · February 25, 2004

Also, what do you think of a ref page like this?

1. Would suggest to add one more column defining the Return/Error options.

2. Maybe color code Reserved Words

Nutster · February 25, 2004

FileOpenDialog/FileSaveDialog:

The filter parameters is poorly described.

Existing:

filter: File type filter such as "*.*" or "*.txt"

Proposed:

Filter: Show only files of a given type, for example: "AutoIt V3 Scripts (*.au3)" The actual filename pattern must be enclosed in parentheses.

Nutster · February 25, 2004

What happened to all the stuff at the bottom from the original docs? I put that it because of the licencing statement from the original authors.

Also, the period is 2^19937-1, not 219937-1. Use 2<sup>19937</sup>-1 in the docs to specify please.

Jon · February 25, 2004

I just left in the bits it says to leave in (the copyright notice). It was freaking people out with the whole talking about sending emails.

CyberSlug · February 25, 2004

Good--I didn't want to deal with Random.

I'll will have large batch of updates to post tonight!

Please get MouseGetCursor fixed so I can finalize its example in the docs :whistle:

Nutster · February 25, 2004

I just left in the bits it says to leave in (the copyright notice). It was freaking people out with the whole talking about sending emails.

Yeah, we can take out the last two paragraphs in the old docs. Tonight I will edit the Radnom() docs to include how to find an integer random number and fix the examples. I will send it to you tomorrow.

Jon · February 25, 2004

Yeah, we can take out the last two paragraphs in the old docs. Tonight I will edit the Radnom() docs to include how to find an integer random number and fix the examples. I will send it to you tomorrow.

Make sure you edit the Random.txt file in the txt2htm directory. html is sooo last year :whistle:

Jon · February 25, 2004

Great...
tomorrow we'll update your spelling mistakes...

Radnom. Heh. I prefer it.

Nutster · February 25, 2004

Yeah, Random. Oops.

So Random.txt is what gets edited and that drives the html? That's why the superscripting disappears. :whistle: Ok I can work on it.

CyberSlug · February 25, 2004

Nutster, you can use html tags.... Read this:

txt2htm.au3 converts specially formatted text files to htm files which comprise the compiled help file.

The following is an example with explanations:

###Function###
Name goes here.  The above title could also be ###Keyword###

###Description###
One-line description.

###Syntax###
One-line syntax spec.


###Parameters###
@@ParamTable@@
Description
   ParamTables are special, two-column tables
   where the first column is only one line,
   but the second column can be many lines.
How To Denote
   Any information that appears in the second
   column must be indented with one tab.
   Each entry that is NOT indented begins a new row.
   DO NOT LEAVE ANY BLANK LINE BETWEEN HERE AND "@@END@@"
@@End@@


###ReturnValue###
None.
 

###Remarks###
In general, whitespace outside of tables is ignored.
The exception is the Remarks Section:  Lines can be indendented, and non-consecutive blank lines are converted
as HTML <br>'s.

You can also use <b>bold</b> and <i>italic</i> tags.  Pretty much any HTML formatting can be used, since this text is more or less copied directly over to the htm file.

Remarks go here.  Here's a standard table; each line is a new row, and columns are tab-separated:

@@StandardTable@@
row1col1   row1col2   row1col3   row1col4
row2col1   row2col2   row2col3   row2col4
@@End@@


###Related###
Foo, Bar (Option), <a href="whatever/baz.htm">Baz</a>

; the above will be converted to the following HTML:
<a href="foo.htm">Foo</a>, <a href="AutoItSetOption.htm#Bar">Bar (Option)</a>, <a href="whatever/baz.htm">Baz</a>


###Example###
The example will be formatted appropriately
Indent the lines with tabs; they will be converted to spaces (4, I think) in the html output.

Nutster · February 25, 2004

Got it! And away I go! :whistle:

Post Documentation Bugs Here

Recommended Posts

Link to comment

Share on other sites

Top Posters In This Topic

Top Posters In This Topic

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Create an account or sign in to comment

Create an account

Sign in

Recently Browsing 0 members