net/ynl/ynl-gen-rst.py

109     lines.append(rst_paragraph(".. SPDX-License-Identifier: GPL-2.0"))
110     lines.append(rst_paragraph(".. NOTE: This document was auto-generated.\n\n"))
119     lines.append(".. toctree::")
120     lines.append(f"   :maxdepth: {maxdepth}\n\n")
138         lines.append(rst_bullet(group["name"]))
147         lines.append(rst_paragraph(bold(key), level + 1))
148         lines.append(parse_do_attributes(do_dict[key], level + 1) + "\n")
168         lines.append(rst_section(operation["name"]))
169         lines.append(rst_paragraph(sanitize(operation["doc"])) + "\n")
175             lines.append(rst_fields(key, operation[key], 0))
178             lines.append(rst_paragraph(":do:", 0))
179             lines.append(parse_do(operation["do"], 0))
181             lines.append(rst_paragraph(":dump:", 0))
182             lines.append(parse_do(operation["dump"], 0))
185         lines.append("\n")
203             lines.append(
207             lines.append(rst_list_inline(entry, level))
209             lines.append(rst_bullet(inline(sanitize(entry)), level))
211     lines.append("\n")
222         lines.append(rst_section(definition["name"]))
226             lines.append(rst_fields(k, sanitize(definition[k]), 0))
229         lines.append("\n")
231             lines.append(rst_paragraph(":entries:", 0))
232             lines.append(parse_entries(definition["entries"], 1))
234             lines.append(rst_paragraph(":members:", 0))
235             lines.append(parse_entries(definition["members"], 1))
247         lines.append(rst_section(entry["name"]))
255             lines.append(rst_subsubsection(attr_line))
260                 lines.append(rst_fields(k, sanitize(attr[k]), 0))
261             lines.append("\n")
271         lines.append(rst_section(entry["name"]))
275             lines.append(rst_bullet(bold(value)))
278                     lines.append(rst_fields(attr, fmt[attr], 1))
279             lines.append("\n")
290     lines.append(rst_header())
293     lines.append(rst_title(title))
294     lines.append(rst_paragraph(".. contents::\n"))
297         lines.append(rst_subtitle("Summary"))
298         lines.append(rst_paragraph(obj["doc"], 0))
302         lines.append(rst_subtitle("Operations"))
303         lines.append(parse_operations(obj["operations"]["list"]))
307         lines.append(rst_subtitle("Multicast groups"))
308         lines.append(parse_mcast_group(obj["mcast-groups"]["list"]))
312         lines.append(rst_subtitle("Definitions"))
313         lines.append(parse_definitions(obj["definitions"]))
317         lines.append(rst_subtitle("Attribute sets"))
318         lines.append(parse_attr_sets(obj["attribute-sets"]))
322         lines.append(rst_subtitle("Sub-messages"))
323         lines.append(parse_sub_messages(obj["sub-messages"]))
386     lines.append(rst_header())
387     lines.append(rst_label("specs"))
388     lines.append(rst_title("Netlink Family Specifications"))
389     lines.append(rst_toctree(1))
396         lines.append(f"   {filename.replace('.rst', '')}\n")