[libcxx-commits] [PATCH] D111926: [libc++][doc] Use sphinx variables to make updating the docs version easier

Tom Stellard via Phabricator via libcxx-commits libcxx-commits at lists.llvm.org
Fri Oct 15 23:00:56 PDT 2021


tstellar updated this revision to Diff 380142.
tstellar added a comment.

Add some more changes.


Repository:
  rG LLVM Github Monorepo

CHANGES SINCE LAST ACTION
  https://reviews.llvm.org/D111926/new/

https://reviews.llvm.org/D111926

Files:
  libcxx/docs/ReleaseNotes.rst
  libcxx/docs/conf.py


Index: libcxx/docs/conf.py
===================================================================
--- libcxx/docs/conf.py
+++ libcxx/docs/conf.py
@@ -48,9 +48,10 @@
 # built documents.
 #
 # The short X.Y version.
-version = '14.0'
+version_major = '14'
+version = version_major + '.0.0'
 # The full version, including alpha/beta/rc tags.
-release = '14.0'
+release = version + 'git'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -86,6 +87,15 @@
 # A list of ignored prefixes for module index sorting.
 #modindex_common_prefix = []
 
+in_progress_title = "(In-Progress) " if version != release else ""
+in_progress = 'in-progress' if version != release else ""
+
+rst_epilog = f"""
+.. |version| replace:: {version}
+.. |version_major| replace:: {version_major}
+.. |InProgressTitle| replace:: {in_progress_title}
+.. |InProgress| replace:: {in_progress}
+"""
 
 # -- Options for HTML output ---------------------------------------------------
 
Index: libcxx/docs/ReleaseNotes.rst
===================================================================
--- libcxx/docs/ReleaseNotes.rst
+++ libcxx/docs/ReleaseNotes.rst
@@ -1,6 +1,6 @@
-=========================================
-Libc++ 14.0.0 (In-Progress) Release Notes
-=========================================
+================================================
+Libc++ |version| |InProgressTitle| Release Notes
+================================================
 
 .. contents::
    :local:
@@ -10,7 +10,7 @@
 
 .. warning::
 
-   These are in-progress notes for the upcoming libc++ 14 release.
+   These are |InProgress| notes for the upcoming libc++ |version_major| release.
    Release notes for previous releases can be found on
    `the Download Page <https://releases.llvm.org/download.html>`_.
 
@@ -18,7 +18,7 @@
 ============
 
 This document contains the release notes for the libc++ C++ Standard Library,
-part of the LLVM Compiler Infrastructure, release 14.0.0. Here we describe the
+part of the LLVM Compiler Infrastructure, release |version|. Here we describe the
 status of libc++ in some detail, including major improvements from the previous
 release and new feature work. For the general LLVM release notes, see `the LLVM
 documentation <https://llvm.org/docs/ReleaseNotes.html>`_. All LLVM releases may
@@ -32,8 +32,8 @@
 the current one. To see the release notes for a specific release, please
 see the `releases page <https://llvm.org/releases/>`_.
 
-What's New in Libc++ 14.0.0?
-============================
+What's New in Libc++ |version|?
+===============================
 
 New Features
 ------------


-------------- next part --------------
A non-text attachment was scrubbed...
Name: D111926.380142.patch
Type: text/x-patch
Size: 2648 bytes
Desc: not available
URL: <http://lists.llvm.org/pipermail/libcxx-commits/attachments/20211016/912b4c77/attachment.bin>


More information about the libcxx-commits mailing list