www.digitalmars.com         C & C++   DMDScript  

digitalmars.D - CHM (HTML Help) creator for D documentation

------------g19PGZO1aKfKN0WQ4xfX7G
Content-Type: text/plain; charset=koi8-r
Content-Transfer-Encoding: Quoted-Printable

Greetings,

In an attempt to ease the life of Windows D programmers, I decided to wr=
ite an utility which would automatically convert the D documentation, di=
stributed with DMD, to an HTML Help project. It was an interesting task,=
 and through some effort I managed at automating the creation of an usab=
le CHM file.

The advantages of using a CHM help file over the included HTML files:

1) it's one compressed file, instead of many
2) the contents is somewhat easier to navigate
3) it has instantaneous indexed search, supporting boolean operators
4) comprehensive index of literally too many keywords...

The program doesn't make assumptions on how the help files are laid out,=
 so it should work with future D releases. The only exception is that th=
e program uses Kirk McDonald's keyword index ( http://www.prowiki.org/wi=
ki4d/wiki.cgi?LanguageSpecification/KeywordIndex ), since I didn't find =
a reliable way to find where respective keywords are explained in the do=
cumentation. The full unmodified source of that wiki page is embedded in=
 the program source, so it should be just as easy to update.

When preparing the help files for the CHM format, the program does the f=
ollowing modifications:

1) remove the left navigation bar (it is replaced by the HTML Help's nav=
igation pane)
2) skip Google AdSense ads, which don't make any sense in offline media =
- browsers don't (and shouldn't) allow uploading contents of local data =
to web services, thus Google AdSense displays rubbish/Chinese ads anyway=
.

Here's the usage instructions:

1) download and install the Microsoft HTML Help Workshop from here: http=
://www.microsoft.com/downloads/details.aspx?familyid=3D00535334-c8a6-452=
f-9aa0-d597d16580cc&displaylang=3Den
2) save chmgen.d to ...\dmd\html\
3) compile and run it
4) open the d.hhp file with HTML Help Workshop and compile it
    -- or --
    run: hhc.exe d.hhp
5) enjoy your brand new d.chm !

Alternatively, you can download the CHM file from here: http://thecybers=
hadow.net/d/docs/d.chm
I am not sure about the distribution rights of the documentation, so if =
there are some legal problems, let me know and I'll remove it immediatel=
y.

Things that could still be improved:

  - inserting anchors in some places, like before every function in the =
Phobos docs
  - a cleaner/more accurate index
  - splitting the articles in categories (D syntax, Phobos, ...) to allo=
w filtering
  - adding Tango docs for an all-in-one D help file?
  - the code could be generally cleaned up in some places...

I release the attached code to the Public Domain (no rights reserved). H=
owever, the contents of the included wiki page is distributed under FDL.=


-- =

Best regards,
  Vladimir                          mailto:thecybershadow gmail.com
------------g19PGZO1aKfKN0WQ4xfX7G
Content-Disposition: attachment; filename=chmgen.d
Content-Type: text/x-dsrc; name=chmgen.d
Content-Transfer-Encoding: Quoted-Printable

import std.stdio;
import std.file;
import std.string;
import std.regexp;

// ********************************************************************

int min(int a, int b)
{
	return a < b ? a : b;
}

void backSlash(char[] s)   // replace path delimiters in-place
{
	//s=3Ds.dup;
	foreach(inout c;s)
		if(c=3D=3D'/')
			c=3D'\\';
}

bool match(char[] line, char[] pattern)
{
	return std.regexp.find(line, pattern)>=3D0;
}

char[] getAnchor(char[] s)
{
	int i =3D std.string.find(s, '#');
	if(i<0)
		return "";
	else
		return s[i..$];
}

char[] removeAnchor(char[] s)
{
	int i =3D std.string.find(s, '#');
	if(i<0)
		return s;
	else
		return s[0..i];
}

char[] absoluteUrl(char[] base, char[] url)
{
	backSlash(base);
	backSlash(url);
	=

	if (url[0]=3D=3D'#')
		return base ~ url;

	while(base[$-1]!=3D'\\')
		base =3D base[0..$-1];
	=

	while(url[0..3]=3D=3D"..\\")
	{
		url =3D url[3..$];
		do {
			base =3D base[0..$-1];
			if(base.length=3D=3D0)
				return "";
		} while(base[$-1]!=3D'\\');
	}
	return base ~ url;
}

