958131ca10
According to the Asciidoctor docs, we can assign multiple anchors
to a section using this method, which still uses the modern shorthand
syntax for the main anchor (the one that's been used for the last five
years). We have to use the double square brackets for the additional
anchor, though.
https://docs.asciidoctor.org/asciidoc/latest/attributes/id/#add-additional-anchors-to-a-section
Related to #17982
47 lines
1.2 KiB
Python
Executable file
47 lines
1.2 KiB
Python
Executable file
#!/usr/bin/env python3
|
|
# Wireshark - Network traffic analyzer
|
|
# By Gerald Combs <gerald@wireshark.org>
|
|
# Copyright 1998 Gerald Combs
|
|
#
|
|
# SPDX-License-Identifier: GPL-2.0-or-later
|
|
|
|
'''
|
|
Go through all user guide help URLs listed in the program
|
|
and confirm these are present in the User's Guide source files.
|
|
'''
|
|
|
|
from re import search
|
|
from glob import glob
|
|
from sys import exit
|
|
|
|
found = {}
|
|
|
|
with open("ui/help_url.c") as f:
|
|
for line in f:
|
|
if url := search(r"user_guide_url\(\"(.*).html\"\);", line):
|
|
chapter = url.group(1)
|
|
found[chapter] = False
|
|
|
|
adoc_files = glob("docbook/wsug_src/*.adoc")
|
|
|
|
for adoc_file in adoc_files:
|
|
with open(adoc_file) as f:
|
|
for line in f:
|
|
# Fail on legacy block anchor syntax (double square brackets)
|
|
if tag := search(r"^\[\#(.*)]", line):
|
|
chapter = tag.group(1)
|
|
if chapter in found:
|
|
found[chapter] = True
|
|
|
|
missing = False
|
|
|
|
for chapter in found:
|
|
if not found[chapter]:
|
|
if not missing:
|
|
print("The following chapters are missing in the User's Guide:")
|
|
missing = True
|
|
print(chapter)
|
|
|
|
if missing:
|
|
exit(-1)
|