@@ 121,8 121,8 @@ Tags behave as follows:
==== Syntax definitions
-Syntax definitions accept the same tags and is defined equivalently to
-procedures, provided that it is is defined using {{define-syntax}}. The
+Syntax definitions accept the same tags and are defined equivalently to
+procedures, provided that it they are defined using {{define-syntax}}. The
{{@sig}} tag is especially useful for specifying syntax usage, since chalk
won't automatically detect the signature. Here's a rather silly example:
@@ 150,8 150,8 @@ in the first position of the docexpr.
Currently, two types of record definitions are supported - {{define-record}}
and {{define-record-type}} from {{chicken.base}}. Records can be documented
-internally by specifying a {{@internal}} file, and they accept one more tag
-{{@full}}. When specified, it generates a list of all of the procedures
+internally by specifying a {{@internal}} file, and they additionally accept the
+tag {{@full}}. When specified, it generates a list of all of the procedures
associated with that record definition. Otherwise, only the record name is
documented, and procedure documentation can be added manually.