Commit a31d96dc authored by Fred Drake's avatar Fred Drake

- fill in the description of the keytype attribute for schema and sectiontype

- normalize some markup usage
parent 7cca64f9
...@@ -290,13 +290,18 @@ The following elements are used to describe a schema: ...@@ -290,13 +290,18 @@ The following elements are used to describe a schema:
section. section.
\end{attributedesc} \end{attributedesc}
\begin{attributedesc}{handler}{\strong{basic-key}} \begin{attributedesc}{handler}{\datatype{basic-key}}
\end{attributedesc} \end{attributedesc}
\begin{attributedesc}{keytype}{\strong{basic-key}} \begin{attributedesc}{keytype}{\datatype{basic-key}}
The data type converter which will be applied to keys found in
this section. This can be used to constrain key values in
different ways; two data types which may be especially useful are
the \datatype{identifier} and \datatype{ipaddr-or-hostname}
types. The default value is \datatype{basic-key}.
\end{attributedesc} \end{attributedesc}
\begin{attributedesc}{prefix}{\strong{dotted-name}} \begin{attributedesc}{prefix}{\datatype{dotted-name}}
\end{attributedesc} \end{attributedesc}
\end{elementdesc} \end{elementdesc}
...@@ -362,14 +367,19 @@ The following elements are used to describe a schema: ...@@ -362,14 +367,19 @@ The following elements are used to describe a schema:
directly in a schema or other section type. directly in a schema or other section type.
\end{attributedesc} \end{attributedesc}
\begin{attributedesc}{keytype}{\strong{basic-key}} \begin{attributedesc}{keytype}{\datatype{basic-key}}
The data type converter which will be applied to keys found in
this section. This can be used to constrain key values in
different ways; two data types which may be especially useful are
the \datatype{identifier} and \datatype{ipaddr-or-hostname}
types. The default value is \datatype{basic-key}.
\end{attributedesc} \end{attributedesc}
\begin{attributedesc}{name}{\datatype{basic-key}} \begin{attributedesc}{name}{\datatype{basic-key}}
The name of the section type; required. The name of the section type; required.
\end{attributedesc} \end{attributedesc}
\begin{attributedesc}{prefix}{\strong{dotted-name}} \begin{attributedesc}{prefix}{\datatype{dotted-name}}
\end{attributedesc} \end{attributedesc}
\end{elementdesc} \end{elementdesc}
...@@ -627,14 +637,14 @@ components and schema component extensions. ...@@ -627,14 +637,14 @@ components and schema component extensions.
\begin{elementdesc}{component}{description?, (abstracttype | sectiontype)*} \begin{elementdesc}{component}{description?, (abstracttype | sectiontype)*}
The top-level element for schema components. The top-level element for schema components.
\begin{attributedesc}{prefix}{\strong{dotted-name}} \begin{attributedesc}{prefix}{\datatype{dotted-name}}
\end{attributedesc} \end{attributedesc}
\end{elementdesc} \end{elementdesc}
\begin{elementdesc}{extensions}{description?, (abstracttype | sectiontype)*} \begin{elementdesc}{extensions}{description?, (abstracttype | sectiontype)*}
The top-level element for schema component extensions. The top-level element for schema component extensions.
\begin{attributedesc}{prefix}{\strong{dotted-name}} \begin{attributedesc}{prefix}{\datatype{dotted-name}}
\end{attributedesc} \end{attributedesc}
\end{elementdesc} \end{elementdesc}
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment