Microsoft Corporation 1999-2012. All Rights Reserved.
18.7.1 Fixed size buffer declarations .......................................................................................................... 499
18.7.2 Fixed size buffers in expressions ..................................................................................................... 501
18.7.3 Definite assignment checking .......................................................................................................... 501
18.8 Stack allocation ....................................................................................................................................... 502
18.9 Dynamic memory allocation ................................................................................................................... 503
A. Documentation comments ........................................................................................................................... 507
A.1 Introduction .............................................................................................................................................. 507
A.2 Recommended tags ................................................................................................................................. 508
A.2.1 <c> ....................................................................................................................................................... 509
A.2.2 <code> ................................................................................................................................................ 510
A.2.3 <example> .......................................................................................................................................... 510
A.2.4 <exception> ....................................................................................................................................... 510
A.2.5 <include> ............................................................................................................................................ 511
A.2.6 <list> ................................................................................................................................................... 512
A.2.7 <para> ................................................................................................................................................. 513
A.2.8 <param> ............................................................................................................................................. 513
A.2.9 <paramref> ........................................................................................................................................ 514
A.2.10 <permission> .................................................................................................................................... 514
A.2.11 <remark> ........................................................................................................................................... 515
A.2.12 <returns> ........................................................................................................................................... 515
A.2.13 <see> ................................................................................................................................................. 515
A.2.14 <seealso> .......................................................................................................................................... 516
A.2.15 <summary> ....................................................................................................................................... 516
A.2.16 <value> .............................................................................................................................................. 517
A.2.17 <typeparam>..................................................................................................................................... 517
A.2.18 <typeparamref> ............................................................................................................................... 517
A.3 Processing the documentation file ......................................................................................................... 518
A.3.1 ID string format .................................................................................................................................. 518
A.3.2 ID string examples ............................................................................................................................. 519
A.4 An example ............................................................................................................................................... 523
A.4.1 C# source code ................................................................................................................................... 523
A.4.2 Resulting XML .................................................................................................................................... 526
B. Grammar ........................................................................................................................................................ 530
B.1 Lexical grammar ........................................................................................................................................ 530
B.1.1 Line terminators .................................................................................................................................. 530
B.1.2 Comments ........................................................................................................................................... 530
B.1.3 White space ........................................................................................................................................ 531
B.1.4 Tokens ................................................................................................................................................. 531
B.1.5 Unicode character escape sequences ............................................................................................... 531
B.1.6 Identifiers ........................................................................................................................................... 531
B.1.7 Keywords ............................................................................................................................................ 533
B.1.8 Literals ................................................................................................................................................ 533
B.1.9 Operators and punctuators ............................................................................................................... 535
B.1.10 Pre-processing directives ................................................................................................................. 535
B.2 Syntactic grammar ................................................................................................................................... 538
B.2.1 Basic concepts .................................................................................................................................... 538