Conventions

We have used a number of different styles of text and layout in the site to help differentiate between the different kinds of information. Here are examples of the styles we use and an explanation of what they mean:

Bullets appear indented, with each new bullet marked as follows:

• Important Words are in italics.

• Keys that you press on the keyboard, take the form Ctrl key and Enter.

Code appears in a number of different ways. If it’s a word that we’re talking about in the text - for example, when discussing the if...else loop - it’s in this font. If it’s a block of code that you can type in as a program and run, then it’s also in a gray box:

public static void Main()
{
   AFunc(1,2,"abc");
}

Sometimes you’ll see code in a mixture of styles, like this:

// If we haven't reached the end, return true, otherwise
// set the position to invalid, and return false.
pos++;
if (pos < 4)
   return true;
else {
   pos = -1;
   return false;
}

The code with a white background is code you’ve already looked at and that we don’t wish to examine further.

We demonstrate the syntactical usage of methods, properties (and so on) using the following format:

Regsvcs siteDistributor.dll [COM+AppName] [TypeLibrary.tbl]

Here, italicized parts indicate object references, variables, or parameter values to be inserted; the square braces indicate optional parameters.