Prorotype help file for high level MASM32 capacity

[hutch--]

In my spare time I have been working on a new help file to make the later HLL style macros and the intrinsic MASM pseudo HLL statements easier to follow and learn. It is only partially finished and I have something like 140 macros to document but I am reasonably pleased with the help file so far.

Any feedback on the file's intelligibility would be welcome.

I have just replaced the original attachment with the later version.

[attachment deleted by admin]

[Vortex]

Hi Hutch,

Very nice work :U

[GregL]

It looks good Hutch. MASM32 just gets better and better.  :U

[Peterpan]

This is a nice help  :U

[hutch--]

Thqanks for the feedback guys, I have just replaced the first attachment with the next version that has a reasonable number of the working macros documented so they are easier to use and find reference for.

As before, feedback from anyone learning to fly MASM would be appreciated.

[MichaelW]

I didn't have time to read everything, but everything I did read seems completely intelligible. I do see a few things that are missing:

Under Control Flow Techniques/Using the .IF Syntax, it seems to me that only the first 7 operators are properly "comparison" operators. The Microsoft manuals refer to the first 10 as expression operators, and the last 5 as operands. There are no examples of using the operands. For the operators I think the descriptions and examples are more than sufficient for programmers who are familiar with C, but I have doubts that they would be sufficient for other HLL programmers. There is no mention of a condition without an operator testing for nonzero, of parentheses, or of operator precedence.

Under Loop Code Methods there are no links to the expression operators/operands.

Under Memory Allocation, and under String Macros/Allocating String buffers, no mention is made of oleaut32.inc and oleaut32.lib.

Under StringMacros/add$ and append$, no mention is made of the need for empty/new buffers to start with an ascii zero.