[libcxx-commits] [libcxx] 0a1c94f - [libc++][docs] Change some words to use reST inline literals

Fangrui Song via libcxx-commits libcxx-commits at lists.llvm.org
Mon Feb 7 10:00:46 PST 2022


Author: Fangrui Song
Date: 2022-02-07T10:00:42-08:00
New Revision: 0a1c94f915b6177bf848398a8ae24710d1f34155

URL: https://github.com/llvm/llvm-project/commit/0a1c94f915b6177bf848398a8ae24710d1f34155
DIFF: https://github.com/llvm/llvm-project/commit/0a1c94f915b6177bf848398a8ae24710d1f34155.diff

LOG: [libc++][docs] Change some words to use reST inline literals

Reviewed By: #libc, ldionne, Quuxplusone

Differential Revision: https://reviews.llvm.org/D119052

Added: 
    

Modified: 
    libcxx/docs/DesignDocs/UnspecifiedBehaviorRandomization.rst

Removed: 
    


################################################################################
diff  --git a/libcxx/docs/DesignDocs/UnspecifiedBehaviorRandomization.rst b/libcxx/docs/DesignDocs/UnspecifiedBehaviorRandomization.rst
index 783950b3bc12e..7e92e27120b5a 100644
--- a/libcxx/docs/DesignDocs/UnspecifiedBehaviorRandomization.rst
+++ b/libcxx/docs/DesignDocs/UnspecifiedBehaviorRandomization.rst
@@ -35,7 +35,7 @@ to gradually fix their tests while updating to new faster algorithms.
 Design
 ======
 
-* Introduce new macro `_LIBCPP_DEBUG_RANDOMIZE_UNSPECIFIED_STABILITY` which should
+* Introduce new macro ``_LIBCPP_DEBUG_RANDOMIZE_UNSPECIFIED_STABILITY`` which should
   be a part of the libcxx config.
 * This macro randomizes the unspecified behavior of algorithms and containers.
   For example, for sorting algorithm the input range is shuffled and then
@@ -43,14 +43,14 @@ Design
 * This macro is off by default because users should enable it only for testing
   purposes and/or migrations if they happen to libcxx.
 * This feature is only available for C++11 and further because of
-  `std::shuffle` availability.
+  ``std::shuffle`` availability.
 * We may use `ASLR <https://en.wikipedia.org/wiki/Address_space_layout_randomization>`_ or
-  static `std::random_device` for seeding the random number generator. This
+  static ``std::random_device`` for seeding the random number generator. This
   guarantees the same stability guarantee within a run but not through 
diff erent
   runs, for example, for tests become flaky and eventually be seen as broken.
   For platforms which do not support ASLR, the seed is fixed during build.
 * The users can fix the seed of the random number generator by providing
-  `_LIBCPP_RANDOMIZE_UNSPECIFIED_STABILITY_SEED=seed` definition.
+  ``_LIBCPP_RANDOMIZE_UNSPECIFIED_STABILITY_SEED=seed`` definition.
 
 This comes with some side effects if any of the flags is on:
 
@@ -77,10 +77,10 @@ results, for example, for caching.
 Currently supported randomization
 ---------------------------------
 
-* `std::sort`, there is no guarantee on the order of equal elements
-* `std::partial_sort`, there is no guarantee on the order of equal elements and
+* ``std::sort``, there is no guarantee on the order of equal elements
+* ``std::partial_sort``, there is no guarantee on the order of equal elements and
    on the order of the remaining part
-* `std::nth_element`, there is no guarantee on the order from both sides of the
+* ``std::nth_element``, there is no guarantee on the order from both sides of the
    partition
 
 Patches welcome.


        


More information about the libcxx-commits mailing list