char[] movePath(char[] s)
{
	if(s.length>1 && s[0..2]=3D=3D"d\\")
		s =3D "chm" ~ s[1..$];
	return s;
}

char[] normalize(char[] s)
{
	s =3D tolower(s);
	char[] t;
	foreach(c;s)
		if(!iswhite(c))
			t ~=3D c;
	return t;
}

// ********************************************************************

struct Link
{
	char[] url, title, text;

	static Link opCall(char[] url, char[] title, char[] text)
	{
		backSlash(url);
		Link my;
		my.url =3D strip(url);
		my.title =3D strip(title);
		my.text =3D strip(text);
		return my;
	}
}

struct LinkBlock
{
	Link caption;
	Link[] links;

	static LinkBlock opCall(char[] url, char[] title, char[] text)
	{
		backSlash(url);
		LinkBlock my;
		my.caption.url =3D strip(url);
		my.caption.title =3D strip(title);
		my.caption.text =3D strip(text);
		return my;
	}
}

class Page
{
	char[] newFileName;
	char[] title;
	char[] src;
	Link[] toctop;
	LinkBlock[] linkBlocks;
	bool[char[]] anchors;
}

struct KeyLink
{
	char[] anchor;
	char[] title;

	static KeyLink opCall(char[] anchor, char[] title)
	{
		KeyLink my;
		my.anchor =3D strip(anchor);
		my.title =3D strip(title);
		return my;
	}
}

// ********************************************************************

char[][] listdirrec(char[] pathname)
{
	char[][] files =3D null;	=


	bool listing(char[] filename)
	{
		char[] file =3D std.path.join(pathname, filename);
		if(isdir(file))
		{
			char[] oldpath =3D pathname;
			pathname =3D file;
			listdir(pathname, &listing);
			pathname =3D oldpath;
		}
		else
		{
			files ~=3D std.path.join(pathname, filename);
		}
		return true; // continue
	}
	=

	listdir(pathname, &listing);

	return files;
}

Page[char[]] pages;
KeyLink[char[]][char[]] keywords;   // keywords[normalize(keyword)][orig=
inal url w/o anchor] =3D anchor/title
char[][char[]] keyTable;

void addKeyword(char[] keyword, char[] link, char[] title =3D null)
{
	keyword =3D strip(keyword);
	char[] norm =3D normalize(keyword);
	char[] file =3D removeAnchor(link);
	backSlash(file);
	char[] anchor =3D getAnchor(link);
	if(title=3D=3Dnull && norm in keywords && file in keywords[norm])   // =
when title is present, it overrides any existing anchors/etc.
	{
		if(keywords[norm][file].anchor>anchor) // "less" is better
			keywords[norm][file] =3D KeyLink(anchor, title);
	}
	else
		keywords[norm][file] =3D KeyLink(anchor, title);
	if(title=3D=3Dnull && norm in keyTable)
	{
		if(keyTable[norm]>keyword) // "less" is better
			keyTable[norm] =3D keyword;
	}
	else
		keyTable[norm] =3D keyword;
}

