+ The contents element is used as a marker to specify + that an automatically generated contents page (listing the + chapters in the document) is to be inserted. +
After the front part of the document body comes a mandatory sequence of one or more chapters. This is where the main part of the document resides. + Each chapter consists of a + heading, any number + of blocks of information, and any number of sections.
+ The index element is used as a marker to specify + that an automatically generated index is to be inserted. + The type attribute of the index specifies what sort + of item is to be in the index - the default type of label + causes an index of all label and entry + elements to be generated. +
+ Actually, there is no such thing as a block element, this + is just shorthand for refering to a group of elements that can be + used in similar ways. The block elements are - +
++ The br element is an empty element that always appears + as <br/> in the document. This element simply specifies + that a line-break should appear in the output text at this point. +
++ This is the basic unit of the document - the main part of + a document body will contain at least + one chapter. + Each chapter consists of a heading, + zero or more blocks, + and zero or more sections. +
++ Each chapter in the document is automatically listed in the + documents contents page (if it has one). +
++ This is the main element for Objective-C code documentation. + The name attribute is required for this element - it is + the name of the class. The super attribute is normally + necessary to provide the name of the superclass. +
++ The elements in a class are - an optional + declared element, + zero or more conform element, + an optional description, + zero or more method elements, + and an optional standards element. +
++ This element contains simple text giving the name of a protocol + or interface to which a class conforms. +
++ This element contains simple text giving the name of the header + file in which something is declared. +
++ This element is used to contain descriptions of how software + functions. It may contain text, but may + also contain lists, + paragraphs, + examples and + embedded data. +
++ Each chapter, + section + sub-section, + or sub-sub-section + has a heading as the first thing in it. + These headings introduce the sections and are listed in the + contents page. +
++ The paragraph element simply contains text. + Most descriptive writing is inside paragraphs. +
++ The section element is just like a + chapter, except that it contains + sub-sections where a chapter would + contain sections. +
+
+ The standards element contains any number of
+ standard elements whioch specify what standards a particular
+ piece of code does or does not conform to.
+
+ The defined values are -
+
+ The subsect element is just like a + section, except that it contains + sub-sub-sections where a section would + contain sub-sections. +
++ The subsubsect element is just like a + sub-section, except that it contains + only a heading and zero or more + blocks. +
++ This is not really an element, we simply talk about text where + we mean raw text and very simple markup such as - +
+