Lines Matching full:section
75 qapi-code-gen.rst section "Schema Syntax" for the exact syntax.
510 # Non-blank line, first of a section
536 "description of '@%s:' follows a section"
551 # tagged section
554 # rST markup and not interpreted as a section heading.
563 f"The '{match.group(1)}' section is no longer "
572 f"The '{match.group(1)}' section is no longer "
628 * a body section: one line naming the definition, followed by an
638 Free-form documentation blocks consist only of a body section.
657 class Section: class in QAPIDoc
664 # section source info, i.e. where it begins
666 # section kind
668 # section text without tag
672 return f"<QAPIDoc.Section kind={self.kind!r} text={self.text!r}>"
677 class ArgSection(Section):
697 self.all_sections: List[QAPIDoc.Section] = [
698 QAPIDoc.Section(info, QAPIDoc.Kind.PLAIN)
700 # the body section
701 self.body: Optional[QAPIDoc.Section] = self.all_sections[0]
705 # a command's "Returns" and "Errors" section
706 self.returns: Optional[QAPIDoc.Section] = None
707 self.errors: Optional[QAPIDoc.Section] = None
708 # "Since" section
709 self.since: Optional[QAPIDoc.Section] = None
711 self.sections: List[QAPIDoc.Section] = []
714 for section in self.all_sections:
715 section.text = section.text.strip('\n')
716 if section.kind != QAPIDoc.Kind.PLAIN and section.text == '':
718 section.info, "text required after '%s:'" % section.kind)
724 # extend current section
725 section = self.all_sections[-1]
726 if not section.text:
727 # Section is empty so far; update info to start *here*.
728 section.info = info
729 section.text += '\n'
732 # start new section
733 section = self.Section(info, kind)
734 self.sections.append(section)
735 self.all_sections.append(section)
742 section = self.Section(info, kind)
746 info, "duplicated '%s' section" % kind)
747 self.returns = section
751 info, "duplicated '%s' section" % kind)
752 self.errors = section
756 info, "duplicated '%s' section" % kind)
757 self.since = section
758 self.sections.append(section)
759 self.all_sections.append(section)
772 section = self.ArgSection(info, kind, name)
773 self.all_sections.append(section)
774 desc[name] = section
792 # Insert stub documentation section for missing member docs.
795 section = QAPIDoc.ArgSection(
797 self.args[member.name] = section
800 # end of the members section(s), if any. Note that index 0
801 # is assumed to be an untagged intro section, even if it is
807 self.all_sections.insert(index, section)
823 "'Returns' section, but command doesn't return anything")
828 "'Returns' section is only valid for commands")
832 "'Errors' section is only valid for commands")
839 bogus = [name for name, section in args.items()
840 if not section.member]