Rix URL's in Rust course

Author: frank-at-adacore

courses/comprehensive_rust_training/020_hello_world/03_playground.rst

@@ -6,7 +6,7 @@ Playground
 Playground
 ------------
 
-The `Rust Playground <https://play.rust-lang.org/>`__ provides an easy
+The :url:`Rust Playground <https://play.rust-lang.org/>` provides an easy
 way to run short Rust programs, and is the basis for the examples and
 exercises in this course. Try running the "hello-world" program it
 starts with. It comes with a few handy features:

courses/comprehensive_rust_training/030_types_and_values/01_hello_world.rst

@@ -43,7 +43,7 @@ Key points:
 
 -  Rust uses macros for situations where you want to have a variable
    number of arguments (no function
-   `overloading <../control-flow-basics/functions.md>`__).
+   :url:`overloading <../control-flow-basics/functions.md>`).
 
 -  Macros being 'hygienic' means they don't accidentally capture
    identifiers from the scope they are used in. Rust macros are actually

courses/comprehensive_rust_training/040_control_flow_basics/01_if.rst

@@ -7,7 +7,7 @@
 --------------------
 
 You use
-`if expressions <https://doc.rust-lang.org/reference/expressions/if-expr.html#if-expressions>`__
+:url:`if expressions <https://doc.rust-lang.org/reference/expressions/if-expr.html#if-expressions>`
 exactly like ``if`` statements in other languages:
 
 .. code:: rust,editable

courses/comprehensive_rust_training/040_control_flow_basics/03_loops.rst

@@ -14,7 +14,7 @@ There are three looping keywords in Rust: ``while``, ``loop``, and
 -----------
 
 The
-`while keyword <https://doc.rust-lang.org/reference/expressions/loop-expr.html#predicate-loops>`__
+:url:`while keyword <https://doc.rust-lang.org/reference/expressions/loop-expr.html#predicate-loops>`
 works much like in other languages, executing the loop body as long as
 the condition is true.
 

courses/comprehensive_rust_training/040_control_flow_basics/04_break_continue.rst

@@ -7,10 +7,10 @@
 ----------------------------
 
 If you want to immediately start the next iteration use
-`continue <https://doc.rust-lang.org/reference/expressions/loop-expr.html#continue-expressions>`__.
+:url:`continue <https://doc.rust-lang.org/reference/expressions/loop-expr.html#continue-expressions>`.
 
 If you want to exit any kind of loop early, use
-`break <https://doc.rust-lang.org/reference/expressions/loop-expr.html#break-expressions>`__.
+:url:`break <https://doc.rust-lang.org/reference/expressions/loop-expr.html#break-expressions>`.
 With ``loop``, this can take an optional expression that becomes the
 value of the ``loop`` expression.
 

courses/comprehensive_rust_training/040_control_flow_basics/07_macros.rst

@@ -12,7 +12,7 @@ end. The Rust standard library includes an assortment of useful macros.
 
 -  ``println!(format, ..)`` prints a line to standard output, applying
    formatting described in
-   `std::fmt <https://doc.rust-lang.org/std/fmt/index.html>`__.
+   :url:`std::fmt <https://doc.rust-lang.org/std/fmt/index.html>`.
 -  ``format!(format, ..)`` works just like ``println!`` but returns the
    result as a string.
 -  ``dbg!(expression)`` logs the value of the expression and returns it.

courses/comprehensive_rust_training/040_control_flow_basics/08_exercise.rst

@@ -7,7 +7,7 @@ Exercise: Collatz Sequence
 ----------------------------
 
 The
-`Collatz Sequence <https://en.wikipedia.org/wiki/Collatz_conjecture>`__ is
+:url:`Collatz Sequence <https://en.wikipedia.org/wiki/Collatz_conjecture>` is
 defined as follows, for an arbitrary n1 greater than zero:
 
 -  If *ni* is 1, then the sequence terminates at *ni*.

courses/comprehensive_rust_training/070_user_defined_types/02_tuple_structs.rst

@@ -66,7 +66,7 @@ Details
    -  Operator overloading is discussed on Day 3 (generics).
 
 -  The example is a subtle reference to the
-   `Mars Climate Orbiter <https://en.wikipedia.org/wiki/Mars_Climate_Orbiter>`__
+   :url:`Mars Climate Orbiter <https://en.wikipedia.org/wiki/Mars_Climate_Orbiter>`
    failure.
 
 .. raw:: html

courses/comprehensive_rust_training/070_user_defined_types/03_enums.rst

@@ -93,7 +93,7 @@ Rust has several optimizations it can employ to make enums take up less
 space.
 
 -  Null pointer optimization: For
-   `some types <https://doc.rust-lang.org/std/option/#representation>`__, Rust
+   :url:`some types <https://doc.rust-lang.org/std/option/#representation>`, Rust
    guarantees that ``size_of::<T>()`` equals ``size_of::<Option<T>>()``.
 
    Example code if you want to show how the bitwise representation *may*

courses/comprehensive_rust_training/070_user_defined_types/04_aliases.rst

@@ -29,7 +29,7 @@ interchangeably.
 Details
 ---------
 
--  A `newtype <tuple-structs.html>`__ is often a better alternative
+-  A :url:`newtype <tuple-structs.html>` is often a better alternative
    since it creates a distinct type. Prefer
    ``struct InventoryCount(usize)`` to ``type InventoryCount = usize``.