docs: def special_links_replace(text, urls):
      '''
      Replace simplified Regulations and Guidelines links into actual links.
      'urls' dictionary is expected to provide actual links to the targeted
      Regulations and Guidelines, as well as to the PDF file.
      '''
      match_number = r'([A-Za-z0-9]+)' + r'(\+*)'
      reference_list = [(r'regulations:article:' + match_number, urls['regulations']),
                        (r'regulations:regulation:' + match_number, urls['regulations']),
                        (r'guidelines:article:' + match_number, urls['guidelines']),
                        (r'guidelines:guideline:' + match_number, urls['guidelines']),
                       ]
      anchor_list = [(r'regulations:contents', urls['regulations'] + r'#contents'),
                     (r'guidelines:contents', urls['guidelines'] + r'#contents'),
                     (r'regulations:top', urls['regulations'] + r'#'),
                     (r'guidelines:top', urls['guidelines'] + r'#'),
                     (r'link:pdf', urls['pdf'] + '.pdf'),
                    ]
      retval = text
      for match, repl in reference_list:
          retval = re.sub(match, repl + r'#\1\2', retval)
      for match, repl in anchor_list:
          retval = re.sub(match, repl, retval)
      return retval