void main()
{
	// clean up
	if(exists("chm"))
		foreach(file;listdirrec("chm\\"))
			std.file.remove(file);
	else
		mkdir("chm");
	=

	char[][] files =3D listdirrec("d\\");
	=

	foreach(i,file;files)
		pages[file] =3D new Page;

	RegExp re_title =3D new RegExp(`<title>(Digital Mars - The )?D Programm=
ing Language - (.*)</title>`);
	RegExp re_title2 =3D new RegExp(`<h1>(.*)</h1>`);
	RegExp re_heading =3D new RegExp(`<h2>(.*)</h2>`);
	RegExp re_heading_link =3D new RegExp(`<h2><a href=3D"([^"]*)"( title=3D=
"([^"]*)")?>(.*)</a></h2>`);
	RegExp re_nav_link =3D new RegExp(`<li><a href=3D"([^"]*)"( title=3D"(.=
*)")?>(.*)</a></li>`);
	RegExp re_anchor =3D new RegExp(`<a name=3D"([^"]*)">(<.>)*([^<]+)<`);
	RegExp re_anchor_2 =3D new RegExp(`<a name=3D([^>]*)>(<.>)*([^<]+)<`);
	RegExp re_link   =3D new RegExp(`<a href=3D"([^"]*)">(<.>)*([^<]+)<`);
	RegExp re_def =3D new RegExp(`<dt><big>.*<u>([^<]+)<`);

	foreach(fileName,page;pages)
		with(page)
		{
			char[] destdir =3D movePath(std.path.getDirName(fileName));
			if(!exists(destdir))
				mkdir(destdir);

			newFileName =3D movePath(fileName);

			if(match(fileName, `\.html$`))
			{
				writefln("Processing "~fileName);
				src =3D cast(char[])read(fileName);
				char[][] lines =3D splitlines(src);
				char[][] newlines =3D null;
				bool skip =3D false, intoctop =3D false, innavblock =3D false, innav=
block2 =3D false;
				int dl =3D 0;
				char[] anchor =3D null;
				anchors[""] =3D true;
				foreach(line;lines)
				{
					bool nextSkip =3D skip;
					=

					if (re_title.find(line)>=3D0)
					{
						title =3D strip(re_title.match(2));
						line =3D re_title.replace(`<title>` ~ title ~ `</title>`);
					}
					if (re_title2.find(line)>=3D0)
						if(title=3D=3D"")
							title =3D strip(re_title2.match(1));
					=

					if (re_anchor.find(line)>=3D0)
					{
						anchor =3D '#' ~ re_anchor.match(1);
						anchors[anchor] =3D true;
					}
					else
					if (re_anchor_2.find(line)>=3D0)
					{
						anchor =3D '#' ~ re_anchor.match(1);
						anchors[anchor] =3D true;
					}

					if(match(line, `<div id=3D"toctop">`))
						intoctop =3D true;
					if(match(line, `<div class=3D"navblock">`))
						if(innavblock)
						{
							innavblock2 =3D true;
							linkBlocks ~=3D LinkBlock("", "", "");
						}
						else
							innavblock =3D true;
					if(match(line, `</div>`))
						intoctop =3D innavblock2 =3D false;

					if(std.string.find(line, `<dl>`)>=3D0)
						dl++;
					if(dl=3D=3D1)
					{
						if(re_def.find(line)>=3D0)
							addKeyword(re_def.match(1), fileName ~ anchor);
					}
					if(std.string.find(line, `</dl>`)>=3D0)
						dl--;

					if(re_heading_link.find(line)>=3D0)
					{
						if(innavblock2)
							linkBlocks ~=3D LinkBlock(re_heading_link.match(1), re_heading_li=
nk.match(3), re_heading_link.match(4));
					}
					else
					if(re_heading.find(line)>=3D0)
					{
						if(innavblock2)
							linkBlocks ~=3D LinkBlock("", "", re_heading.match(1));
					}

					if(re_nav_link.find(line)>=3D0)
						if(intoctop)
							toctop   ~=3D Link(re_nav_link.match(1), re_nav_link.match(3), re=
_nav_link.match(4));
						else
						if(innavblock2)
							if(re_nav_link.match(1)[0..7]!=3D"http://" && exists(absoluteUrl(=
fileName, re_nav_link.match(1))))
								linkBlocks[$-1].links ~=3D Link(re_nav_link.match(1), re_nav_lin=
k.match(3), re_nav_link.match(4));
						//else
						//	writefln("Displaced link: ", line);
					=

					if(re_anchor.find(line)>=3D0)
						addKeyword(re_anchor.match(3), fileName ~ "#" ~ re_anchor.match(1)=
);
					else
					if(re_anchor_2.find(line)>=3D0)
						addKeyword(re_anchor_2.match(3), fileName ~ "#" ~ re_anchor_2.matc=
h(1));
					=

					if(re_link.find(line)>=3D0)
						if(re_link.match(1)[0..min($,7)]!=3D"http://")
							addKeyword(re_link.match(3), absoluteUrl(fileName, re_link.match(=
1)));
					=

					// skip Google ads
					if(match(line, `^<!-- Google ad -->$`))
						skip =3D nextSkip =3D true;
					if(match(line, `^</script>$`))
						nextSkip =3D false;

					// skip navigation bar
					if(match(line, `^<div id=3D"navigation">$`))
						skip =3D nextSkip =3D true;
					if(match(line, `^<div id=3D"content">$`))
						skip =3D nextSkip =3D false;

					if(!skip)
						newlines ~=3D line;
					skip =3D nextSkip;
				}
				src =3D join(newlines, newline);
				write(newFileName, src);
			}
			else
			if(match(fileName, `\.css$`))
			{
				writefln("Processing "~fileName);
				src =3D cast(char[])read(fileName);
				char[][] lines =3D splitlines(src);
				char[][] newlines =3D null;
				foreach(line;lines)
				{
					// skip #div.content positioning
					if(!match(line, `margin-left:13em;`))
						newlines ~=3D line;
				}
				src =3D join(newlines, newline);
				write(newFileName, src);
			}
			else
			{
				copy(fileName, newFileName);
			}
		} =


	// ************************************************************

	Link[] topLinks;
	bool[char[]] gotLink;

	foreach(fileName,page;pages)
		foreach(link;page.toctop)
		{
			char[] url =3D absoluteUrl(fileName, link.url);
			if(!(url in gotLink))
			{
				topLinks ~=3D Link(url, link.title, link.text);
				gotLink[url] =3D true;
			}
		}

	// retreive keyword link titles
	foreach(keyNorm,urls;keywords)
		foreach(url,inout link;urls)
			if(url in pages)
				link.title =3D pages[url].title;

	// ************************************************************

	RegExp re_key_new =3D new RegExp(`<tt>(.*)</tt>`);
	RegExp re_key_link =3D new RegExp(`^\* (.*)\[http://www\.digitalmars\.c=
om/([^ ]*) (.*)\]`);

	char[][] keywordLines =3D splitlines(keywordIndex);
	char[] keyword;
	foreach(line;keywordLines)
	{
		if(re_key_new.find(line)>=3D0)
			keyword =3D re_key_new.match(1);
		if(re_key_link.find(line)>=3D0)
		{
			char[] url =3D re_key_link.match(2);
			char[] file =3D removeAnchor(url);
			char[] anchor =3D getAnchor(url);
			backSlash(url);
			=

			if(file in pages)
			{
				if(!(anchor in pages[file].anchors))
				{
					char[] cmp1 =3D normalize(anchor);
					foreach(realAnchor,b;pages[file].anchors)
					{
						char[] cmp2 =3D normalize(realAnchor);
						int n =3D min(cmp1.length, cmp2.length);
						if(n>=3D3 && cmp1[0..n] =3D=3D cmp2[0..n])
						{
							//writefln("Fixing broken anchor " ~ anchor ~ " to " ~ realAnchor=
);
							anchor =3D realAnchor;
							break;
						}	=

					}
				}

				if(anchor in pages[file].anchors)
				{
					addKeyword(keyword, file ~ anchor, re_key_link.match(1) ~ re_key_li=
nk.match(3));
				//	writefln("Adding keyword " ~ keyword ~ " to " ~ file ~ anchor ~ "=
 as " ~ re_key_link.match(1) ~ re_key_link.match(3));
				}
				//else
				//	writefln("Broken anchor link to keyword "~ keyword ~ " to " ~ re_=
key_link.match(2) ~ " as " ~ re_key_link.match(1) ~ re_key_link.match(3)=
);
			}
			//else
			//	writefln("Unfound URL: " ~ url);
		}
	}

	// ************************************************************

	FILE* f =3D fopen("d.hhp", "wt");
	fwritefln(f, =

`[OPTIONS]
Compatibility=3D1.1 or later
Compiled file=3Dd.chm
Contents file=3Dd.hhc
Default Window=3Dmain
Default topic=3D` ~ movePath(topLinks[0].url) ~ `
Display compile progress=3DNo
Full-text search=3DYes
Index file=3Dd.hhk
Language=3D0x409 English (United States)
Title=3DD

[WINDOWS]
main=3D"D","d.hhc","d.hhk","chm\index.html","chm\index.html",,,,,0x63520=
,,0x380e,[271,372,593,566],0x918f0000,,,,,,0

[FILES]`);
	char[][] htmlList;
	foreach(page;pages)
		if(match(page.newFileName, `\.html$`))
			htmlList ~=3D page.newFileName;
	htmlList.sort;
	foreach(s;htmlList)
		fwritefln(f, s);
	fwritefln(f, `
[INFOTYPES]`);
	fclose(f);

	// ************************************************************

	f =3D fopen("d.hhc", "wt");
	fwritefln(f, =

`<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN"><HTML><BODY>
<OBJECT type=3D"text/site properties"><param name=3D"Window Styles" valu=
e=3D"0x800025"></OBJECT>
<UL>`);
	foreach(toplink;topLinks)
	{
		fwritefln(f, =

`	<LI><OBJECT type=3D"text/sitemap">
		<param name=3D"Name" value=3D"` ~ toplink.title ~ `">
		<param name=3D"Local" value=3D"` ~ movePath(toplink.url) ~ `">
		</OBJECT>
	<UL>`);
		Page topPage =3D pages[toplink.url];
		foreach(link;topPage.linkBlocks[0].links)
			fwritefln(f, =

`		<LI> <OBJECT type=3D"text/sitemap">
			<param name=3D"Name" value=3D"` ~ link.text ~ `">
			<param name=3D"Local" value=3D"` ~ movePath(absoluteUrl(toplink.url, =
link.url)) ~ `">
			</OBJECT>`);
		foreach(linkBlock;topPage.linkBlocks[1..$])
		{
			fwritefln(f, =

`		<LI> <OBJECT type=3D"text/sitemap">
			<param name=3D"Name" value=3D"` ~ linkBlock.caption.text ~ `">`);
			if(linkBlock.caption.url!=3D"")
				fwritefln(f, =

`			<param name=3D"Local" value=3D"` ~ movePath(absoluteUrl(toplink.url,=
 linkBlock.caption.url)) ~ `">`);
			fwritefln(f, =

`			</OBJECT>
		<UL>`);
			foreach(link;linkBlock.links)
				fwritefln(f, =

`			<LI> <OBJECT type=3D"text/sitemap">
				<param name=3D"Name" value=3D"` ~ link.text ~ `">
				<param name=3D"Local" value=3D"` ~ movePath(absoluteUrl(toplink.url,=
 link.url)) ~ `">
				</OBJECT>`);
			fwritefln(f, =

`		</UL>`);
		}
		fwritefln(f, =

`	</UL>`);
	}
	fwritefln(f, `</UL>
</BODY></HTML>`);
	fclose(f);

	// ************************************************************

	f =3D fopen("d.hhk", "wt");
	fwritefln(f, =

`<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN"><HTML><BODY>
<UL>`);
	foreach(keyNorm,urlList;keywords)
	{
		fwritefln(f, =

`	<LI> <OBJECT type=3D"text/sitemap">
		<param name=3D"Name" value=3D"` ~ keyTable[keyNorm] ~ `">`);
		foreach(url,link;urlList)
			if(url in pages)
			{
				fwritefln(f, =

`		<param name=3D"Name" value=3D"` ~ link.title ~ `">
		<param name=3D"Local" value=3D"` ~ movePath(url) ~ link.anchor ~ `">`)=
;
			}
		fwritefln(f, =

`		</OBJECT>`);
	}
	fwritefln(f, =

`</UL>
</BODY></HTML>`);
	fclose(f);
}

