Changes

The instances of <tt>\<i>section</i></tt> are used for ..produce a sectioning title.

<cd:constant value="part">highest level of sectioning</cd:constant> <cd:constant value="chapter">level 2</cd:constant> <cd:constant value="section">level 3</cd:constant> <cd:constant value="subsection">level 4</cd:constant> <cd:constant value="subsubsection">level 5</cd:constant> <cd:constant value="subsubsubsection">level 6</cd:constant> <cd:constant value="subsubsubsubsection">level 7</cd:constant> <cd:constant value="title">level 2, unnumbered</cd:constant> <cd:constant value="subject">level 3, unnumbered</cd:constant> <cd:constant value="subsubject">level 4, unnumbered</cd:constant> <cd:constant value="subsubsubject">level 5, unnumbered</cd:constant> <cd:constant value="subsubsubsubject">level 6, unnumbered</cd:constant> <cd:constant value="subsubsubsubsubject">level 7, unnumbered</cd:constant>

<cd:constant type="cd:reference">Optional reference for referring to this sectioning head from elsewhere in the document</cd:constant>

<cd:constant type="cd:text">The title to be typeset. Any numbering will be added automatically</cd:constant>

<cd:paramdoc>The title to be typeset</cd:paramdoc>

<cd:paramdoc>The text for use in the table of contents and PDF bookmarks</cd:paramdoc>

<cd:paramdoc>The text to use for subsequent use in header or footers</cd:paramdoc>

<cd:paramdoc>A list to use instead of the standard list (same name as command itself)</cd:paramdoc>

<cd:paramdoc>A label to refer back to</cd:paramdoc>

<cd:paramdoc>Force a number</cd:paramdoc>

<cd:paramdoc>Note sure what this does</cd:paramdoc>

<cd:keywordsdoc>A label to refer back to</cd:keywordsdoc>

<cd:keywordsdoc>A forced number</cd:keywordsdoc>

<cd:keywordsdoc>The title to be typeset</cd:keywordsdoc>

<!-- Any of the three macro calls above can be used. The [[#Settings instance:assignment]] gives the long description of most control. You can define heads yourself with {{cmd|definehead}}. You can change the command goes here --appearance with {{cmd|setuphead}}. <i>Note:</i>these instances are superseded by environments with the same basic name, see {{gen|startsection}}.

<cd:example><context source="yes" text="produces"> \setuphead[chapter][page=no] \starttext \chapter{Once Upon A Time} This is the simplest form of using a chapter. \chapter[mykey]{Once Upon A Time 2} But what if you want to refer to this chapter at another time? Give it a key!-- command Before the chapter put something between brackets. That's your key. Now you can refer to it. See the next chapter,\in{chapter}[next]. \chapter[next]{After A While} As we said earlier in chapter \in[mykey], we ... As this example shows, use $\backslash$in[...] to refer to a chapter with that name. \stoptext </context></cd:example><cd:example title="Parts">By default {{cmd|part}} generates no title because most of the times these require special attention and a specific design. In the background however the part numbering is active and carries out several initialisations. The other section commands ''are'' set up to typeset a title. <context source="yes">\setuppapersize[A7] \part{One} % not typeset ...\chapter{My chapter} % ... but this is Chapter 1 in Part 1 \part{Two}\chapter{My chapter} % ... and this is Chapter 1 in Part 1 </context></cd:example><cd:exampletitle="Unnumbered section heads">To remove the section number (sas might be needed for Introduction)use one of the unnumbered instances (for example, use {{cmd|subject}} instead of {{cmd|section}}, or utilise the fact that no section numbers are used in the front matter: <texcode>\starttext \startfrontmatter \section{Introduction} % not numbered  ...\stopfrontmatter \startbodymatter \section{Problem Statement} % numbered ...\stopbodymatter \stoptext </texcode></cd:example><cd:example title="Use of ''ownnumber''">The options <cd:iref variant='instance:assignment' ordinal='1' name='ownnumber'/> and <cd:iref variant='instance:ownnumber' ordinal='2'/> both allow you to insert a specific number. Behind the scenes, numbering continues as normal:<context source="yes">\section[title={My first section}]\section[title={My section},ownnumber={4}]\section[title={My third section}]</context>