Update example

Author: mborland

doc/modules/ROOT/pages/conversions.adoc

@@ -121,40 +121,47 @@ The following example is copied and pasted from the examples/ folder of the libr
 
 [source, c++]
 ----
-#include "test.hpp"
 #include <boost/decimal/decimal32_t.hpp>
-#include <boost/decimal/decimal_fast32_t.hpp>
 #include <boost/decimal/dpd_conversion.hpp>
 #include <boost/decimal/bid_conversion.hpp>
 #include <iostream>
 
 int main()
 {
     using boost::decimal::decimal32_t;
-    using boost::decimal::decimal_fast32_t;
     using boost::decimal::from_bid;
     using boost::decimal::from_dpd;
     using boost::decimal::to_bid;
     using boost::decimal::to_dpd;
 
-    const decimal_fast32_t fast_type {5};
-    const std::uint32_t BID_bits {to_bid(fast_type)};
-    const std::uint32_t DPD_bits {to_dpd(fast_type)};
+    // First we construct a decimal value and then convert it into both BID and DPD encoded bits
+    const decimal32_t decimal_value {5};
+    const std::uint32_t BID_bits {to_bid(decimal_value)};
+    const std::uint32_t DPD_bits {to_dpd(decimal_value)};
 
+    // Display the difference between the hex values of both bit encodings
     std::cout << std::hex
               << "BID format: " << BID_bits << '\n'
               << "DPD format: " << DPD_bits << std::endl;
 
+    // Recover the original value by encoding two new decimals using the from_bid and from_dpd functions
     const decimal32_t bid_decimal {from_bid<decimal32_t>(BID_bits)};
     const decimal32_t dpd_decimal {from_dpd<decimal32_t>(DPD_bits)};
 
-    BOOST_DECIMAL_TEST_NE(bid_decimal, dpd_decimal);
-
-    return boost::decimal::test::report_errors();
+    if (bid_decimal == dpd_decimal)
+    {
+        // These should both have recovered the original value of 5
+        return 0;
+    }
+    else
+    {
+        // Something has gone wrong recovering the decimal values
+        return 1;
+    }
 }
 ----
 Output:
 ----
-BID format: 31fc4b40
-DPD format: 35f00000
+BID format: 32800005
+DPD format: 22500005
 ----