// ********************************************************************

// retreived on 2007.03.25 from http://www.prowiki.org/wiki4d/wiki.cgi?L=
anguageSpecification/KeywordIndex
const keywordIndex =3D `
<tt>abstract</tt>
* [http://www.digitalmars.com/d/attribute.html#abstract Attributes]
<tt>alias</tt>
* [http://www.digitalmars.com/d/declaration.html#alias Declarations]
* template parameters: [http://www.digitalmars.com/d/template.html#alias=
parameters Templates]
<tt>align</tt>
* [http://www.digitalmars.com/d/attribute.html#align Attributes]
<tt>asm</tt>
* [http://www.digitalmars.com/d/statement.html#asm Statements]
* x86 inline assembler:  [http://www.digitalmars.com/d/iasm.html Inline =
Assembler]
<tt>assert</tt>
* [http://www.digitalmars.com/d/expression.html#AssertExpression Express=
ions]
* static assert:  [http://www.digitalmars.com/d/version.html#staticasser=
t Conditional Compilation]

<tt>auto</tt>
* class attribute:  [http://www.digitalmars.com/d/class.html#auto Classe=
s]
* RAII attribute:  [http://www.digitalmars.com/d/attribute.html#auto Att=
ributes]
* type inference:  [http://www.digitalmars.com/d/declaration.html#AutoDe=
claration Declarations]

----

<tt>body</tt>
* in function contract:  [http://www.digitalmars.com/d/dbc.html Contract=
s]

<tt>bool</tt>
* [http://www.digitalmars.com/d/type.html Types]

<tt>break</tt>
* in switch:  [http://www.digitalmars.com/d/statement.html#switch Statem=
ents]
* statement:  [http://www.digitalmars.com/d/statement.html#break Stateme=
nts]

<tt>byte</tt>
* [http://www.digitalmars.com/d/type.html Types]

----

<tt>case</tt>
* in switch:  [http://www.digitalmars.com/d/statement.html#switch Statem=
ents]

<tt>cast</tt>
* [http://www.digitalmars.com/d/expression.html#CastExpression Expressio=
ns]

<tt>catch</tt>
* [http://www.digitalmars.com/d/statement.html#try Statements]

<tt>cdouble</tt>
* [http://www.digitalmars.com/d/type.html Types]
* complex types:  [http://www.digitalmars.com/d/float.html Floating Poin=
t]

<tt>cent</tt>
* [http://www.digitalmars.com/d/type.html Types]

<tt>cfloat</tt>
* [http://www.digitalmars.com/d/type.html Types]
* complex types:  [http://www.digitalmars.com/d/float.html Floating Poin=
t]

<tt>char</tt>
* [http://www.digitalmars.com/d/type.html Types]

<tt>class</tt>
* [http://www.digitalmars.com/d/class.html Classes]
* properties of:  [http://www.digitalmars.com/d/property.html#classprope=
rties Properties]

<tt>const</tt>
* [http://www.digitalmars.com/d/attribute.html#const Attributes]

<tt>continue</tt>
* [http://www.digitalmars.com/d/statement.html#continue Statements]

<tt>creal</tt>
* [http://www.digitalmars.com/d/type.html Types]
* complex types:  [http://www.digitalmars.com/d/float.html Floating Poin=
t]

----

<tt>dchar</tt>
* [http://www.digitalmars.com/d/type.html Types]

<tt>debug</tt>
* [http://www.digitalmars.com/d/version.html#debug Conditional Compilati=
on]

<tt>default</tt>
* in switch:  [http://www.digitalmars.com/d/statement.html#switch Statem=
ents]

<tt>delegate</tt>
* as datatype and replacement for pointer-to-member-function:  [http://w=
ww.digitalmars.com/d/type.html#delegates Types]
* as dynamic closure:  [http://www.digitalmars.com/d/function.html#closu=
res Functions]
* in function literal:  [http://www.digitalmars.com/d/expression.html#Fu=
nctionLiteral Expressions]

<tt>delete</tt>
* expression:  [http://www.digitalmars.com/d/expression.html#DeleteExpre=
ssion Expressions]
* overloading:  [http://www.digitalmars.com/d/class.html#deallocators Cl=
asses]

<tt>deprecated</tt>
* [http://www.digitalmars.com/d/attribute.html#deprecated Attributes]

<tt>do</tt>
* [http://www.digitalmars.com/d/statement.html#do Statements]

<tt>double</tt>
* [http://www.digitalmars.com/d/type.html Types]
* floating point types:  [http://www.digitalmars.com/d/float.html Floati=
ng Point]

----

<tt>else</tt>
* [http://www.digitalmars.com/d/statement.html#if Statements]

<tt>enum</tt>
* [http://www.digitalmars.com/d/enum.html Enums]

<tt>export</tt>
* protection attribute:  [http://www.digitalmars.com/d/attribute.html At=
tributes]

<tt>extern</tt>
* linkage attribute:  [http://www.digitalmars.com/d/attribute.html#linka=
ge Attributes]
* interfacing to C:  [http://www.digitalmars.com/d/interfaceToC.html Int=
erfacing to C]
* in variable declaration:  [http://www.digitalmars.com/d/declaration.ht=
ml#extern Declarations]

----

<tt>false</tt>
* [http://www.digitalmars.com/d/expression.html#PrimaryExpression Expres=
sions]

<tt>final</tt>
* [http://www.digitalmars.com/d/function.html Functions]

<tt>finally</tt>
* [http://www.digitalmars.com/d/statement.html#try Statements]

<tt>float</tt>
* [http://www.digitalmars.com/d/type.html Types]
* floating point types:  [http://www.digitalmars.com/d/float.html Floati=
ng Point]

<tt>for</tt>
* [http://www.digitalmars.com/d/statement.html#for Statements]

<tt>foreach</tt>
* [http://www.digitalmars.com/d/statement.html#foreach Statements]

<tt>foreach_reverse</tt>
* [http://www.digitalmars.com/d/statement.html#foreach Statements]

<tt>function</tt>
* as datatype:  [http://www.digitalmars.com/d/type.html Types]
* in function literal:  [http://www.digitalmars.com/d/expression.html#Fu=
nctionLiteral Expressions]
* function pointers:  [http://www.digitalmars.com/d/function.html#closur=
es Functions]


----


<tt>goto</tt>
* [http://www.digitalmars.com/d/statement.html#goto Statements]


----


<tt>idouble</tt>
* [http://www.digitalmars.com/d/type.html Types]
* imaginary types:  [http://www.digitalmars.com/d/float.html Floating Po=
int]

<tt>if</tt>
* [http://www.digitalmars.com/d/statement.html#if Statements]
* static if:  [http://www.digitalmars.com/d/version.html#staticif Condit=
ional Compilation]

<tt>ifloat</tt>
* [http://www.digitalmars.com/d/type.html Types]
* imaginary types:  [http://www.digitalmars.com/d/float.html Floating Po=
int]

<tt>import</tt>
* [http://www.digitalmars.com/d/module.html#ImportDeclaration Modules]
* import expression:  [http://digitalmars.com/d/expression.html#ImportEx=
pression Expressions]

<tt>in</tt>
* in pre contract:  [http://www.digitalmars.com/d/dbc.html Contracts]
* containment test:  [http://www.digitalmars.com/d/expression.html#InExp=
ression Expressions]
* function parameter:  [http://www.digitalmars.com/d/function.html#param=
eters Functions]

<tt>inout</tt>
* in foreach statement:  [http://www.digitalmars.com/d/statement.html#fo=
reach Statements]
* function parameter:  [http://www.digitalmars.com/d/function.html#param=
eters Functions]

<tt>int</tt>
* [http://www.digitalmars.com/d/type.html Types]

<tt>interface</tt>
* [http://www.digitalmars.com/d/interface.html Interfaces]

<tt>invariant</tt>
* [http://www.digitalmars.com/d/class.html#invariants Classes]

<tt>ireal</tt>
* [http://www.digitalmars.com/d/type.html Types]
* imaginary types:  [http://www.digitalmars.com/d/float.html Floating Po=
int]

<tt>is</tt>
* identity comparison:  [http://www.digitalmars.com/d/expression.html#Eq=
ualExpression Expressions]
* type comparison:  [http://www.digitalmars.com/d/expression.html#IsExpr=
ession Expressions]


----


<tt>lazy</tt>
* function parameter:  [http://www.digitalmars.com/d/function.html#param=
eters Functions]

<tt>long</tt>
* [http://www.digitalmars.com/d/type.html Types]


----


<tt>mixin</tt>
* [http://www.digitalmars.com/d/template-mixin.html Template Mixins]
* Mixin declarations:  [http://digitalmars.com/d/module.html#MixinDeclar=
ation Modules]
* Mixin expressions:  [http://digitalmars.com/d/expression.html#MixinExp=
ression Expressions]
* Mixin statements:  [http://digitalmars.com/d/statement.html#MixinState=
ment Statements]

<tt>module</tt>
* [http://www.digitalmars.com/d/module.html Modules]


----


<tt>new</tt>
* anonymous nested classes and:  [http://www.digitalmars.com/d/class.htm=
l#anonymous Classes]
* expression:  [http://www.digitalmars.com/d/expression.html#NewExpressi=
on Expressions]
* overloading:  [http://www.digitalmars.com/d/class.html#allocators Clas=
ses]

<tt>null</tt>
* [http://www.digitalmars.com/d/expression.html#PrimaryExpression Expres=
sions]


----


<tt>out</tt>
* in post contract:  [http://www.digitalmars.com/d/dbc.html Contracts]
* function parameter:  [http://www.digitalmars.com/d/function.html#param=
eters Functions]

<tt>override</tt>
* [http://www.digitalmars.com/d/attribute.html#override Attributes]


----


<tt>package</tt>
* [http://www.digitalmars.com/d/attribute.html Attributes]

<tt>pragma</tt>
* [http://www.digitalmars.com/d/pragma.html Pragmas]

<tt>private</tt>
* and import:  [http://www.digitalmars.com/d/module.html Modules]
* protection attribute:  [http://www.digitalmars.com/d/attribute.html At=
tributes]

<tt>protected</tt>
* [http://www.digitalmars.com/d/attribute.html Attributes]

<tt>public</tt>
* [http://www.digitalmars.com/d/attribute.html Attributes]


----


<tt>real</tt>
* [http://www.digitalmars.com/d/type.html Types]
* floating point types:  [http://www.digitalmars.com/d/float.html Floati=
ng Point]

<tt>return</tt>
* [http://www.digitalmars.com/d/statement.html#return Statements]


----


<tt>scope</tt>
* statement: [http://www.digitalmars.com/d/statement.html#ScopeGuardStat=
ement Statements]
* RAII attribute:  [http://www.digitalmars.com/d/attribute.html#scope At=
tributes]

<tt>short</tt>
* [http://www.digitalmars.com/d/type.html Types]

<tt>static</tt>
* attribute:  [http://www.digitalmars.com/d/attribute.html Attributes]
* constructors:  [http://www.digitalmars.com/d/class.html#staticconstruc=
tor Classes]
* destructors:  [http://www.digitalmars.com/d/class.html#staticdestructo=
r Classes]
* order of static constructors and destructors:  [http://www.digitalmars=
.com/d/module.html#staticorder Modules]
* static assert:  [http://www.digitalmars.com/d/version.html#staticasser=
t Conditional Compilation]
* static if:  [http://www.digitalmars.com/d/version.html#staticif Condit=
ional Compilation]
* static import:  [http://www.digitalmars.com/d/module.html#ImportDeclar=
ation Modules]

<tt>struct</tt>
* [http://www.digitalmars.com/d/struct.html Structs & Unions]
* properties of:  [http://www.digitalmars.com/d/property.html#classprope=
rties Properties]

<tt>super</tt>
* [http://www.digitalmars.com/d/expression.html#PrimaryExpression Expres=
sions]
* as name of superclass constructor:  [http://www.digitalmars.com/d/clas=
s.html#constructors Classes]

<tt>switch</tt>
* [http://www.digitalmars.com/d/statement.html#switch Statements]

<tt>synchronized</tt>
* [http://www.digitalmars.com/d/statement.html#synchronize Statements]


----


<tt>template</tt>
* [http://www.digitalmars.com/d/template.html Templates]

<tt>this</tt>
* [http://www.digitalmars.com/d/expression.html#PrimaryExpression Expres=
sions]
* as constructor name:  [http://www.digitalmars.com/d/class.html#constru=
ctors Classes]
* with ~, as destructor name:  [http://www.digitalmars.com/d/class.html#=
destructors Classes]

<tt>throw</tt>
* [http://www.digitalmars.com/d/statement.html#throw Statements]

<tt>true</tt>
* [http://www.digitalmars.com/d/expression.html#PrimaryExpression Expres=
sions]

<tt>try</tt>
* [http://www.digitalmars.com/d/statement.html#try Statements]

<tt>typedef</tt>
* [http://www.digitalmars.com/d/declaration.html#typedef Declarations]

<tt>typeid</tt>
* [http://www.digitalmars.com/d/expression.html#typeidexpression Express=
ions]

<tt>typeof</tt>
* [http://www.digitalmars.com/d/declaration.html#typeof Declarations]


----


<tt>ubyte</tt>
* [http://www.digitalmars.com/d/type.html Types]

<tt>ucent</tt>
* [http://www.digitalmars.com/d/type.html Types]

<tt>uint</tt>
* [http://www.digitalmars.com/d/type.html Types]

<tt>ulong</tt>
* [http://www.digitalmars.com/d/type.html Types]

<tt>union</tt>
* [http://www.digitalmars.com/d/struct.html Structs & Unions]

<tt>unittest</tt>
* in classes:  [http://www.digitalmars.com/d/class.html#unittest Classes=
]

<tt>ushort</tt>
* [http://www.digitalmars.com/d/type.html Types]


----


<tt>version</tt>
* [http://www.digitalmars.com/d/version.html#version Conditional Compila=
tion]

<tt>void</tt>
* as initializer:  [http://www.digitalmars.com/d/declaration.html Declar=
ations]
* as type:  [http://www.digitalmars.com/d/type.html Types]

<tt>volatile</tt>
* [http://www.digitalmars.com/d/statement.html#volatile Statements]


----


<tt>wchar</tt>
* [http://www.digitalmars.com/d/type.html Types]

<tt>while</tt>
* [http://www.digitalmars.com/d/statement.html#while Statements]

<tt>with</tt>
* [http://www.digitalmars.com/d/statement.html#with Statements]



----

Source: Kirk <n>McDonald</n>, http://216.190.88.10:8087/media/d_index.ht=
ml (NG:digitalmars.D/38550)
`;
------------g19PGZO1aKfKN0WQ4xfX7G--
Mar 25 2007