[Lldb-commits] [PATCH] D112612: [lldb] [docs] Remove obsolete recommonmark use

Michał Górny via Phabricator via lldb-commits lldb-commits at lists.llvm.org
Wed Oct 27 04:33:08 PDT 2021


mgorny created this revision.
mgorny added reviewers: labath, teemperor.
mgorny requested review of this revision.

The recommonmark package is no longer required since all the documents
have been converted to .rst.  Remove the related support code from
docs/conf.py.


https://reviews.llvm.org/D112612

Files:
  lldb/docs/conf.py


Index: lldb/docs/conf.py
===================================================================
--- lldb/docs/conf.py
+++ lldb/docs/conf.py
@@ -61,21 +61,6 @@
     '.rst': 'restructuredtext',
 }
 
-try:
-  import recommonmark
-except ImportError:
-  # manpages do not use any .md sources
-  if not building_man_page:
-    raise
-else:
-  import sphinx
-  if sphinx.version_info >= (3, 0):
-    # This requires 0.5 or later.
-    extensions.append('recommonmark')
-  else:
-    source_parsers = {'.md': 'recommonmark.parser.CommonMarkParser'}
-  source_suffix['.md'] = 'markdown'
-
 # The encoding of source files.
 #source_encoding = 'utf-8-sig'
 
@@ -285,20 +270,6 @@
 # If true, show URL addresses after external links.
 #man_show_urls = False
 
-def process_md(name):
-    file_subpath = os.path.join(command_guide_subpath, name)
-    with open(os.path.join(command_guide_path, name)) as f:
-        title = f.readline().rstrip('\n')
-
-        m = re.match(r'^# (\S+) - (.+)$', title)
-        if m is None:
-            print("error: invalid title in %r "
-                  "(expected '# <name> - <description>')" % file_subpath,
-                  file=sys.stderr)
-        else:
-            man_pages.append((file_subpath.replace('.md',''), m.group(1),
-                              m.group(2), man_page_authors, 1))
-
 # -- Options for Texinfo output ------------------------------------------------
 
 # Grouping the document tree into Texinfo files. List of tuples


-------------- next part --------------
A non-text attachment was scrubbed...
Name: D112612.382604.patch
Type: text/x-patch
Size: 1475 bytes
Desc: not available
URL: <http://lists.llvm.org/pipermail/lldb-commits/attachments/20211027/e03e86d7/attachment.bin>


More information about the lldb-commits mailing list