fmt-11.0.2/doc/ChangeLog-old.md

   1 # 7.1.3 - 2020-11-24
   2
   3 - Fixed handling of buffer boundaries in `format_to_n`
   4   (https://github.com/fmtlib/fmt/issues/1996,
   5   https://github.com/fmtlib/fmt/issues/2029).
   6 - Fixed linkage errors when linking with a shared library
   7   (https://github.com/fmtlib/fmt/issues/2011).
   8 - Reintroduced ostream support to range formatters
   9   (https://github.com/fmtlib/fmt/issues/2014).
  10 - Worked around an issue with mixing std versions in gcc
  11   (https://github.com/fmtlib/fmt/issues/2017).
  12
  13 # 7.1.2 - 2020-11-04
  14
  15 - Fixed floating point formatting with large precision
  16   (https://github.com/fmtlib/fmt/issues/1976).
  17
  18 # 7.1.1 - 2020-11-01
  19
  20 - Fixed ABI compatibility with 7.0.x
  21   (https://github.com/fmtlib/fmt/issues/1961).
  22 - Added the `FMT_ARM_ABI_COMPATIBILITY` macro to work around ABI
  23   incompatibility between GCC and Clang on ARM
  24   (https://github.com/fmtlib/fmt/issues/1919).
  25 - Worked around a SFINAE bug in GCC 8
  26   (https://github.com/fmtlib/fmt/issues/1957).
  27 - Fixed linkage errors when building with GCC\'s LTO
  28   (https://github.com/fmtlib/fmt/issues/1955).
  29 - Fixed a compilation error when building without `__builtin_clz` or
  30   equivalent (https://github.com/fmtlib/fmt/pull/1968).
  31   Thanks @tohammer.
  32 - Fixed a sign conversion warning
  33   (https://github.com/fmtlib/fmt/pull/1964). Thanks @OptoCloud.
  34
  35 # 7.1.0 - 2020-10-25
  36
  37 - Switched from
  38   [Grisu3](https://www.cs.tufts.edu/~nr/cs257/archive/florian-loitsch/printf.pdf)
  39   to [Dragonbox](https://github.com/jk-jeon/dragonbox) for the default
  40   floating-point formatting which gives the shortest decimal
  41   representation with round-trip guarantee and correct rounding
  42   (https://github.com/fmtlib/fmt/pull/1882,
  43   https://github.com/fmtlib/fmt/pull/1887,
  44   https://github.com/fmtlib/fmt/pull/1894). This makes {fmt}
  45   up to 20-30x faster than common implementations of
  46   `std::ostringstream` and `sprintf` on
  47   [dtoa-benchmark](https://github.com/fmtlib/dtoa-benchmark) and
  48   faster than double-conversion and Ryū:
  49
  50   ![](https://user-images.githubusercontent.com/576385/95684665-11719600-0ba8-11eb-8e5b-972ff4e49428.png)
  51
  52   It is possible to get even better performance at the cost of larger
  53   binary size by compiling with the `FMT_USE_FULL_CACHE_DRAGONBOX`
  54   macro set to 1.
  55
  56   Thanks @jk-jeon.
  57
  58 - Added an experimental unsynchronized file output API which, together
  59   with [format string
  60   compilation](https://fmt.dev/latest/api.html#compile-api), can give
  61   [5-9 times speed up compared to
  62   fprintf](https://www.zverovich.net/2020/08/04/optimal-file-buffer-size.html)
  63   on common platforms ([godbolt](https://godbolt.org/z/nsTcG8)):
  64
  65   ```c++
  66   #include <fmt/os.h>
  67
  68   int main() {
  69     auto f = fmt::output_file("guide");
  70     f.print("The answer is {}.", 42);
  71   }
  72   ```
  73
  74 - Added a formatter for `std::chrono::time_point<system_clock>`
  75   (https://github.com/fmtlib/fmt/issues/1819,
  76   https://github.com/fmtlib/fmt/pull/1837). For example
  77   ([godbolt](https://godbolt.org/z/c4M6fh)):
  78
  79   ```c++
  80   #include <fmt/chrono.h>
  81
  82   int main() {
  83     auto now = std::chrono::system_clock::now();
  84     fmt::print("The time is {:%H:%M:%S}.\n", now);
  85   }
  86   ```
  87
  88   Thanks @adamburgess.
  89
  90 - Added support for ranges with non-const `begin`/`end` to `fmt::join`
  91   (https://github.com/fmtlib/fmt/issues/1784,
  92   https://github.com/fmtlib/fmt/pull/1786). For example
  93   ([godbolt](https://godbolt.org/z/jP63Tv)):
  94
  95   ```c++
  96   #include <fmt/ranges.h>
  97   #include <range/v3/view/filter.hpp>
  98
  99   int main() {
 100     using std::literals::string_literals::operator""s;
 101     auto strs = std::array{"a"s, "bb"s, "ccc"s};
 102     auto range = strs | ranges::views::filter(
 103       [] (const std::string &x) { return x.size() != 2; }
 104     );
 105     fmt::print("{}\n", fmt::join(range, ""));
 106   }
 107   ```
 108
 109   prints \"accc\".
 110
 111   Thanks @tonyelewis.
 112
 113 - Added a `memory_buffer::append` overload that takes a range
 114   (https://github.com/fmtlib/fmt/pull/1806). Thanks @BRevzin.
 115
 116 - Improved handling of single code units in `FMT_COMPILE`. For
 117   example:
 118
 119   ```c++
 120   #include <fmt/compile.h>
 121
 122   char* f(char* buf) {
 123     return fmt::format_to(buf, FMT_COMPILE("x{}"), 42);
 124   }
 125   ```
 126
 127   compiles to just ([godbolt](https://godbolt.org/z/5vncz3)):
 128
 129   ```asm
 130   _Z1fPc:
 131     movb $120, (%rdi)
 132     xorl %edx, %edx
 133     cmpl $42, _ZN3fmt2v76detail10basic_dataIvE23zero_or_powers_of_10_32E+8(%rip)
 134     movl $3, %eax
 135     seta %dl
 136     subl %edx, %eax
 137     movzwl _ZN3fmt2v76detail10basic_dataIvE6digitsE+84(%rip), %edx
 138     cltq
 139     addq %rdi, %rax
 140     movw %dx, -2(%rax)
 141     ret
 142   ```
 143
 144   Here a single `mov` instruction writes `'x'` (`$120`) to the output
 145   buffer.
 146
 147 - Added dynamic width support to format string compilation
 148   (https://github.com/fmtlib/fmt/issues/1809).
 149
 150 - Improved error reporting for unformattable types: now you\'ll get
 151   the type name directly in the error message instead of the note:
 152
 153   ```c++
 154   #include <fmt/core.h>
 155
 156   struct how_about_no {};
 157
 158   int main() {
 159     fmt::print("{}", how_about_no());
 160   }
 161   ```
 162
 163   Error ([godbolt](https://godbolt.org/z/GoxM4e)):
 164
 165   `fmt/core.h:1438:3: error: static_assert failed due to requirement 'fmt::v7::formattable<how_about_no>()' "Cannot format an argument. To make type T formattable provide a formatter<T> specialization: https://fmt.dev/latest/api.html#udt" ...`
 166
 167 - Added the
 168   [make_args_checked](https://fmt.dev/7.1.0/api.html#argument-lists)
 169   function template that allows you to write formatting functions with
 170   compile-time format string checks and avoid binary code bloat
 171   ([godbolt](https://godbolt.org/z/PEf9qr)):
 172
 173   ```c++
 174   void vlog(const char* file, int line, fmt::string_view format,
 175             fmt::format_args args) {
 176     fmt::print("{}: {}: ", file, line);
 177     fmt::vprint(format, args);
 178   }
 179
 180   template <typename S, typename... Args>
 181   void log(const char* file, int line, const S& format, Args&&... args) {
 182     vlog(file, line, format,
 183         fmt::make_args_checked<Args...>(format, args...));
 184   }
 185
 186   #define MY_LOG(format, ...) \
 187     log(__FILE__, __LINE__, FMT_STRING(format), __VA_ARGS__)
 188
 189   MY_LOG("invalid squishiness: {}", 42);
 190   ```
 191
 192 - Replaced `snprintf` fallback with a faster internal IEEE 754 `float`
 193   and `double` formatter for arbitrary precision. For example
 194   ([godbolt](https://godbolt.org/z/dPhWvj)):
 195
 196   ```c++
 197   #include <fmt/core.h>
 198
 199   int main() {
 200     fmt::print("{:.500}\n", 4.9406564584124654E-324);
 201   }
 202   ```
 203
 204   prints
 205
 206   `4.9406564584124654417656879286822137236505980261432476442558568250067550727020875186529983636163599237979656469544571773092665671035593979639877479601078187812630071319031140452784581716784898210368871863605699873072305000638740915356498438731247339727316961514003171538539807412623856559117102665855668676818703956031062493194527159149245532930545654440112748012970999954193198940908041656332452475714786901472678015935523861155013480352649347201937902681071074917033322268447533357208324319360923829e-324`.
 207
 208 - Made `format_to_n` and `formatted_size` part of the [core
 209   API](https://fmt.dev/latest/api.html#core-api)
 210   ([godbolt](https://godbolt.org/z/sPjY1K)):
 211
 212   ```c++
 213   #include <fmt/core.h>
 214
 215   int main() {
 216     char buffer[10];
 217     auto result = fmt::format_to_n(buffer, sizeof(buffer), "{}", 42);
 218   }
 219   ```
 220
 221 - Added `fmt::format_to_n` overload with format string compilation
 222   (https://github.com/fmtlib/fmt/issues/1764,
 223   https://github.com/fmtlib/fmt/pull/1767,
 224   https://github.com/fmtlib/fmt/pull/1869). For example
 225   ([godbolt](https://godbolt.org/z/93h86q)):
 226
 227   ```c++
 228   #include <fmt/compile.h>
 229
 230   int main() {
 231     char buffer[8];
 232     fmt::format_to_n(buffer, sizeof(buffer), FMT_COMPILE("{}"), 42);
 233   }
 234   ```
 235
 236   Thanks @Kurkin and @alexezeder.
 237
 238 - Added `fmt::format_to` overload that take `text_style`
 239   (https://github.com/fmtlib/fmt/issues/1593,
 240   https://github.com/fmtlib/fmt/issues/1842,
 241   https://github.com/fmtlib/fmt/pull/1843). For example
 242   ([godbolt](https://godbolt.org/z/91153r)):
 243
 244   ```c++
 245   #include <fmt/color.h>
 246
 247   int main() {
 248     std::string out;
 249     fmt::format_to(std::back_inserter(out),
 250                    fmt::emphasis::bold | fg(fmt::color::red),
 251                    "The answer is {}.", 42);
 252   }
 253   ```
 254
 255   Thanks @Naios.
 256
 257 - Made the `'#'` specifier emit trailing zeros in addition to the
 258   decimal point (https://github.com/fmtlib/fmt/issues/1797).
 259   For example ([godbolt](https://godbolt.org/z/bhdcW9)):
 260
 261   ```c++
 262   #include <fmt/core.h>
 263
 264   int main() {
 265     fmt::print("{:#.2g}", 0.5);
 266   }
 267   ```
 268
 269   prints `0.50`.
 270
 271 - Changed the default floating point format to not include `.0` for
 272   consistency with `std::format` and `std::to_chars`
 273   (https://github.com/fmtlib/fmt/issues/1893,
 274   https://github.com/fmtlib/fmt/issues/1943). It is possible
 275   to get the decimal point and trailing zero with the `#` specifier.
 276
 277 - Fixed an issue with floating-point formatting that could result in
 278   addition of a non-significant trailing zero in rare cases e.g.
 279   `1.00e-34` instead of `1.0e-34`
 280   (https://github.com/fmtlib/fmt/issues/1873,
 281   https://github.com/fmtlib/fmt/issues/1917).
 282
 283 - Made `fmt::to_string` fallback on `ostream` insertion operator if
 284   the `formatter` specialization is not provided
 285   (https://github.com/fmtlib/fmt/issues/1815,
 286   https://github.com/fmtlib/fmt/pull/1829). Thanks @alexezeder.
 287
 288 - Added support for the append mode to the experimental file API and
 289   improved `fcntl.h` detection.
 290   (https://github.com/fmtlib/fmt/pull/1847,
 291   https://github.com/fmtlib/fmt/pull/1848). Thanks @t-wiser.
 292
 293 - Fixed handling of types that have both an implicit conversion
 294   operator and an overloaded `ostream` insertion operator
 295   (https://github.com/fmtlib/fmt/issues/1766).
 296
 297 - Fixed a slicing issue in an internal iterator type
 298   (https://github.com/fmtlib/fmt/pull/1822). Thanks @BRevzin.
 299
 300 - Fixed an issue in locale-specific integer formatting
 301   (https://github.com/fmtlib/fmt/issues/1927).
 302
 303 - Fixed handling of exotic code unit types
 304   (https://github.com/fmtlib/fmt/issues/1870,
 305   https://github.com/fmtlib/fmt/issues/1932).
 306
 307 - Improved `FMT_ALWAYS_INLINE`
 308   (https://github.com/fmtlib/fmt/pull/1878). Thanks @jk-jeon.
 309
 310 - Removed dependency on `windows.h`
 311   (https://github.com/fmtlib/fmt/pull/1900). Thanks @bernd5.
 312
 313 - Optimized counting of decimal digits on MSVC
 314   (https://github.com/fmtlib/fmt/pull/1890). Thanks @mwinterb.
 315
 316 - Improved documentation
 317   (https://github.com/fmtlib/fmt/issues/1772,
 318   https://github.com/fmtlib/fmt/pull/1775,
 319   https://github.com/fmtlib/fmt/pull/1792,
 320   https://github.com/fmtlib/fmt/pull/1838,
 321   https://github.com/fmtlib/fmt/pull/1888,
 322   https://github.com/fmtlib/fmt/pull/1918,
 323   https://github.com/fmtlib/fmt/pull/1939).
 324   Thanks @leolchat, @pepsiman, @Klaim, @ravijanjam, @francesco-st and @udnaan.
 325
 326 - Added the `FMT_REDUCE_INT_INSTANTIATIONS` CMake option that reduces
 327   the binary code size at the cost of some integer formatting
 328   performance. This can be useful for extremely memory-constrained
 329   embedded systems
 330   (https://github.com/fmtlib/fmt/issues/1778,
 331   https://github.com/fmtlib/fmt/pull/1781). Thanks @kammce.
 332
 333 - Added the `FMT_USE_INLINE_NAMESPACES` macro to control usage of
 334   inline namespaces
 335   (https://github.com/fmtlib/fmt/pull/1945). Thanks @darklukee.
 336
 337 - Improved build configuration
 338   (https://github.com/fmtlib/fmt/pull/1760,
 339   https://github.com/fmtlib/fmt/pull/1770,
 340   https://github.com/fmtlib/fmt/issues/1779,
 341   https://github.com/fmtlib/fmt/pull/1783,
 342   https://github.com/fmtlib/fmt/pull/1823).
 343   Thanks @dvetutnev, @xvitaly, @tambry, @medithe and @martinwuehrer.
 344
 345 - Fixed various warnings and compilation issues
 346   (https://github.com/fmtlib/fmt/pull/1790,
 347   https://github.com/fmtlib/fmt/pull/1802,
 348   https://github.com/fmtlib/fmt/pull/1808,
 349   https://github.com/fmtlib/fmt/issues/1810,
 350   https://github.com/fmtlib/fmt/issues/1811,
 351   https://github.com/fmtlib/fmt/pull/1812,
 352   https://github.com/fmtlib/fmt/pull/1814,
 353   https://github.com/fmtlib/fmt/pull/1816,
 354   https://github.com/fmtlib/fmt/pull/1817,
 355   https://github.com/fmtlib/fmt/pull/1818,
 356   https://github.com/fmtlib/fmt/issues/1825,
 357   https://github.com/fmtlib/fmt/pull/1836,
 358   https://github.com/fmtlib/fmt/pull/1855,
 359   https://github.com/fmtlib/fmt/pull/1856,
 360   https://github.com/fmtlib/fmt/pull/1860,
 361   https://github.com/fmtlib/fmt/pull/1877,
 362   https://github.com/fmtlib/fmt/pull/1879,
 363   https://github.com/fmtlib/fmt/pull/1880,
 364   https://github.com/fmtlib/fmt/issues/1896,
 365   https://github.com/fmtlib/fmt/pull/1897,
 366   https://github.com/fmtlib/fmt/pull/1898,
 367   https://github.com/fmtlib/fmt/issues/1904,
 368   https://github.com/fmtlib/fmt/pull/1908,
 369   https://github.com/fmtlib/fmt/issues/1911,
 370   https://github.com/fmtlib/fmt/issues/1912,
 371   https://github.com/fmtlib/fmt/issues/1928,
 372   https://github.com/fmtlib/fmt/pull/1929,
 373   https://github.com/fmtlib/fmt/issues/1935,
 374   https://github.com/fmtlib/fmt/pull/1937,
 375   https://github.com/fmtlib/fmt/pull/1942,
 376   https://github.com/fmtlib/fmt/issues/1949).
 377   Thanks @TheQwertiest, @medithe, @martinwuehrer, @n16h7hunt3r, @Othereum,
 378   @gsjaardema, @AlexanderLanin, @gcerretani, @chronoxor, @noizefloor,
 379   @akohlmey, @jk-jeon, @rimathia, @rglarix, @moiwi, @heckad, @MarcDirven.
 380   @BartSiwek and @darklukee.
 381
 382 # 7.0.3 - 2020-08-06
 383
 384 - Worked around broken `numeric_limits` for 128-bit integers
 385   (https://github.com/fmtlib/fmt/issues/1787).
 386 - Added error reporting on missing named arguments
 387   (https://github.com/fmtlib/fmt/issues/1796).
 388 - Stopped using 128-bit integers with clang-cl
 389   (https://github.com/fmtlib/fmt/pull/1800). Thanks @Kingcom.
 390 - Fixed issues in locale-specific integer formatting
 391   (https://github.com/fmtlib/fmt/issues/1782,
 392   https://github.com/fmtlib/fmt/issues/1801).
 393
 394 # 7.0.2 - 2020-07-29
 395
 396 - Worked around broken `numeric_limits` for 128-bit integers
 397   (https://github.com/fmtlib/fmt/issues/1725).
 398 - Fixed compatibility with CMake 3.4
 399   (https://github.com/fmtlib/fmt/issues/1779).
 400 - Fixed handling of digit separators in locale-specific formatting
 401   (https://github.com/fmtlib/fmt/issues/1782).
 402
 403 # 7.0.1 - 2020-07-07
 404
 405 - Updated the inline version namespace name.
 406 - Worked around a gcc bug in mangling of alias templates
 407   (https://github.com/fmtlib/fmt/issues/1753).
 408 - Fixed a linkage error on Windows
 409   (https://github.com/fmtlib/fmt/issues/1757). Thanks @Kurkin.
 410 - Fixed minor issues with the documentation.
 411
 412 # 7.0.0 - 2020-07-05
 413
 414 - Reduced the library size. For example, on macOS a stripped test
 415   binary statically linked with {fmt} [shrank from \~368k to less than
 416   100k](http://www.zverovich.net/2020/05/21/reducing-library-size.html).
 417
 418 - Added a simpler and more efficient [format string compilation
 419   API](https://fmt.dev/7.0.0/api.html#compile-api):
 420
 421   ```c++
 422   #include <fmt/compile.h>
 423
 424   // Converts 42 into std::string using the most efficient method and no
 425   // runtime format string processing.
 426   std::string s = fmt::format(FMT_COMPILE("{}"), 42);
 427   ```
 428
 429   The old `fmt::compile` API is now deprecated.
 430
 431 - Optimized integer formatting: `format_to` with format string
 432   compilation and a stack-allocated buffer is now [faster than
 433   to_chars on both libc++ and
 434   libstdc++](http://www.zverovich.net/2020/06/13/fast-int-to-string-revisited.html).
 435
 436 - Optimized handling of small format strings. For example,
 437
 438   ```c++
 439   fmt::format("Result: {}: ({},{},{},{})", str1, str2, str3, str4, str5)
 440   ```
 441
 442   is now \~40% faster
 443   (https://github.com/fmtlib/fmt/issues/1685).
 444
 445 - Applied extern templates to improve compile times when using the
 446   core API and `fmt/format.h`
 447   (https://github.com/fmtlib/fmt/issues/1452). For example,
 448   on macOS with clang the compile time of a test translation unit
 449   dropped from 2.3s to 0.3s with `-O2` and from 0.6s to 0.3s with the
 450   default settings (`-O0`).
 451
 452   Before (`-O2`):
 453
 454       % time c++ -c test.cc -I include -std=c++17 -O2
 455       c++ -c test.cc -I include -std=c++17 -O2  2.22s user 0.08s system 99% cpu 2.311 total
 456
 457   After (`-O2`):
 458
 459       % time c++ -c test.cc -I include -std=c++17 -O2
 460       c++ -c test.cc -I include -std=c++17 -O2  0.26s user 0.04s system 98% cpu 0.303 total
 461
 462   Before (default):
 463
 464       % time c++ -c test.cc -I include -std=c++17
 465       c++ -c test.cc -I include -std=c++17  0.53s user 0.06s system 98% cpu 0.601 total
 466
 467   After (default):
 468
 469       % time c++ -c test.cc -I include -std=c++17
 470       c++ -c test.cc -I include -std=c++17  0.24s user 0.06s system 98% cpu 0.301 total
 471
 472   It is still recommended to use `fmt/core.h` instead of
 473   `fmt/format.h` but the compile time difference is now smaller.
 474   Thanks @alex3d for the suggestion.
 475
 476 - Named arguments are now stored on stack (no dynamic memory
 477   allocations) and the compiled code is more compact and efficient.
 478   For example
 479
 480   ```c++
 481   #include <fmt/core.h>
 482
 483   int main() {
 484     fmt::print("The answer is {answer}\n", fmt::arg("answer", 42));
 485   }
 486   ```
 487
 488   compiles to just ([godbolt](https://godbolt.org/z/NcfEp_))
 489
 490   ```asm
 491   .LC0:
 492           .string "answer"
 493   .LC1:
 494           .string "The answer is {answer}\n"
 495   main:
 496           sub     rsp, 56
 497           mov     edi, OFFSET FLAT:.LC1
 498           mov     esi, 23
 499           movabs  rdx, 4611686018427387905
 500           lea     rax, [rsp+32]
 501           lea     rcx, [rsp+16]
 502           mov     QWORD PTR [rsp+8], 1
 503           mov     QWORD PTR [rsp], rax
 504           mov     DWORD PTR [rsp+16], 42
 505           mov     QWORD PTR [rsp+32], OFFSET FLAT:.LC0
 506           mov     DWORD PTR [rsp+40], 0
 507           call    fmt::v6::vprint(fmt::v6::basic_string_view<char>,
 508                                   fmt::v6::format_args)
 509           xor     eax, eax
 510           add     rsp, 56
 511           ret
 512
 513       .L.str.1:
 514               .asciz  "answer"
 515   ```
 516
 517 - Implemented compile-time checks for dynamic width and precision
 518   (https://github.com/fmtlib/fmt/issues/1614):
 519
 520   ```c++
 521   #include <fmt/format.h>
 522
 523   int main() {
 524     fmt::print(FMT_STRING("{0:{1}}"), 42);
 525   }
 526   ```
 527
 528   now gives a compilation error because argument 1 doesn\'t exist:
 529
 530       In file included from test.cc:1:
 531       include/fmt/format.h:2726:27: error: constexpr variable 'invalid_format' must be
 532       initialized by a constant expression
 533         FMT_CONSTEXPR_DECL bool invalid_format =
 534                                 ^
 535       ...
 536       include/fmt/core.h:569:26: note: in call to
 537       '&checker(s, {}).context_->on_error(&"argument not found"[0])'
 538           if (id >= num_args_) on_error("argument not found");
 539                               ^
 540
 541 - Added sentinel support to `fmt::join`
 542   (https://github.com/fmtlib/fmt/pull/1689)
 543
 544   ```c++
 545   struct zstring_sentinel {};
 546   bool operator==(const char* p, zstring_sentinel) { return *p == '\0'; }
 547   bool operator!=(const char* p, zstring_sentinel) { return *p != '\0'; }
 548
 549   struct zstring {
 550     const char* p;
 551     const char* begin() const { return p; }
 552     zstring_sentinel end() const { return {}; }
 553   };
 554
 555   auto s = fmt::format("{}", fmt::join(zstring{"hello"}, "_"));
 556   // s == "h_e_l_l_o"
 557   ```
 558
 559   Thanks @BRevzin.
 560
 561 - Added support for named arguments, `clear` and `reserve` to
 562   `dynamic_format_arg_store`
 563   (https://github.com/fmtlib/fmt/issues/1655,
 564   https://github.com/fmtlib/fmt/pull/1663,
 565   https://github.com/fmtlib/fmt/pull/1674,
 566   https://github.com/fmtlib/fmt/pull/1677). Thanks @vsolontsov-ll.
 567
 568 - Added support for the `'c'` format specifier to integral types for
 569   compatibility with `std::format`
 570   (https://github.com/fmtlib/fmt/issues/1652).
 571
 572 - Replaced the `'n'` format specifier with `'L'` for compatibility
 573   with `std::format`
 574   (https://github.com/fmtlib/fmt/issues/1624). The `'n'`
 575   specifier can be enabled via the `FMT_DEPRECATED_N_SPECIFIER` macro.
 576
 577 - The `'='` format specifier is now disabled by default for
 578   compatibility with `std::format`. It can be enabled via the
 579   `FMT_DEPRECATED_NUMERIC_ALIGN` macro.
 580
 581 - Removed the following deprecated APIs:
 582
 583   -   `FMT_STRING_ALIAS` and `fmt` macros - replaced by `FMT_STRING`
 584   -   `fmt::basic_string_view::char_type` - replaced by
 585       `fmt::basic_string_view::value_type`
 586   -   `convert_to_int`
 587   -   `format_arg_store::types`
 588   -   `*parse_context` - replaced by `*format_parse_context`
 589   -   `FMT_DEPRECATED_INCLUDE_OS`
 590   -   `FMT_DEPRECATED_PERCENT` - incompatible with `std::format`
 591   -   `*writer` - replaced by compiled format API
 592
 593 - Renamed the `internal` namespace to `detail`
 594   (https://github.com/fmtlib/fmt/issues/1538). The former is
 595   still provided as an alias if the `FMT_USE_INTERNAL` macro is
 596   defined.
 597
 598 - Improved compatibility between `fmt::printf` with the standard specs
 599   (https://github.com/fmtlib/fmt/issues/1595,
 600   https://github.com/fmtlib/fmt/pull/1682,
 601   https://github.com/fmtlib/fmt/pull/1683,
 602   https://github.com/fmtlib/fmt/pull/1687,
 603   https://github.com/fmtlib/fmt/pull/1699). Thanks @rimathia.
 604
 605 - Fixed handling of `operator<<` overloads that use `copyfmt`
 606   (https://github.com/fmtlib/fmt/issues/1666).
 607
 608 - Added the `FMT_OS` CMake option to control inclusion of OS-specific
 609   APIs in the fmt target. This can be useful for embedded platforms
 610   (https://github.com/fmtlib/fmt/issues/1654,
 611   https://github.com/fmtlib/fmt/pull/1656). Thanks @kwesolowski.
 612
 613 - Replaced `FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION` with the
 614   `FMT_FUZZ` macro to prevent interfering with fuzzing of projects
 615   using {fmt} (https://github.com/fmtlib/fmt/pull/1650).
 616   Thanks @asraa.
 617
 618 - Fixed compatibility with emscripten
 619   (https://github.com/fmtlib/fmt/issues/1636,
 620   https://github.com/fmtlib/fmt/pull/1637). Thanks @ArthurSonzogni.
 621
 622 - Improved documentation
 623   (https://github.com/fmtlib/fmt/issues/704,
 624   https://github.com/fmtlib/fmt/pull/1643,
 625   https://github.com/fmtlib/fmt/pull/1660,
 626   https://github.com/fmtlib/fmt/pull/1681,
 627   https://github.com/fmtlib/fmt/pull/1691,
 628   https://github.com/fmtlib/fmt/pull/1706,
 629   https://github.com/fmtlib/fmt/pull/1714,
 630   https://github.com/fmtlib/fmt/pull/1721,
 631   https://github.com/fmtlib/fmt/pull/1739,
 632   https://github.com/fmtlib/fmt/pull/1740,
 633   https://github.com/fmtlib/fmt/pull/1741,
 634   https://github.com/fmtlib/fmt/pull/1751).
 635   Thanks @senior7515, @lsr0, @puetzk, @fpelliccioni, Alexey Kuzmenko, @jelly,
 636   @claremacrae, @jiapengwen, @gsjaardema and @alexey-milovidov.
 637
 638 - Implemented various build configuration fixes and improvements
 639   (https://github.com/fmtlib/fmt/pull/1603,
 640   https://github.com/fmtlib/fmt/pull/1657,
 641   https://github.com/fmtlib/fmt/pull/1702,
 642   https://github.com/fmtlib/fmt/pull/1728).
 643   Thanks @scramsby, @jtojnar, @orivej and @flagarde.
 644
 645 - Fixed various warnings and compilation issues
 646   (https://github.com/fmtlib/fmt/pull/1616,
 647   https://github.com/fmtlib/fmt/issues/1620,
 648   https://github.com/fmtlib/fmt/issues/1622,
 649   https://github.com/fmtlib/fmt/issues/1625,
 650   https://github.com/fmtlib/fmt/pull/1627,
 651   https://github.com/fmtlib/fmt/issues/1628,
 652   https://github.com/fmtlib/fmt/pull/1629,
 653   https://github.com/fmtlib/fmt/issues/1631,
 654   https://github.com/fmtlib/fmt/pull/1633,
 655   https://github.com/fmtlib/fmt/pull/1649,
 656   https://github.com/fmtlib/fmt/issues/1658,
 657   https://github.com/fmtlib/fmt/pull/1661,
 658   https://github.com/fmtlib/fmt/pull/1667,
 659   https://github.com/fmtlib/fmt/issues/1668,
 660   https://github.com/fmtlib/fmt/pull/1669,
 661   https://github.com/fmtlib/fmt/issues/1692,
 662   https://github.com/fmtlib/fmt/pull/1696,
 663   https://github.com/fmtlib/fmt/pull/1697,
 664   https://github.com/fmtlib/fmt/issues/1707,
 665   https://github.com/fmtlib/fmt/pull/1712,
 666   https://github.com/fmtlib/fmt/pull/1716,
 667   https://github.com/fmtlib/fmt/pull/1722,
 668   https://github.com/fmtlib/fmt/issues/1724,
 669   https://github.com/fmtlib/fmt/pull/1729,
 670   https://github.com/fmtlib/fmt/pull/1738,
 671   https://github.com/fmtlib/fmt/issues/1742,
 672   https://github.com/fmtlib/fmt/issues/1743,
 673   https://github.com/fmtlib/fmt/pull/1744,
 674   https://github.com/fmtlib/fmt/issues/1747,
 675   https://github.com/fmtlib/fmt/pull/1750).
 676   Thanks @gsjaardema, @gabime, @johnor, @Kurkin, @invexed, @peterbell10,
 677   @daixtrose, @petrutlucian94, @Neargye, @ambitslix, @gabime, @erthink,
 678   @tohammer and @0x8000-0000.
 679
 680 # 6.2.1 - 2020-05-09
 681
 682 - Fixed ostream support in `sprintf`
 683   (https://github.com/fmtlib/fmt/issues/1631).
 684 - Fixed type detection when using implicit conversion to `string_view`
 685   and ostream `operator<<` inconsistently
 686   (https://github.com/fmtlib/fmt/issues/1662).
 687
 688 # 6.2.0 - 2020-04-05
 689
 690 - Improved error reporting when trying to format an object of a
 691   non-formattable type:
 692
 693   ```c++
 694   fmt::format("{}", S());
 695   ```
 696
 697   now gives:
 698
 699       include/fmt/core.h:1015:5: error: static_assert failed due to requirement
 700       'formattable' "Cannot format argument. To make type T formattable provide a
 701       formatter<T> specialization:
 702       https://fmt.dev/latest/api.html#formatting-user-defined-types"
 703           static_assert(
 704           ^
 705       ...
 706       note: in instantiation of function template specialization
 707       'fmt::v6::format<char [3], S, char>' requested here
 708         fmt::format("{}", S());
 709              ^
 710
 711   if `S` is not formattable.
 712
 713 - Reduced the library size by \~10%.
 714
 715 - Always print decimal point if `#` is specified
 716   (https://github.com/fmtlib/fmt/issues/1476,
 717   https://github.com/fmtlib/fmt/issues/1498):
 718
 719   ```c++
 720   fmt::print("{:#.0f}", 42.0);
 721   ```
 722
 723   now prints `42.`
 724
 725 - Implemented the `'L'` specifier for locale-specific numeric
 726   formatting to improve compatibility with `std::format`. The `'n'`
 727   specifier is now deprecated and will be removed in the next major
 728   release.
 729
 730 - Moved OS-specific APIs such as `windows_error` from `fmt/format.h`
 731   to `fmt/os.h`. You can define `FMT_DEPRECATED_INCLUDE_OS` to
 732   automatically include `fmt/os.h` from `fmt/format.h` for
 733   compatibility but this will be disabled in the next major release.
 734
 735 - Added precision overflow detection in floating-point formatting.
 736
 737 - Implemented detection of invalid use of `fmt::arg`.
 738
 739 - Used `type_identity` to block unnecessary template argument
 740   deduction. Thanks Tim Song.
 741
 742 - Improved UTF-8 handling
 743   (https://github.com/fmtlib/fmt/issues/1109):
 744
 745   ```c++
 746   fmt::print("┌{0:─^{2}}┐\n"
 747              "│{1: ^{2}}│\n"
 748              "└{0:─^{2}}┘\n", "", "Прывітанне, свет!", 21);
 749   ```
 750
 751   now prints:
 752
 753       ┌─────────────────────┐
 754       │  Прывітанне, свет!  │
 755       └─────────────────────┘
 756
 757   on systems that support Unicode.
 758
 759 - Added experimental dynamic argument storage
 760   (https://github.com/fmtlib/fmt/issues/1170,
 761   https://github.com/fmtlib/fmt/pull/1584):
 762
 763   ```c++
 764   fmt::dynamic_format_arg_store<fmt::format_context> store;
 765   store.push_back("answer");
 766   store.push_back(42);
 767   fmt::vprint("The {} is {}.\n", store);
 768   ```
 769
 770   prints:
 771
 772       The answer is 42.
 773
 774   Thanks @vsolontsov-ll.
 775
 776 - Made `fmt::join` accept `initializer_list`
 777   (https://github.com/fmtlib/fmt/pull/1591). Thanks @Rapotkinnik.
 778
 779 - Fixed handling of empty tuples
 780   (https://github.com/fmtlib/fmt/issues/1588).
 781
 782 - Fixed handling of output iterators in `format_to_n`
 783   (https://github.com/fmtlib/fmt/issues/1506).
 784
 785 - Fixed formatting of `std::chrono::duration` types to wide output
 786   (https://github.com/fmtlib/fmt/pull/1533). Thanks @zeffy.
 787
 788 - Added const `begin` and `end` overload to buffers
 789   (https://github.com/fmtlib/fmt/pull/1553). Thanks @dominicpoeschko.
 790
 791 - Added the ability to disable floating-point formatting via
 792   `FMT_USE_FLOAT`, `FMT_USE_DOUBLE` and `FMT_USE_LONG_DOUBLE` macros
 793   for extremely memory-constrained embedded system
 794   (https://github.com/fmtlib/fmt/pull/1590). Thanks @albaguirre.
 795
 796 - Made `FMT_STRING` work with `constexpr` `string_view`
 797   (https://github.com/fmtlib/fmt/pull/1589). Thanks @scramsby.
 798
 799 - Implemented a minor optimization in the format string parser
 800   (https://github.com/fmtlib/fmt/pull/1560). Thanks @IkarusDeveloper.
 801
 802 - Improved attribute detection
 803   (https://github.com/fmtlib/fmt/pull/1469,
 804   https://github.com/fmtlib/fmt/pull/1475,
 805   https://github.com/fmtlib/fmt/pull/1576).
 806   Thanks @federico-busato, @chronoxor and @refnum.
 807
 808 - Improved documentation
 809   (https://github.com/fmtlib/fmt/pull/1481,
 810   https://github.com/fmtlib/fmt/pull/1523).
 811   Thanks @JackBoosY and @imba-tjd.
 812
 813 - Fixed symbol visibility on Linux when compiling with
 814   `-fvisibility=hidden`
 815   (https://github.com/fmtlib/fmt/pull/1535). Thanks @milianw.
 816
 817 - Implemented various build configuration fixes and improvements
 818   (https://github.com/fmtlib/fmt/issues/1264,
 819   https://github.com/fmtlib/fmt/issues/1460,
 820   https://github.com/fmtlib/fmt/pull/1534,
 821   https://github.com/fmtlib/fmt/issues/1536,
 822   https://github.com/fmtlib/fmt/issues/1545,
 823   https://github.com/fmtlib/fmt/pull/1546,
 824   https://github.com/fmtlib/fmt/issues/1566,
 825   https://github.com/fmtlib/fmt/pull/1582,
 826   https://github.com/fmtlib/fmt/issues/1597,
 827   https://github.com/fmtlib/fmt/pull/1598).
 828   Thanks @ambitslix, @jwillikers and @stac47.
 829
 830 - Fixed various warnings and compilation issues
 831   (https://github.com/fmtlib/fmt/pull/1433,
 832   https://github.com/fmtlib/fmt/issues/1461,
 833   https://github.com/fmtlib/fmt/pull/1470,
 834   https://github.com/fmtlib/fmt/pull/1480,
 835   https://github.com/fmtlib/fmt/pull/1485,
 836   https://github.com/fmtlib/fmt/pull/1492,
 837   https://github.com/fmtlib/fmt/issues/1493,
 838   https://github.com/fmtlib/fmt/issues/1504,
 839   https://github.com/fmtlib/fmt/pull/1505,
 840   https://github.com/fmtlib/fmt/pull/1512,
 841   https://github.com/fmtlib/fmt/issues/1515,
 842   https://github.com/fmtlib/fmt/pull/1516,
 843   https://github.com/fmtlib/fmt/pull/1518,
 844   https://github.com/fmtlib/fmt/pull/1519,
 845   https://github.com/fmtlib/fmt/pull/1520,
 846   https://github.com/fmtlib/fmt/pull/1521,
 847   https://github.com/fmtlib/fmt/pull/1522,
 848   https://github.com/fmtlib/fmt/issues/1524,
 849   https://github.com/fmtlib/fmt/pull/1530,
 850   https://github.com/fmtlib/fmt/issues/1531,
 851   https://github.com/fmtlib/fmt/pull/1532,
 852   https://github.com/fmtlib/fmt/issues/1539,
 853   https://github.com/fmtlib/fmt/issues/1547,
 854   https://github.com/fmtlib/fmt/issues/1548,
 855   https://github.com/fmtlib/fmt/pull/1554,
 856   https://github.com/fmtlib/fmt/issues/1567,
 857   https://github.com/fmtlib/fmt/pull/1568,
 858   https://github.com/fmtlib/fmt/pull/1569,
 859   https://github.com/fmtlib/fmt/pull/1571,
 860   https://github.com/fmtlib/fmt/pull/1573,
 861   https://github.com/fmtlib/fmt/pull/1575,
 862   https://github.com/fmtlib/fmt/pull/1581,
 863   https://github.com/fmtlib/fmt/issues/1583,
 864   https://github.com/fmtlib/fmt/issues/1586,
 865   https://github.com/fmtlib/fmt/issues/1587,
 866   https://github.com/fmtlib/fmt/issues/1594,
 867   https://github.com/fmtlib/fmt/pull/1596,
 868   https://github.com/fmtlib/fmt/issues/1604,
 869   https://github.com/fmtlib/fmt/pull/1606,
 870   https://github.com/fmtlib/fmt/issues/1607,
 871   https://github.com/fmtlib/fmt/issues/1609).
 872   Thanks @marti4d, @iPherian, @parkertomatoes, @gsjaardema, @chronoxor,
 873   @DanielaE, @torsten48, @tohammer, @lefticus, @ryusakki, @adnsv, @fghzxm,
 874   @refnum, @pramodk, @Spirrwell and @scramsby.
 875
 876 # 6.1.2 - 2019-12-11
 877
 878 - Fixed ABI compatibility with `libfmt.so.6.0.0`
 879   (https://github.com/fmtlib/fmt/issues/1471).
 880 - Fixed handling types convertible to `std::string_view`
 881   (https://github.com/fmtlib/fmt/pull/1451). Thanks @denizevrenci.
 882 - Made CUDA test an opt-in enabled via the `FMT_CUDA_TEST` CMake
 883   option.
 884 - Fixed sign conversion warnings
 885   (https://github.com/fmtlib/fmt/pull/1440). Thanks @0x8000-0000.
 886
 887 # 6.1.1 - 2019-12-04
 888
 889 - Fixed shared library build on Windows
 890   (https://github.com/fmtlib/fmt/pull/1443,
 891   https://github.com/fmtlib/fmt/issues/1445,
 892   https://github.com/fmtlib/fmt/pull/1446,
 893   https://github.com/fmtlib/fmt/issues/1450).
 894   Thanks @egorpugin and @bbolli.
 895 - Added a missing decimal point in exponent notation with trailing
 896   zeros.
 897 - Removed deprecated `format_arg_store::TYPES`.
 898
 899 # 6.1.0 - 2019-12-01
 900
 901 - {fmt} now formats IEEE 754 `float` and `double` using the shortest
 902   decimal representation with correct rounding by default:
 903
 904   ```c++
 905   #include <cmath>
 906   #include <fmt/core.h>
 907
 908   int main() {
 909     fmt::print("{}", M_PI);
 910   }
 911   ```
 912
 913   prints `3.141592653589793`.
 914
 915 - Made the fast binary to decimal floating-point formatter the
 916   default, simplified it and improved performance. {fmt} is now 15
 917   times faster than libc++\'s `std::ostringstream`, 11 times faster
 918   than `printf` and 10% faster than double-conversion on
 919   [dtoa-benchmark](https://github.com/fmtlib/dtoa-benchmark):
 920
 921   | Function      | Time (ns) | Speedup |
 922   | ------------- | --------: | ------: |
 923   | ostringstream | 1,346.30  | 1.00x   |
 924   | ostrstream    | 1,195.74  | 1.13x   |
 925   | sprintf       | 995.08    | 1.35x   |
 926   | doubleconv    | 99.10     | 13.59x  |
 927   | fmt           | 88.34     | 15.24x  |
 928
 929   ![](https://user-images.githubusercontent.com/576385/69767160-cdaca400-112f-11ea-9fc5-347c9f83caad.png)
 930
 931 - {fmt} no longer converts `float` arguments to `double`. In
 932   particular this improves the default (shortest) representation of
 933   floats and makes `fmt::format` consistent with `std::format` specs
 934   (https://github.com/fmtlib/fmt/issues/1336,
 935   https://github.com/fmtlib/fmt/issues/1353,
 936   https://github.com/fmtlib/fmt/pull/1360,
 937   https://github.com/fmtlib/fmt/pull/1361):
 938
 939   ```c++
 940   fmt::print("{}", 0.1f);
 941   ```
 942
 943   prints `0.1` instead of `0.10000000149011612`.
 944
 945   Thanks @orivej.
 946
 947 - Made floating-point formatting output consistent with
 948   `printf`/iostreams
 949   (https://github.com/fmtlib/fmt/issues/1376,
 950   https://github.com/fmtlib/fmt/issues/1417).
 951
 952 - Added support for 128-bit integers
 953   (https://github.com/fmtlib/fmt/pull/1287):
 954
 955   ```c++
 956   fmt::print("{}", std::numeric_limits<__int128_t>::max());
 957   ```
 958
 959   prints `170141183460469231731687303715884105727`.
 960
 961   Thanks @denizevrenci.
 962
 963 - The overload of `print` that takes `text_style` is now atomic, i.e.
 964   the output from different threads doesn\'t interleave
 965   (https://github.com/fmtlib/fmt/pull/1351). Thanks @tankiJong.
 966
 967 - Made compile time in the header-only mode \~20% faster by reducing
 968   the number of template instantiations. `wchar_t` overload of
 969   `vprint` was moved from `fmt/core.h` to `fmt/format.h`.
 970
 971 - Added an overload of `fmt::join` that works with tuples
 972   (https://github.com/fmtlib/fmt/issues/1322,
 973   https://github.com/fmtlib/fmt/pull/1330):
 974
 975   ```c++
 976   #include <tuple>
 977   #include <fmt/ranges.h>
 978
 979   int main() {
 980     std::tuple<char, int, float> t{'a', 1, 2.0f};
 981     fmt::print("{}", t);
 982   }
 983   ```
 984
 985   prints `('a', 1, 2.0)`.
 986
 987   Thanks @jeremyong.
 988
 989 - Changed formatting of octal zero with prefix from \"00\" to \"0\":
 990
 991   ```c++
 992   fmt::print("{:#o}", 0);
 993   ```
 994
 995   prints `0`.
 996
 997 - The locale is now passed to ostream insertion (`<<`) operators
 998   (https://github.com/fmtlib/fmt/pull/1406):
 999
1000   ```c++
1001   #include <fmt/locale.h>
1002   #include <fmt/ostream.h>
1003
1004   struct S {
1005     double value;
1006   };
1007
1008   std::ostream& operator<<(std::ostream& os, S s) {
1009     return os << s.value;
1010   }
1011
1012   int main() {
1013     auto s = fmt::format(std::locale("fr_FR.UTF-8"), "{}", S{0.42});
1014     // s == "0,42"
1015   }
1016   ```
1017
1018   Thanks @dlaugt.
1019
1020 - Locale-specific number formatting now uses grouping
1021   (https://github.com/fmtlib/fmt/issues/1393,
1022   https://github.com/fmtlib/fmt/pull/1394). Thanks @skrdaniel.
1023
1024 - Fixed handling of types with deleted implicit rvalue conversion to
1025   `const char**` (https://github.com/fmtlib/fmt/issues/1421):
1026
1027   ```c++
1028   struct mystring {
1029     operator const char*() const&;
1030     operator const char*() &;
1031     operator const char*() const&& = delete;
1032     operator const char*() && = delete;
1033   };
1034   mystring str;
1035   fmt::print("{}", str); // now compiles
1036   ```
1037
1038 - Enums are now mapped to correct underlying types instead of `int`
1039   (https://github.com/fmtlib/fmt/pull/1286). Thanks @agmt.
1040
1041 - Enum classes are no longer implicitly converted to `int`
1042   (https://github.com/fmtlib/fmt/issues/1424).
1043
1044 - Added `basic_format_parse_context` for consistency with C++20
1045   `std::format` and deprecated `basic_parse_context`.
1046
1047 - Fixed handling of UTF-8 in precision
1048   (https://github.com/fmtlib/fmt/issues/1389,
1049   https://github.com/fmtlib/fmt/pull/1390). Thanks @tajtiattila.
1050
1051 - {fmt} can now be installed on Linux, macOS and Windows with
1052   [Conda](https://docs.conda.io/en/latest/) using its
1053   [conda-forge](https://conda-forge.org)
1054   [package](https://github.com/conda-forge/fmt-feedstock)
1055   (https://github.com/fmtlib/fmt/pull/1410):
1056
1057       conda install -c conda-forge fmt
1058
1059   Thanks @tdegeus.
1060
1061 - Added a CUDA test (https://github.com/fmtlib/fmt/pull/1285,
1062   https://github.com/fmtlib/fmt/pull/1317).
1063   Thanks @luncliff and @risa2000.
1064
1065 - Improved documentation
1066   (https://github.com/fmtlib/fmt/pull/1276,
1067   https://github.com/fmtlib/fmt/issues/1291,
1068   https://github.com/fmtlib/fmt/issues/1296,
1069   https://github.com/fmtlib/fmt/pull/1315,
1070   https://github.com/fmtlib/fmt/pull/1332,
1071   https://github.com/fmtlib/fmt/pull/1337,
1072   https://github.com/fmtlib/fmt/issues/1395
1073   https://github.com/fmtlib/fmt/pull/1418).
1074   Thanks @waywardmonkeys, @pauldreik and @jackoalan.
1075
1076 - Various code improvements
1077   (https://github.com/fmtlib/fmt/pull/1358,
1078   https://github.com/fmtlib/fmt/pull/1407).
1079   Thanks @orivej and @dpacbach.
1080
1081 - Fixed compile-time format string checks for user-defined types
1082   (https://github.com/fmtlib/fmt/issues/1292).
1083
1084 - Worked around a false positive in `unsigned-integer-overflow` sanitizer
1085   (https://github.com/fmtlib/fmt/issues/1377).
1086
1087 - Fixed various warnings and compilation issues
1088   (https://github.com/fmtlib/fmt/issues/1273,
1089   https://github.com/fmtlib/fmt/pull/1278,
1090   https://github.com/fmtlib/fmt/pull/1280,
1091   https://github.com/fmtlib/fmt/issues/1281,
1092   https://github.com/fmtlib/fmt/issues/1288,
1093   https://github.com/fmtlib/fmt/pull/1290,
1094   https://github.com/fmtlib/fmt/pull/1301,
1095   https://github.com/fmtlib/fmt/issues/1305,
1096   https://github.com/fmtlib/fmt/issues/1306,
1097   https://github.com/fmtlib/fmt/issues/1309,
1098   https://github.com/fmtlib/fmt/pull/1312,
1099   https://github.com/fmtlib/fmt/issues/1313,
1100   https://github.com/fmtlib/fmt/issues/1316,
1101   https://github.com/fmtlib/fmt/issues/1319,
1102   https://github.com/fmtlib/fmt/pull/1320,
1103   https://github.com/fmtlib/fmt/pull/1326,
1104   https://github.com/fmtlib/fmt/pull/1328,
1105   https://github.com/fmtlib/fmt/issues/1344,
1106   https://github.com/fmtlib/fmt/pull/1345,
1107   https://github.com/fmtlib/fmt/pull/1347,
1108   https://github.com/fmtlib/fmt/pull/1349,
1109   https://github.com/fmtlib/fmt/issues/1354,
1110   https://github.com/fmtlib/fmt/issues/1362,
1111   https://github.com/fmtlib/fmt/issues/1366,
1112   https://github.com/fmtlib/fmt/pull/1364,
1113   https://github.com/fmtlib/fmt/pull/1370,
1114   https://github.com/fmtlib/fmt/pull/1371,
1115   https://github.com/fmtlib/fmt/issues/1385,
1116   https://github.com/fmtlib/fmt/issues/1388,
1117   https://github.com/fmtlib/fmt/pull/1397,
1118   https://github.com/fmtlib/fmt/pull/1414,
1119   https://github.com/fmtlib/fmt/pull/1416,
1120   https://github.com/fmtlib/fmt/issues/1422
1121   https://github.com/fmtlib/fmt/pull/1427,
1122   https://github.com/fmtlib/fmt/issues/1431,
1123   https://github.com/fmtlib/fmt/pull/1433).
1124   Thanks @hhb, @gsjaardema, @gabime, @neheb, @vedranmiletic, @dkavolis,
1125   @mwinterb, @orivej, @denizevrenci, @leonklingele, @chronoxor, @kent-tri,
1126   @0x8000-0000 and @marti4d.
1127
1128 # 6.0.0 - 2019-08-26
1129
1130 - Switched to the [MIT license](
1131   https://github.com/fmtlib/fmt/blob/5a4b24613ba16cc689977c3b5bd8274a3ba1dd1f/LICENSE.rst)
1132   with an optional exception that allows distributing binary code
1133   without attribution.
1134
1135 - Floating-point formatting is now locale-independent by default:
1136
1137   ```c++
1138   #include <locale>
1139   #include <fmt/core.h>
1140
1141   int main() {
1142     std::locale::global(std::locale("ru_RU.UTF-8"));
1143     fmt::print("value = {}", 4.2);
1144   }
1145   ```
1146
1147   prints \"value = 4.2\" regardless of the locale.
1148
1149   For locale-specific formatting use the `n` specifier:
1150
1151   ```c++
1152   std::locale::global(std::locale("ru_RU.UTF-8"));
1153   fmt::print("value = {:n}", 4.2);
1154   ```
1155
1156   prints \"value = 4,2\".
1157
1158 - Added an experimental Grisu floating-point formatting algorithm
1159   implementation (disabled by default). To enable it compile with the
1160   `FMT_USE_GRISU` macro defined to 1:
1161
1162   ```c++
1163   #define FMT_USE_GRISU 1
1164   #include <fmt/format.h>
1165
1166   auto s = fmt::format("{}", 4.2); // formats 4.2 using Grisu
1167   ```
1168
1169   With Grisu enabled, {fmt} is 13x faster than `std::ostringstream`
1170   (libc++) and 10x faster than `sprintf` on
1171   [dtoa-benchmark](https://github.com/fmtlib/dtoa-benchmark) ([full
1172   results](https://fmt.dev/unknown_mac64_clang10.0.html)):
1173
1174   ![](https://user-images.githubusercontent.com/576385/54883977-9fe8c000-4e28-11e9-8bde-272d122e7c52.jpg)
1175
1176 - Separated formatting and parsing contexts for consistency with
1177   [C++20 std::format](http://eel.is/c++draft/format), removing the
1178   undocumented `basic_format_context::parse_context()` function.
1179
1180 - Added [oss-fuzz](https://github.com/google/oss-fuzz) support
1181   (https://github.com/fmtlib/fmt/pull/1199). Thanks @pauldreik.
1182
1183 - `formatter` specializations now always take precedence over
1184   `operator<<` (https://github.com/fmtlib/fmt/issues/952):
1185
1186   ```c++
1187   #include <iostream>
1188   #include <fmt/ostream.h>
1189
1190   struct S {};
1191
1192   std::ostream& operator<<(std::ostream& os, S) {
1193     return os << 1;
1194   }
1195
1196   template <>
1197   struct fmt::formatter<S> : fmt::formatter<int> {
1198     auto format(S, format_context& ctx) {
1199       return formatter<int>::format(2, ctx);
1200     }
1201   };
1202
1203   int main() {
1204     std::cout << S() << "\n"; // prints 1 using operator<<
1205     fmt::print("{}\n", S());  // prints 2 using formatter
1206   }
1207   ```
1208
1209 - Introduced the experimental `fmt::compile` function that does format
1210   string compilation
1211   (https://github.com/fmtlib/fmt/issues/618,
1212   https://github.com/fmtlib/fmt/issues/1169,
1213   https://github.com/fmtlib/fmt/pull/1171):
1214
1215   ```c++
1216   #include <fmt/compile.h>
1217
1218   auto f = fmt::compile<int>("{}");
1219   std::string s = fmt::format(f, 42); // can be called multiple times to
1220                                       // format different values
1221   // s == "42"
1222   ```
1223
1224   It moves the cost of parsing a format string outside of the format
1225   function which can be beneficial when identically formatting many
1226   objects of the same types. Thanks @stryku.
1227
1228 - Added experimental `%` format specifier that formats floating-point
1229   values as percentages
1230   (https://github.com/fmtlib/fmt/pull/1060,
1231   https://github.com/fmtlib/fmt/pull/1069,
1232   https://github.com/fmtlib/fmt/pull/1071):
1233
1234   ```c++
1235   auto s = fmt::format("{:.1%}", 0.42); // s == "42.0%"
1236   ```
1237
1238   Thanks @gawain-bolton.
1239
1240 - Implemented precision for floating-point durations
1241   (https://github.com/fmtlib/fmt/issues/1004,
1242   https://github.com/fmtlib/fmt/pull/1012):
1243
1244   ```c++
1245   auto s = fmt::format("{:.1}", std::chrono::duration<double>(1.234));
1246   // s == 1.2s
1247   ```
1248
1249   Thanks @DanielaE.
1250
1251 - Implemented `chrono` format specifiers `%Q` and `%q` that give the
1252   value and the unit respectively
1253   (https://github.com/fmtlib/fmt/pull/1019):
1254
1255   ```c++
1256   auto value = fmt::format("{:%Q}", 42s); // value == "42"
1257   auto unit  = fmt::format("{:%q}", 42s); // unit == "s"
1258   ```
1259
1260   Thanks @DanielaE.
1261
1262 - Fixed handling of dynamic width in chrono formatter:
1263
1264   ```c++
1265   auto s = fmt::format("{0:{1}%H:%M:%S}", std::chrono::seconds(12345), 12);
1266   //                        ^ width argument index                     ^ width
1267   // s == "03:25:45    "
1268   ```
1269
1270   Thanks Howard Hinnant.
1271
1272 - Removed deprecated `fmt/time.h`. Use `fmt/chrono.h` instead.
1273
1274 - Added `fmt::format` and `fmt::vformat` overloads that take
1275   `text_style` (https://github.com/fmtlib/fmt/issues/993,
1276   https://github.com/fmtlib/fmt/pull/994):
1277
1278   ```c++
1279   #include <fmt/color.h>
1280
1281   std::string message = fmt::format(fmt::emphasis::bold | fg(fmt::color::red),
1282                                     "The answer is {}.", 42);
1283   ```
1284
1285   Thanks @Naios.
1286
1287 - Removed the deprecated color API (`print_colored`). Use the new API,
1288   namely `print` overloads that take `text_style` instead.
1289
1290 - Made `std::unique_ptr` and `std::shared_ptr` formattable as pointers
1291   via `fmt::ptr` (https://github.com/fmtlib/fmt/pull/1121):
1292
1293   ```c++
1294   std::unique_ptr<int> p = ...;
1295   fmt::print("{}", fmt::ptr(p)); // prints p as a pointer
1296   ```
1297
1298   Thanks @sighingnow.
1299
1300 - Made `print` and `vprint` report I/O errors
1301   (https://github.com/fmtlib/fmt/issues/1098,
1302   https://github.com/fmtlib/fmt/pull/1099). Thanks @BillyDonahue.
1303
1304 - Marked deprecated APIs with the `[[deprecated]]` attribute and
1305   removed internal uses of deprecated APIs
1306   (https://github.com/fmtlib/fmt/pull/1022). Thanks @eliaskosunen.
1307
1308 - Modernized the codebase using more C++11 features and removing
1309   workarounds. Most importantly, `buffer_context` is now an alias
1310   template, so use `buffer_context<T>` instead of
1311   `buffer_context<T>::type`. These features require GCC 4.8 or later.
1312
1313 - `formatter` specializations now always take precedence over implicit
1314   conversions to `int` and the undocumented `convert_to_int` trait is
1315   now deprecated.
1316
1317 - Moved the undocumented `basic_writer`, `writer`, and `wwriter` types
1318   to the `internal` namespace.
1319
1320 - Removed deprecated `basic_format_context::begin()`. Use `out()`
1321   instead.
1322
1323 - Disallowed passing the result of `join` as an lvalue to prevent
1324   misuse.
1325
1326 - Refactored the undocumented structs that represent parsed format
1327   specifiers to simplify the API and allow multibyte fill.
1328
1329 - Moved SFINAE to template parameters to reduce symbol sizes.
1330
1331 - Switched to `fputws` for writing wide strings so that it\'s no
1332   longer required to call `_setmode` on Windows
1333   (https://github.com/fmtlib/fmt/issues/1229,
1334   https://github.com/fmtlib/fmt/pull/1243). Thanks @jackoalan.
1335
1336 - Improved literal-based API
1337   (https://github.com/fmtlib/fmt/pull/1254). Thanks @sylveon.
1338
1339 - Added support for exotic platforms without `uintptr_t` such as IBM i
1340   (AS/400) which has 128-bit pointers and only 64-bit integers
1341   (https://github.com/fmtlib/fmt/issues/1059).
1342
1343 - Added [Sublime Text syntax highlighting config](
1344   https://github.com/fmtlib/fmt/blob/master/support/C%2B%2B.sublime-syntax)
1345   (https://github.com/fmtlib/fmt/issues/1037). Thanks @Kronuz.
1346
1347 - Added the `FMT_ENFORCE_COMPILE_STRING` macro to enforce the use of
1348   compile-time format strings
1349   (https://github.com/fmtlib/fmt/pull/1231). Thanks @jackoalan.
1350
1351 - Stopped setting `CMAKE_BUILD_TYPE` if {fmt} is a subproject
1352   (https://github.com/fmtlib/fmt/issues/1081).
1353
1354 - Various build improvements
1355   (https://github.com/fmtlib/fmt/pull/1039,
1356   https://github.com/fmtlib/fmt/pull/1078,
1357   https://github.com/fmtlib/fmt/pull/1091,
1358   https://github.com/fmtlib/fmt/pull/1103,
1359   https://github.com/fmtlib/fmt/pull/1177).
1360   Thanks @luncliff, @jasonszang, @olafhering, @Lecetem and @pauldreik.
1361
1362 - Improved documentation
1363   (https://github.com/fmtlib/fmt/issues/1049,
1364   https://github.com/fmtlib/fmt/pull/1051,
1365   https://github.com/fmtlib/fmt/pull/1083,
1366   https://github.com/fmtlib/fmt/pull/1113,
1367   https://github.com/fmtlib/fmt/pull/1114,
1368   https://github.com/fmtlib/fmt/issues/1146,
1369   https://github.com/fmtlib/fmt/issues/1180,
1370   https://github.com/fmtlib/fmt/pull/1250,
1371   https://github.com/fmtlib/fmt/pull/1252,
1372   https://github.com/fmtlib/fmt/pull/1265).
1373   Thanks @mikelui, @foonathan, @BillyDonahue, @jwakely, @kaisbe and
1374   @sdebionne.
1375
1376 - Fixed ambiguous formatter specialization in `fmt/ranges.h`
1377   (https://github.com/fmtlib/fmt/issues/1123).
1378
1379 - Fixed formatting of a non-empty `std::filesystem::path` which is an
1380   infinitely deep range of its components
1381   (https://github.com/fmtlib/fmt/issues/1268).
1382
1383 - Fixed handling of general output iterators when formatting
1384   characters (https://github.com/fmtlib/fmt/issues/1056,
1385   https://github.com/fmtlib/fmt/pull/1058). Thanks @abolz.
1386
1387 - Fixed handling of output iterators in `formatter` specialization for
1388   ranges (https://github.com/fmtlib/fmt/issues/1064).
1389
1390 - Fixed handling of exotic character types
1391   (https://github.com/fmtlib/fmt/issues/1188).
1392
1393 - Made chrono formatting work with exceptions disabled
1394   (https://github.com/fmtlib/fmt/issues/1062).
1395
1396 - Fixed DLL visibility issues
1397   (https://github.com/fmtlib/fmt/pull/1134,
1398   https://github.com/fmtlib/fmt/pull/1147). Thanks @denchat.
1399
1400 - Disabled the use of UDL template extension on GCC 9
1401   (https://github.com/fmtlib/fmt/issues/1148).
1402
1403 - Removed misplaced `format` compile-time checks from `printf`
1404   (https://github.com/fmtlib/fmt/issues/1173).
1405
1406 - Fixed issues in the experimental floating-point formatter
1407   (https://github.com/fmtlib/fmt/issues/1072,
1408   https://github.com/fmtlib/fmt/issues/1129,
1409   https://github.com/fmtlib/fmt/issues/1153,
1410   https://github.com/fmtlib/fmt/pull/1155,
1411   https://github.com/fmtlib/fmt/issues/1210,
1412   https://github.com/fmtlib/fmt/issues/1222). Thanks @alabuzhev.
1413
1414 - Fixed bugs discovered by fuzzing or during fuzzing integration
1415   (https://github.com/fmtlib/fmt/issues/1124,
1416   https://github.com/fmtlib/fmt/issues/1127,
1417   https://github.com/fmtlib/fmt/issues/1132,
1418   https://github.com/fmtlib/fmt/pull/1135,
1419   https://github.com/fmtlib/fmt/issues/1136,
1420   https://github.com/fmtlib/fmt/issues/1141,
1421   https://github.com/fmtlib/fmt/issues/1142,
1422   https://github.com/fmtlib/fmt/issues/1178,
1423   https://github.com/fmtlib/fmt/issues/1179,
1424   https://github.com/fmtlib/fmt/issues/1194). Thanks @pauldreik.
1425
1426 - Fixed building tests on FreeBSD and Hurd
1427   (https://github.com/fmtlib/fmt/issues/1043). Thanks @jackyf.
1428
1429 - Fixed various warnings and compilation issues
1430   (https://github.com/fmtlib/fmt/pull/998,
1431   https://github.com/fmtlib/fmt/pull/1006,
1432   https://github.com/fmtlib/fmt/issues/1008,
1433   https://github.com/fmtlib/fmt/issues/1011,
1434   https://github.com/fmtlib/fmt/issues/1025,
1435   https://github.com/fmtlib/fmt/pull/1027,
1436   https://github.com/fmtlib/fmt/pull/1028,
1437   https://github.com/fmtlib/fmt/pull/1029,
1438   https://github.com/fmtlib/fmt/pull/1030,
1439   https://github.com/fmtlib/fmt/pull/1031,
1440   https://github.com/fmtlib/fmt/pull/1054,
1441   https://github.com/fmtlib/fmt/issues/1063,
1442   https://github.com/fmtlib/fmt/pull/1068,
1443   https://github.com/fmtlib/fmt/pull/1074,
1444   https://github.com/fmtlib/fmt/pull/1075,
1445   https://github.com/fmtlib/fmt/pull/1079,
1446   https://github.com/fmtlib/fmt/pull/1086,
1447   https://github.com/fmtlib/fmt/issues/1088,
1448   https://github.com/fmtlib/fmt/pull/1089,
1449   https://github.com/fmtlib/fmt/pull/1094,
1450   https://github.com/fmtlib/fmt/issues/1101,
1451   https://github.com/fmtlib/fmt/pull/1102,
1452   https://github.com/fmtlib/fmt/issues/1105,
1453   https://github.com/fmtlib/fmt/pull/1107,
1454   https://github.com/fmtlib/fmt/issues/1115,
1455   https://github.com/fmtlib/fmt/issues/1117,
1456   https://github.com/fmtlib/fmt/issues/1118,
1457   https://github.com/fmtlib/fmt/issues/1120,
1458   https://github.com/fmtlib/fmt/issues/1123,
1459   https://github.com/fmtlib/fmt/pull/1139,
1460   https://github.com/fmtlib/fmt/issues/1140,
1461   https://github.com/fmtlib/fmt/issues/1143,
1462   https://github.com/fmtlib/fmt/pull/1144,
1463   https://github.com/fmtlib/fmt/pull/1150,
1464   https://github.com/fmtlib/fmt/pull/1151,
1465   https://github.com/fmtlib/fmt/issues/1152,
1466   https://github.com/fmtlib/fmt/issues/1154,
1467   https://github.com/fmtlib/fmt/issues/1156,
1468   https://github.com/fmtlib/fmt/pull/1159,
1469   https://github.com/fmtlib/fmt/issues/1175,
1470   https://github.com/fmtlib/fmt/issues/1181,
1471   https://github.com/fmtlib/fmt/issues/1186,
1472   https://github.com/fmtlib/fmt/pull/1187,
1473   https://github.com/fmtlib/fmt/pull/1191,
1474   https://github.com/fmtlib/fmt/issues/1197,
1475   https://github.com/fmtlib/fmt/issues/1200,
1476   https://github.com/fmtlib/fmt/issues/1203,
1477   https://github.com/fmtlib/fmt/issues/1205,
1478   https://github.com/fmtlib/fmt/pull/1206,
1479   https://github.com/fmtlib/fmt/issues/1213,
1480   https://github.com/fmtlib/fmt/issues/1214,
1481   https://github.com/fmtlib/fmt/pull/1217,
1482   https://github.com/fmtlib/fmt/issues/1228,
1483   https://github.com/fmtlib/fmt/pull/1230,
1484   https://github.com/fmtlib/fmt/issues/1232,
1485   https://github.com/fmtlib/fmt/pull/1235,
1486   https://github.com/fmtlib/fmt/pull/1236,
1487   https://github.com/fmtlib/fmt/issues/1240).
1488   Thanks @DanielaE, @mwinterb, @eliaskosunen, @morinmorin, @ricco19,
1489   @waywardmonkeys, @chronoxor, @remyabel, @pauldreik, @gsjaardema, @rcane,
1490   @mocabe, @denchat, @cjdb, @HazardyKnusperkeks, @vedranmiletic, @jackoalan,
1491   @DaanDeMeyer and @starkmapper.
1492
1493 # 5.3.0 - 2018-12-28
1494
1495 - Introduced experimental chrono formatting support:
1496
1497   ```c++
1498   #include <fmt/chrono.h>
1499
1500   int main() {
1501     using namespace std::literals::chrono_literals;
1502     fmt::print("Default format: {} {}\n", 42s, 100ms);
1503     fmt::print("strftime-like format: {:%H:%M:%S}\n", 3h + 15min + 30s);
1504   }
1505   ```
1506
1507   prints:
1508
1509       Default format: 42s 100ms
1510       strftime-like format: 03:15:30
1511
1512 - Added experimental support for emphasis (bold, italic, underline,
1513   strikethrough), colored output to a file stream, and improved
1514   colored formatting API
1515   (https://github.com/fmtlib/fmt/pull/961,
1516   https://github.com/fmtlib/fmt/pull/967,
1517   https://github.com/fmtlib/fmt/pull/973):
1518
1519   ```c++
1520   #include <fmt/color.h>
1521
1522   int main() {
1523     fmt::print(fg(fmt::color::crimson) | fmt::emphasis::bold,
1524                "Hello, {}!\n", "world");
1525     fmt::print(fg(fmt::color::floral_white) | bg(fmt::color::slate_gray) |
1526                fmt::emphasis::underline, "Olá, {}!\n", "Mundo");
1527     fmt::print(fg(fmt::color::steel_blue) | fmt::emphasis::italic,
1528                "你好{}！\n", "世界");
1529   }
1530   ```
1531
1532   prints the following on modern terminals with RGB color support:
1533
1534   ![](https://github.com/fmtlib/fmt/assets/%0A576385/2a93c904-d6fa-4aa6-b453-2618e1c327d7)
1535
1536   Thanks @Rakete1111.
1537
1538 - Added support for 4-bit terminal colors
1539   (https://github.com/fmtlib/fmt/issues/968,
1540   https://github.com/fmtlib/fmt/pull/974)
1541
1542   ```c++
1543   #include <fmt/color.h>
1544
1545   int main() {
1546     print(fg(fmt::terminal_color::red), "stop\n");
1547   }
1548   ```
1549
1550   Note that these colors vary by terminal:
1551
1552   ![](https://user-images.githubusercontent.com/576385/50405925-dbfc7e00-0770-11e9-9b85-333fab0af9ac.png)
1553
1554   Thanks @Rakete1111.
1555
1556 - Parameterized formatting functions on the type of the format string
1557   (https://github.com/fmtlib/fmt/issues/880,
1558   https://github.com/fmtlib/fmt/pull/881,
1559   https://github.com/fmtlib/fmt/pull/883,
1560   https://github.com/fmtlib/fmt/pull/885,
1561   https://github.com/fmtlib/fmt/pull/897,
1562   https://github.com/fmtlib/fmt/issues/920). Any object of
1563   type `S` that has an overloaded `to_string_view(const S&)` returning
1564   `fmt::string_view` can be used as a format string:
1565
1566   ```c++
1567   namespace my_ns {
1568   inline string_view to_string_view(const my_string& s) {
1569     return {s.data(), s.length()};
1570   }
1571   }
1572
1573   std::string message = fmt::format(my_string("The answer is {}."), 42);
1574   ```
1575
1576   Thanks @DanielaE.
1577
1578 - Made `std::string_view` work as a format string
1579   (https://github.com/fmtlib/fmt/pull/898):
1580
1581   ```c++
1582   auto message = fmt::format(std::string_view("The answer is {}."), 42);
1583   ```
1584
1585   Thanks @DanielaE.
1586
1587 - Added wide string support to compile-time format string checks
1588   (https://github.com/fmtlib/fmt/pull/924):
1589
1590   ```c++
1591   print(fmt(L"{:f}"), 42); // compile-time error: invalid type specifier
1592   ```
1593
1594   Thanks @XZiar.
1595
1596 - Made colored print functions work with wide strings
1597   (https://github.com/fmtlib/fmt/pull/867):
1598
1599   ```c++
1600   #include <fmt/color.h>
1601
1602   int main() {
1603     print(fg(fmt::color::red), L"{}\n", 42);
1604   }
1605   ```
1606
1607   Thanks @DanielaE.
1608
1609 - Introduced experimental Unicode support
1610   (https://github.com/fmtlib/fmt/issues/628,
1611   https://github.com/fmtlib/fmt/pull/891):
1612
1613   ```c++
1614   using namespace fmt::literals;
1615   auto s = fmt::format("{:*^5}"_u, "🤡"_u); // s == "**🤡**"_u
1616   ```
1617
1618 - Improved locale support:
1619
1620   ```c++
1621   #include <fmt/locale.h>
1622
1623   struct numpunct : std::numpunct<char> {
1624    protected:
1625     char do_thousands_sep() const override { return '~'; }
1626   };
1627
1628   std::locale loc;
1629   auto s = fmt::format(std::locale(loc, new numpunct()), "{:n}", 1234567);
1630   // s == "1~234~567"
1631   ```
1632
1633 - Constrained formatting functions on proper iterator types
1634   (https://github.com/fmtlib/fmt/pull/921). Thanks @DanielaE.
1635
1636 - Added `make_printf_args` and `make_wprintf_args` functions
1637   (https://github.com/fmtlib/fmt/pull/934). Thanks @tnovotny.
1638
1639 - Deprecated `fmt::visit`, `parse_context`, and `wparse_context`. Use
1640   `fmt::visit_format_arg`, `format_parse_context`, and
1641   `wformat_parse_context` instead.
1642
1643 - Removed undocumented `basic_fixed_buffer` which has been superseded
1644   by the iterator-based API
1645   (https://github.com/fmtlib/fmt/issues/873,
1646   https://github.com/fmtlib/fmt/pull/902). Thanks @superfunc.
1647
1648 - Disallowed repeated leading zeros in an argument ID:
1649
1650   ```c++
1651   fmt::print("{000}", 42); // error
1652   ```
1653
1654 - Reintroduced support for gcc 4.4.
1655
1656 - Fixed compilation on platforms with exotic `double`
1657   (https://github.com/fmtlib/fmt/issues/878).
1658
1659 - Improved documentation
1660   (https://github.com/fmtlib/fmt/issues/164,
1661   https://github.com/fmtlib/fmt/issues/877,
1662   https://github.com/fmtlib/fmt/pull/901,
1663   https://github.com/fmtlib/fmt/pull/906,
1664   https://github.com/fmtlib/fmt/pull/979).
1665   Thanks @kookjr, @DarkDimius and @HecticSerenity.
1666
1667 - Added pkgconfig support which makes it easier to consume the library
1668   from meson and other build systems
1669   (https://github.com/fmtlib/fmt/pull/916). Thanks @colemickens.
1670
1671 - Various build improvements
1672   (https://github.com/fmtlib/fmt/pull/909,
1673   https://github.com/fmtlib/fmt/pull/926,
1674   https://github.com/fmtlib/fmt/pull/937,
1675   https://github.com/fmtlib/fmt/pull/953,
1676   https://github.com/fmtlib/fmt/pull/959).
1677   Thanks @tchaikov, @luncliff, @AndreasSchoenle, @hotwatermorning and @Zefz.
1678
1679 - Improved `string_view` construction performance
1680   (https://github.com/fmtlib/fmt/pull/914). Thanks @gabime.
1681
1682 - Fixed non-matching char types
1683   (https://github.com/fmtlib/fmt/pull/895). Thanks @DanielaE.
1684
1685 - Fixed `format_to_n` with `std::back_insert_iterator`
1686   (https://github.com/fmtlib/fmt/pull/913). Thanks @DanielaE.
1687
1688 - Fixed locale-dependent formatting
1689   (https://github.com/fmtlib/fmt/issues/905).
1690
1691 - Fixed various compiler warnings and errors
1692   (https://github.com/fmtlib/fmt/pull/882,
1693   https://github.com/fmtlib/fmt/pull/886,
1694   https://github.com/fmtlib/fmt/pull/933,
1695   https://github.com/fmtlib/fmt/pull/941,
1696   https://github.com/fmtlib/fmt/issues/931,
1697   https://github.com/fmtlib/fmt/pull/943,
1698   https://github.com/fmtlib/fmt/pull/954,
1699   https://github.com/fmtlib/fmt/pull/956,
1700   https://github.com/fmtlib/fmt/pull/962,
1701   https://github.com/fmtlib/fmt/issues/965,
1702   https://github.com/fmtlib/fmt/issues/977,
1703   https://github.com/fmtlib/fmt/pull/983,
1704   https://github.com/fmtlib/fmt/pull/989).
1705   Thanks @Luthaf, @stevenhoving, @christinaa, @lgritz, @DanielaE,
1706   @0x8000-0000 and @liuping1997.
1707
1708 # 5.2.1 - 2018-09-21
1709
1710 - Fixed `visit` lookup issues on gcc 7 & 8
1711   (https://github.com/fmtlib/fmt/pull/870). Thanks @medithe.
1712 - Fixed linkage errors on older gcc.
1713 - Prevented `fmt/range.h` from specializing `fmt::basic_string_view`
1714   (https://github.com/fmtlib/fmt/issues/865,
1715   https://github.com/fmtlib/fmt/pull/868). Thanks @hhggit.
1716 - Improved error message when formatting unknown types
1717   (https://github.com/fmtlib/fmt/pull/872). Thanks @foonathan.
1718 - Disabled templated user-defined literals when compiled under nvcc
1719   (https://github.com/fmtlib/fmt/pull/875). Thanks @CandyGumdrop.
1720 - Fixed `format_to` formatting to `wmemory_buffer`
1721   (https://github.com/fmtlib/fmt/issues/874).
1722
1723 # 5.2.0 - 2018-09-13
1724
1725 - Optimized format string parsing and argument processing which
1726   resulted in up to 5x speed up on long format strings and significant
1727   performance boost on various benchmarks. For example, version 5.2 is
1728   2.22x faster than 5.1 on decimal integer formatting with `format_to`
1729   (macOS, clang-902.0.39.2):
1730
1731   | Method                     | Time, s         | Speedup |
1732   | -------------------------- | --------------: | ------: |
1733   | fmt::format 5.1            | 0.58            |         |
1734   | fmt::format 5.2            | 0.35            |   1.66x |
1735   | fmt::format_to 5.1         | 0.51            |         |
1736   | fmt::format_to 5.2         | 0.23            |   2.22x |
1737   | sprintf                    | 0.71            |         |
1738   | std::to_string             | 1.01            |         |
1739   | std::stringstream          | 1.73            |         |
1740
1741 - Changed the `fmt` macro from opt-out to opt-in to prevent name
1742   collisions. To enable it define the `FMT_STRING_ALIAS` macro to 1
1743   before including `fmt/format.h`:
1744
1745   ```c++
1746   #define FMT_STRING_ALIAS 1
1747   #include <fmt/format.h>
1748   std::string answer = format(fmt("{}"), 42);
1749   ```
1750
1751 - Added compile-time format string checks to `format_to` overload that
1752   takes `fmt::memory_buffer`
1753   (https://github.com/fmtlib/fmt/issues/783):
1754
1755   ```c++
1756   fmt::memory_buffer buf;
1757   // Compile-time error: invalid type specifier.
1758   fmt::format_to(buf, fmt("{:d}"), "foo");
1759   ```
1760
1761 - Moved experimental color support to `fmt/color.h` and enabled the
1762   new API by default. The old API can be enabled by defining the
1763   `FMT_DEPRECATED_COLORS` macro.
1764
1765 - Added formatting support for types explicitly convertible to
1766   `fmt::string_view`:
1767
1768   ```c++
1769   struct foo {
1770     explicit operator fmt::string_view() const { return "foo"; }
1771   };
1772   auto s = format("{}", foo());
1773   ```
1774
1775   In particular, this makes formatting function work with
1776   `folly::StringPiece`.
1777
1778 - Implemented preliminary support for `char*_t` by replacing the
1779   `format` function overloads with a single function template
1780   parameterized on the string type.
1781
1782 - Added support for dynamic argument lists
1783   (https://github.com/fmtlib/fmt/issues/814,
1784   https://github.com/fmtlib/fmt/pull/819). Thanks @MikePopoloski.
1785
1786 - Reduced executable size overhead for embedded targets using newlib
1787   nano by making locale dependency optional
1788   (https://github.com/fmtlib/fmt/pull/839). Thanks @teajay-fr.
1789
1790 - Keep `noexcept` specifier when exceptions are disabled
1791   (https://github.com/fmtlib/fmt/issues/801,
1792   https://github.com/fmtlib/fmt/pull/810). Thanks @qis.
1793
1794 - Fixed formatting of user-defined types providing `operator<<` with
1795   `format_to_n` (https://github.com/fmtlib/fmt/pull/806).
1796   Thanks @mkurdej.
1797
1798 - Fixed dynamic linkage of new symbols
1799   (https://github.com/fmtlib/fmt/issues/808).
1800
1801 - Fixed global initialization issue
1802   (https://github.com/fmtlib/fmt/issues/807):
1803
1804   ```c++
1805   // This works on compilers with constexpr support.
1806   static const std::string answer = fmt::format("{}", 42);
1807   ```
1808
1809 - Fixed various compiler warnings and errors
1810   (https://github.com/fmtlib/fmt/pull/804,
1811   https://github.com/fmtlib/fmt/issues/809,
1812   https://github.com/fmtlib/fmt/pull/811,
1813   https://github.com/fmtlib/fmt/issues/822,
1814   https://github.com/fmtlib/fmt/pull/827,
1815   https://github.com/fmtlib/fmt/issues/830,
1816   https://github.com/fmtlib/fmt/pull/838,
1817   https://github.com/fmtlib/fmt/issues/843,
1818   https://github.com/fmtlib/fmt/pull/844,
1819   https://github.com/fmtlib/fmt/issues/851,
1820   https://github.com/fmtlib/fmt/pull/852,
1821   https://github.com/fmtlib/fmt/pull/854).
1822   Thanks @henryiii, @medithe, and @eliasdaler.
1823
1824 # 5.1.0 - 2018-07-05
1825
1826 - Added experimental support for RGB color output enabled with the
1827   `FMT_EXTENDED_COLORS` macro:
1828
1829   ```c++
1830   #define FMT_EXTENDED_COLORS
1831   #define FMT_HEADER_ONLY // or compile fmt with FMT_EXTENDED_COLORS defined
1832   #include <fmt/format.h>
1833
1834   fmt::print(fmt::color::steel_blue, "Some beautiful text");
1835   ```
1836
1837   The old API (the `print_colored` and `vprint_colored` functions and
1838   the `color` enum) is now deprecated.
1839   (https://github.com/fmtlib/fmt/issues/762
1840   https://github.com/fmtlib/fmt/pull/767). thanks @Remotion.
1841
1842 - Added quotes to strings in ranges and tuples
1843   (https://github.com/fmtlib/fmt/pull/766). Thanks @Remotion.
1844
1845 - Made `format_to` work with `basic_memory_buffer`
1846   (https://github.com/fmtlib/fmt/issues/776).
1847
1848 - Added `vformat_to_n` and `wchar_t` overload of `format_to_n`
1849   (https://github.com/fmtlib/fmt/issues/764,
1850   https://github.com/fmtlib/fmt/issues/769).
1851
1852 - Made `is_range` and `is_tuple_like` part of public (experimental)
1853   API to allow specialization for user-defined types
1854   (https://github.com/fmtlib/fmt/issues/751,
1855   https://github.com/fmtlib/fmt/pull/759). Thanks @drrlvn.
1856
1857 - Added more compilers to continuous integration and increased
1858   `FMT_PEDANTIC` warning levels
1859   (https://github.com/fmtlib/fmt/pull/736). Thanks @eliaskosunen.
1860
1861 - Fixed compilation with MSVC 2013.
1862
1863 - Fixed handling of user-defined types in `format_to`
1864   (https://github.com/fmtlib/fmt/issues/793).
1865
1866 - Forced linking of inline `vformat` functions into the library
1867   (https://github.com/fmtlib/fmt/issues/795).
1868
1869 - Fixed incorrect call to on_align in `'{:}='`
1870   (https://github.com/fmtlib/fmt/issues/750).
1871
1872 - Fixed floating-point formatting to a non-back_insert_iterator with
1873   sign & numeric alignment specified
1874   (https://github.com/fmtlib/fmt/issues/756).
1875
1876 - Fixed formatting to an array with `format_to_n`
1877   (https://github.com/fmtlib/fmt/issues/778).
1878
1879 - Fixed formatting of more than 15 named arguments
1880   (https://github.com/fmtlib/fmt/issues/754).
1881
1882 - Fixed handling of compile-time strings when including
1883   `fmt/ostream.h`. (https://github.com/fmtlib/fmt/issues/768).
1884
1885 - Fixed various compiler warnings and errors
1886   (https://github.com/fmtlib/fmt/issues/742,
1887   https://github.com/fmtlib/fmt/issues/748,
1888   https://github.com/fmtlib/fmt/issues/752,
1889   https://github.com/fmtlib/fmt/issues/770,
1890   https://github.com/fmtlib/fmt/pull/775,
1891   https://github.com/fmtlib/fmt/issues/779,
1892   https://github.com/fmtlib/fmt/pull/780,
1893   https://github.com/fmtlib/fmt/pull/790,
1894   https://github.com/fmtlib/fmt/pull/792,
1895   https://github.com/fmtlib/fmt/pull/800).
1896   Thanks @Remotion, @gabime, @foonathan, @Dark-Passenger and @0x8000-0000.
1897
1898 # 5.0.0 - 2018-05-21
1899
1900 - Added a requirement for partial C++11 support, most importantly
1901   variadic templates and type traits, and dropped `FMT_VARIADIC_*`
1902   emulation macros. Variadic templates are available since GCC 4.4,
1903   Clang 2.9 and MSVC 18.0 (2013). For older compilers use {fmt}
1904   [version 4.x](https://github.com/fmtlib/fmt/releases/tag/4.1.0)
1905   which continues to be maintained and works with C++98 compilers.
1906
1907 - Renamed symbols to follow standard C++ naming conventions and
1908   proposed a subset of the library for standardization in [P0645R2
1909   Text Formatting](https://wg21.link/P0645).
1910
1911 - Implemented `constexpr` parsing of format strings and [compile-time
1912   format string
1913   checks](https://fmt.dev/latest/api.html#compile-time-format-string-checks).
1914   For example
1915
1916   ```c++
1917   #include <fmt/format.h>
1918
1919   std::string s = format(fmt("{:d}"), "foo");
1920   ```
1921
1922   gives a compile-time error because `d` is an invalid specifier for
1923   strings ([godbolt](https://godbolt.org/g/rnCy9Q)):
1924
1925       ...
1926       <source>:4:19: note: in instantiation of function template specialization 'fmt::v5::format<S, char [4]>' requested here
1927         std::string s = format(fmt("{:d}"), "foo");
1928                         ^
1929       format.h:1337:13: note: non-constexpr function 'on_error' cannot be used in a constant expression
1930           handler.on_error("invalid type specifier");
1931
1932   Compile-time checks require relaxed `constexpr` (C++14 feature)
1933   support. If the latter is not available, checks will be performed at
1934   runtime.
1935
1936 - Separated format string parsing and formatting in the extension API
1937   to enable compile-time format string processing. For example
1938
1939   ```c++
1940   struct Answer {};
1941
1942   namespace fmt {
1943   template <>
1944   struct formatter<Answer> {
1945     constexpr auto parse(parse_context& ctx) {
1946       auto it = ctx.begin();
1947       spec = *it;
1948       if (spec != 'd' && spec != 's')
1949         throw format_error("invalid specifier");
1950       return ++it;
1951     }
1952
1953     template <typename FormatContext>
1954     auto format(Answer, FormatContext& ctx) {
1955       return spec == 's' ?
1956         format_to(ctx.begin(), "{}", "fourty-two") :
1957         format_to(ctx.begin(), "{}", 42);
1958     }
1959
1960     char spec = 0;
1961   };
1962   }
1963
1964   std::string s = format(fmt("{:x}"), Answer());
1965   ```
1966
1967   gives a compile-time error due to invalid format specifier
1968   ([godbolt](https://godbolt.org/g/2jQ1Dv)):
1969
1970       ...
1971       <source>:12:45: error: expression '<throw-expression>' is not a constant expression
1972              throw format_error("invalid specifier");
1973
1974 - Added [iterator
1975   support](https://fmt.dev/latest/api.html#output-iterator-support):
1976
1977   ```c++
1978   #include <vector>
1979   #include <fmt/format.h>
1980
1981   std::vector<char> out;
1982   fmt::format_to(std::back_inserter(out), "{}", 42);
1983   ```
1984
1985 - Added the
1986   [format_to_n](https://fmt.dev/latest/api.html#_CPPv2N3fmt11format_to_nE8OutputItNSt6size_tE11string_viewDpRK4Args)
1987   function that restricts the output to the specified number of
1988   characters (https://github.com/fmtlib/fmt/issues/298):
1989
1990   ```c++
1991   char out[4];
1992   fmt::format_to_n(out, sizeof(out), "{}", 12345);
1993   // out == "1234" (without terminating '\0')
1994   ```
1995
1996 - Added the [formatted_size](
1997   https://fmt.dev/latest/api.html#_CPPv2N3fmt14formatted_sizeE11string_viewDpRK4Args)
1998   function for computing the output size:
1999
2000   ```c++
2001   #include <fmt/format.h>
2002
2003   auto size = fmt::formatted_size("{}", 12345); // size == 5
2004   ```
2005
2006 - Improved compile times by reducing dependencies on standard headers
2007   and providing a lightweight [core
2008   API](https://fmt.dev/latest/api.html#core-api):
2009
2010   ```c++
2011   #include <fmt/core.h>
2012
2013   fmt::print("The answer is {}.", 42);
2014   ```
2015
2016   See [Compile time and code
2017   bloat](https://github.com/fmtlib/fmt#compile-time-and-code-bloat).
2018
2019 - Added the [make_format_args](
2020   https://fmt.dev/latest/api.html#_CPPv2N3fmt16make_format_argsEDpRK4Args)
2021   function for capturing formatting arguments:
2022
2023   ```c++
2024   // Prints formatted error message.
2025   void vreport_error(const char *format, fmt::format_args args) {
2026     fmt::print("Error: ");
2027     fmt::vprint(format, args);
2028   }
2029   template <typename... Args>
2030   void report_error(const char *format, const Args & ... args) {
2031     vreport_error(format, fmt::make_format_args(args...));
2032   }
2033   ```
2034
2035 - Added the `make_printf_args` function for capturing `printf`
2036   arguments (https://github.com/fmtlib/fmt/issues/687,
2037   https://github.com/fmtlib/fmt/pull/694). Thanks @Kronuz.
2038
2039 - Added prefix `v` to non-variadic functions taking `format_args` to
2040   distinguish them from variadic ones:
2041
2042   ```c++
2043   std::string vformat(string_view format_str, format_args args);
2044
2045   template <typename... Args>
2046   std::string format(string_view format_str, const Args & ... args);
2047   ```
2048
2049 - Added experimental support for formatting ranges, containers and
2050   tuple-like types in `fmt/ranges.h`
2051   (https://github.com/fmtlib/fmt/pull/735):
2052
2053   ```c++
2054   #include <fmt/ranges.h>
2055
2056   std::vector<int> v = {1, 2, 3};
2057   fmt::print("{}", v); // prints {1, 2, 3}
2058   ```
2059
2060   Thanks @Remotion.
2061
2062 - Implemented `wchar_t` date and time formatting
2063   (https://github.com/fmtlib/fmt/pull/712):
2064
2065   ```c++
2066   #include <fmt/time.h>
2067
2068   std::time_t t = std::time(nullptr);
2069   auto s = fmt::format(L"The date is {:%Y-%m-%d}.", *std::localtime(&t));
2070   ```
2071
2072   Thanks @DanielaE.
2073
2074 - Provided more wide string overloads
2075   (https://github.com/fmtlib/fmt/pull/724). Thanks @DanielaE.
2076
2077 - Switched from a custom null-terminated string view class to
2078   `string_view` in the format API and provided `fmt::string_view`
2079   which implements a subset of `std::string_view` API for pre-C++17
2080   systems.
2081
2082 - Added support for `std::experimental::string_view`
2083   (https://github.com/fmtlib/fmt/pull/607):
2084
2085   ```c++
2086   #include <fmt/core.h>
2087   #include <experimental/string_view>
2088
2089   fmt::print("{}", std::experimental::string_view("foo"));
2090   ```
2091
2092   Thanks @virgiliofornazin.
2093
2094 - Allowed mixing named and automatic arguments:
2095
2096   ```c++
2097   fmt::format("{} {two}", 1, fmt::arg("two", 2));
2098   ```
2099
2100 - Removed the write API in favor of the [format
2101   API](https://fmt.dev/latest/api.html#format-api) with compile-time
2102   handling of format strings.
2103
2104 - Disallowed formatting of multibyte strings into a wide character
2105   target (https://github.com/fmtlib/fmt/pull/606).
2106
2107 - Improved documentation
2108   (https://github.com/fmtlib/fmt/pull/515,
2109   https://github.com/fmtlib/fmt/issues/614,
2110   https://github.com/fmtlib/fmt/pull/617,
2111   https://github.com/fmtlib/fmt/pull/661,
2112   https://github.com/fmtlib/fmt/pull/680).
2113   Thanks @ibell, @mihaitodor and @johnthagen.
2114
2115 - Implemented more efficient handling of large number of format
2116   arguments.
2117
2118 - Introduced an inline namespace for symbol versioning.
2119
2120 - Added debug postfix `d` to the `fmt` library name
2121   (https://github.com/fmtlib/fmt/issues/636).
2122
2123 - Removed unnecessary `fmt/` prefix in includes
2124   (https://github.com/fmtlib/fmt/pull/397). Thanks @chronoxor.
2125
2126 - Moved `fmt/*.h` to `include/fmt/*.h` to prevent irrelevant files and
2127   directories appearing on the include search paths when fmt is used
2128   as a subproject and moved source files to the `src` directory.
2129
2130 - Added qmake project file `support/fmt.pro`
2131   (https://github.com/fmtlib/fmt/pull/641). Thanks @cowo78.
2132
2133 - Added Gradle build file `support/build.gradle`
2134   (https://github.com/fmtlib/fmt/pull/649). Thanks @luncliff.
2135
2136 - Removed `FMT_CPPFORMAT` CMake option.
2137
2138 - Fixed a name conflict with the macro `CHAR_WIDTH` in glibc
2139   (https://github.com/fmtlib/fmt/pull/616). Thanks @aroig.
2140
2141 - Fixed handling of nested braces in `fmt::join`
2142   (https://github.com/fmtlib/fmt/issues/638).
2143
2144 - Added `SOURCELINK_SUFFIX` for compatibility with Sphinx 1.5
2145   (https://github.com/fmtlib/fmt/pull/497). Thanks @ginggs.
2146
2147 - Added a missing `inline` in the header-only mode
2148   (https://github.com/fmtlib/fmt/pull/626). Thanks @aroig.
2149
2150 - Fixed various compiler warnings
2151   (https://github.com/fmtlib/fmt/pull/640,
2152   https://github.com/fmtlib/fmt/pull/656,
2153   https://github.com/fmtlib/fmt/pull/679,
2154   https://github.com/fmtlib/fmt/pull/681,
2155   https://github.com/fmtlib/fmt/pull/705,
2156   https://github.com/fmtlib/fmt/issues/715,
2157   https://github.com/fmtlib/fmt/pull/717,
2158   https://github.com/fmtlib/fmt/pull/720,
2159   https://github.com/fmtlib/fmt/pull/723,
2160   https://github.com/fmtlib/fmt/pull/726,
2161   https://github.com/fmtlib/fmt/pull/730,
2162   https://github.com/fmtlib/fmt/pull/739).
2163   Thanks @peterbell10, @LarsGullik, @foonathan, @eliaskosunen,
2164   @christianparpart, @DanielaE and @mwinterb.
2165
2166 - Worked around an MSVC bug and fixed several warnings
2167   (https://github.com/fmtlib/fmt/pull/653). Thanks @alabuzhev.
2168
2169 - Worked around GCC bug 67371
2170   (https://github.com/fmtlib/fmt/issues/682).
2171
2172 - Fixed compilation with `-fno-exceptions`
2173   (https://github.com/fmtlib/fmt/pull/655). Thanks @chenxiaolong.
2174
2175 - Made `constexpr remove_prefix` gcc version check tighter
2176   (https://github.com/fmtlib/fmt/issues/648).
2177
2178 - Renamed internal type enum constants to prevent collision with
2179   poorly written C libraries
2180   (https://github.com/fmtlib/fmt/issues/644).
2181
2182 - Added detection of `wostream operator<<`
2183   (https://github.com/fmtlib/fmt/issues/650).
2184
2185 - Fixed compilation on OpenBSD
2186   (https://github.com/fmtlib/fmt/pull/660). Thanks @hubslave.
2187
2188 - Fixed compilation on FreeBSD 12
2189   (https://github.com/fmtlib/fmt/pull/732). Thanks @dankm.
2190
2191 - Fixed compilation when there is a mismatch between `-std` options
2192   between the library and user code
2193   (https://github.com/fmtlib/fmt/issues/664).
2194
2195 - Fixed compilation with GCC 7 and `-std=c++11`
2196   (https://github.com/fmtlib/fmt/issues/734).
2197
2198 - Improved generated binary code on GCC 7 and older
2199   (https://github.com/fmtlib/fmt/issues/668).
2200
2201 - Fixed handling of numeric alignment with no width
2202   (https://github.com/fmtlib/fmt/issues/675).
2203
2204 - Fixed handling of empty strings in UTF8/16 converters
2205   (https://github.com/fmtlib/fmt/pull/676). Thanks @vgalka-sl.
2206
2207 - Fixed formatting of an empty `string_view`
2208   (https://github.com/fmtlib/fmt/issues/689).
2209
2210 - Fixed detection of `string_view` on libc++
2211   (https://github.com/fmtlib/fmt/issues/686).
2212
2213 - Fixed DLL issues (https://github.com/fmtlib/fmt/pull/696).
2214   Thanks @sebkoenig.
2215
2216 - Fixed compile checks for mixing narrow and wide strings
2217   (https://github.com/fmtlib/fmt/issues/690).
2218
2219 - Disabled unsafe implicit conversion to `std::string`
2220   (https://github.com/fmtlib/fmt/issues/729).
2221
2222 - Fixed handling of reused format specs (as in `fmt::join`) for
2223   pointers (https://github.com/fmtlib/fmt/pull/725). Thanks @mwinterb.
2224
2225 - Fixed installation of `fmt/ranges.h`
2226   (https://github.com/fmtlib/fmt/pull/738). Thanks @sv1990.
2227
2228 # 4.1.0 - 2017-12-20
2229
2230 - Added `fmt::to_wstring()` in addition to `fmt::to_string()`
2231   (https://github.com/fmtlib/fmt/pull/559). Thanks @alabuzhev.
2232 - Added support for C++17 `std::string_view`
2233   (https://github.com/fmtlib/fmt/pull/571 and
2234   https://github.com/fmtlib/fmt/pull/578).
2235   Thanks @thelostt and @mwinterb.
2236 - Enabled stream exceptions to catch errors
2237   (https://github.com/fmtlib/fmt/issues/581). Thanks @crusader-mike.
2238 - Allowed formatting of class hierarchies with `fmt::format_arg()`
2239   (https://github.com/fmtlib/fmt/pull/547). Thanks @rollbear.
2240 - Removed limitations on character types
2241   (https://github.com/fmtlib/fmt/pull/563). Thanks @Yelnats321.
2242 - Conditionally enabled use of `std::allocator_traits`
2243   (https://github.com/fmtlib/fmt/pull/583). Thanks @mwinterb.
2244 - Added support for `const` variadic member function emulation with
2245   `FMT_VARIADIC_CONST`
2246   (https://github.com/fmtlib/fmt/pull/591). Thanks @ludekvodicka.
2247 - Various bugfixes: bad overflow check, unsupported implicit type
2248   conversion when determining formatting function, test segfaults
2249   (https://github.com/fmtlib/fmt/issues/551), ill-formed
2250   macros (https://github.com/fmtlib/fmt/pull/542) and
2251   ambiguous overloads
2252   (https://github.com/fmtlib/fmt/issues/580). Thanks @xylosper.
2253 - Prevented warnings on MSVC
2254   (https://github.com/fmtlib/fmt/pull/605,
2255   https://github.com/fmtlib/fmt/pull/602, and
2256   https://github.com/fmtlib/fmt/pull/545), clang
2257   (https://github.com/fmtlib/fmt/pull/582), GCC
2258   (https://github.com/fmtlib/fmt/issues/573), various
2259   conversion warnings (https://github.com/fmtlib/fmt/pull/609,
2260   https://github.com/fmtlib/fmt/pull/567,
2261   https://github.com/fmtlib/fmt/pull/553 and
2262   https://github.com/fmtlib/fmt/pull/553), and added
2263   `override` and `[[noreturn]]`
2264   (https://github.com/fmtlib/fmt/pull/549 and
2265   https://github.com/fmtlib/fmt/issues/555).
2266   Thanks @alabuzhev, @virgiliofornazin, @alexanderbock, @yumetodo, @VaderY,
2267   @jpcima, @thelostt and @Manu343726.
2268 - Improved CMake: Used `GNUInstallDirs` to set installation location
2269   (https://github.com/fmtlib/fmt/pull/610) and fixed warnings
2270   (https://github.com/fmtlib/fmt/pull/536 and
2271   https://github.com/fmtlib/fmt/pull/556).
2272   Thanks @mikecrowe, @evgen231 and @henryiii.
2273
2274 # 4.0.0 - 2017-06-27
2275
2276 - Removed old compatibility headers `cppformat/*.h` and CMake options
2277   (https://github.com/fmtlib/fmt/pull/527). Thanks @maddinat0r.
2278
2279 - Added `string.h` containing `fmt::to_string()` as alternative to
2280   `std::to_string()` as well as other string writer functionality
2281   (https://github.com/fmtlib/fmt/issues/326 and
2282   https://github.com/fmtlib/fmt/pull/441):
2283
2284   ```c++
2285   #include "fmt/string.h"
2286
2287   std::string answer = fmt::to_string(42);
2288   ```
2289
2290   Thanks @glebov-andrey.
2291
2292 - Moved `fmt::printf()` to new `printf.h` header and allowed `%s` as
2293   generic specifier (https://github.com/fmtlib/fmt/pull/453),
2294   made `%.f` more conformant to regular `printf()`
2295   (https://github.com/fmtlib/fmt/pull/490), added custom
2296   writer support (https://github.com/fmtlib/fmt/issues/476)
2297   and implemented missing custom argument formatting
2298   (https://github.com/fmtlib/fmt/pull/339 and
2299   https://github.com/fmtlib/fmt/pull/340):
2300
2301   ```c++
2302   #include "fmt/printf.h"
2303
2304   // %s format specifier can be used with any argument type.
2305   fmt::printf("%s", 42);
2306   ```
2307
2308   Thanks @mojoBrendan, @manylegged and @spacemoose.
2309   See also https://github.com/fmtlib/fmt/issues/360,
2310   https://github.com/fmtlib/fmt/issues/335 and
2311   https://github.com/fmtlib/fmt/issues/331.
2312
2313 - Added `container.h` containing a `BasicContainerWriter` to write to
2314   containers like `std::vector`
2315   (https://github.com/fmtlib/fmt/pull/450). Thanks @polyvertex.
2316
2317 - Added `fmt::join()` function that takes a range and formats its
2318   elements separated by a given string
2319   (https://github.com/fmtlib/fmt/pull/466):
2320
2321   ```c++
2322   #include "fmt/format.h"
2323
2324   std::vector<double> v = {1.2, 3.4, 5.6};
2325   // Prints "(+01.20, +03.40, +05.60)".
2326   fmt::print("({:+06.2f})", fmt::join(v.begin(), v.end(), ", "));
2327   ```
2328
2329   Thanks @olivier80.
2330
2331 - Added support for custom formatting specifications to simplify
2332   customization of built-in formatting
2333   (https://github.com/fmtlib/fmt/pull/444). Thanks @polyvertex.
2334   See also https://github.com/fmtlib/fmt/issues/439.
2335
2336 - Added `fmt::format_system_error()` for error code formatting
2337   (https://github.com/fmtlib/fmt/issues/323 and
2338   https://github.com/fmtlib/fmt/pull/526). Thanks @maddinat0r.
2339
2340 - Added thread-safe `fmt::localtime()` and `fmt::gmtime()` as
2341   replacement for the standard version to `time.h`
2342   (https://github.com/fmtlib/fmt/pull/396). Thanks @codicodi.
2343
2344 - Internal improvements to `NamedArg` and `ArgLists`
2345   (https://github.com/fmtlib/fmt/pull/389 and
2346   https://github.com/fmtlib/fmt/pull/390). Thanks @chronoxor.
2347
2348 - Fixed crash due to bug in `FormatBuf`
2349   (https://github.com/fmtlib/fmt/pull/493). Thanks @effzeh. See also
2350   https://github.com/fmtlib/fmt/issues/480 and
2351   https://github.com/fmtlib/fmt/issues/491.
2352
2353 - Fixed handling of wide strings in `fmt::StringWriter`.
2354
2355 - Improved compiler error messages
2356   (https://github.com/fmtlib/fmt/issues/357).
2357
2358 - Fixed various warnings and issues with various compilers
2359   (https://github.com/fmtlib/fmt/pull/494,
2360   https://github.com/fmtlib/fmt/pull/499,
2361   https://github.com/fmtlib/fmt/pull/483,
2362   https://github.com/fmtlib/fmt/pull/485,
2363   https://github.com/fmtlib/fmt/pull/482,
2364   https://github.com/fmtlib/fmt/pull/475,
2365   https://github.com/fmtlib/fmt/pull/473 and
2366   https://github.com/fmtlib/fmt/pull/414).
2367   Thanks @chronoxor, @zhaohuaxishi, @pkestene, @dschmidt and @0x414c.
2368
2369 - Improved CMake: targets are now namespaced
2370   (https://github.com/fmtlib/fmt/pull/511 and
2371   https://github.com/fmtlib/fmt/pull/513), supported
2372   header-only `printf.h`
2373   (https://github.com/fmtlib/fmt/pull/354), fixed issue with
2374   minimal supported library subset
2375   (https://github.com/fmtlib/fmt/issues/418,
2376   https://github.com/fmtlib/fmt/pull/419 and
2377   https://github.com/fmtlib/fmt/pull/420).
2378   Thanks @bjoernthiel, @niosHD, @LogicalKnight and @alabuzhev.
2379
2380 - Improved documentation (https://github.com/fmtlib/fmt/pull/393).
2381   Thanks @pwm1234.
2382
2383 # 3.0.2 - 2017-06-14
2384
2385 - Added `FMT_VERSION` macro
2386   (https://github.com/fmtlib/fmt/issues/411).
2387 - Used `FMT_NULL` instead of literal `0`
2388   (https://github.com/fmtlib/fmt/pull/409). Thanks @alabuzhev.
2389 - Added extern templates for `format_float`
2390   (https://github.com/fmtlib/fmt/issues/413).
2391 - Fixed implicit conversion issue
2392   (https://github.com/fmtlib/fmt/issues/507).
2393 - Fixed signbit detection
2394   (https://github.com/fmtlib/fmt/issues/423).
2395 - Fixed naming collision
2396   (https://github.com/fmtlib/fmt/issues/425).
2397 - Fixed missing intrinsic for C++/CLI
2398   (https://github.com/fmtlib/fmt/pull/457). Thanks @calumr.
2399 - Fixed Android detection
2400   (https://github.com/fmtlib/fmt/pull/458). Thanks @Gachapen.
2401 - Use lean `windows.h` if not in header-only mode
2402   (https://github.com/fmtlib/fmt/pull/503). Thanks @Quentin01.
2403 - Fixed issue with CMake exporting C++11 flag
2404   (https://github.com/fmtlib/fmt/pull/455). Thanks @EricWF.
2405 - Fixed issue with nvcc and MSVC compiler bug and MinGW
2406   (https://github.com/fmtlib/fmt/issues/505).
2407 - Fixed DLL issues (https://github.com/fmtlib/fmt/pull/469 and
2408   https://github.com/fmtlib/fmt/pull/502).
2409   Thanks @richardeakin and @AndreasSchoenle.
2410 - Fixed test compilation under FreeBSD
2411   (https://github.com/fmtlib/fmt/issues/433).
2412 - Fixed various warnings
2413   (https://github.com/fmtlib/fmt/pull/403,
2414   https://github.com/fmtlib/fmt/pull/410 and
2415   https://github.com/fmtlib/fmt/pull/510).
2416   Thanks @Lecetem, @chenhayat and @trozen.
2417 - Worked around a broken `__builtin_clz` in clang with MS codegen
2418   (https://github.com/fmtlib/fmt/issues/519).
2419 - Removed redundant include
2420   (https://github.com/fmtlib/fmt/issues/479).
2421 - Fixed documentation issues.
2422
2423 # 3.0.1 - 2016-11-01
2424
2425 - Fixed handling of thousands separator
2426   (https://github.com/fmtlib/fmt/issues/353).
2427 - Fixed handling of `unsigned char` strings
2428   (https://github.com/fmtlib/fmt/issues/373).
2429 - Corrected buffer growth when formatting time
2430   (https://github.com/fmtlib/fmt/issues/367).
2431 - Removed warnings under MSVC and clang
2432   (https://github.com/fmtlib/fmt/issues/318,
2433   https://github.com/fmtlib/fmt/issues/250, also merged
2434   https://github.com/fmtlib/fmt/pull/385 and
2435   https://github.com/fmtlib/fmt/pull/361).
2436   Thanks @jcelerier and @nmoehrle.
2437 - Fixed compilation issues under Android
2438   (https://github.com/fmtlib/fmt/pull/327,
2439   https://github.com/fmtlib/fmt/issues/345 and
2440   https://github.com/fmtlib/fmt/pull/381), FreeBSD
2441   (https://github.com/fmtlib/fmt/pull/358), Cygwin
2442   (https://github.com/fmtlib/fmt/issues/388), MinGW
2443   (https://github.com/fmtlib/fmt/issues/355) as well as other
2444   issues (https://github.com/fmtlib/fmt/issues/350,
2445   https://github.com/fmtlib/fmt/issues/355,
2446   https://github.com/fmtlib/fmt/pull/348,
2447   https://github.com/fmtlib/fmt/pull/402,
2448   https://github.com/fmtlib/fmt/pull/405).
2449   Thanks @dpantele, @hghwng, @arvedarved, @LogicalKnight and @JanHellwig.
2450 - Fixed some documentation issues and extended specification
2451   (https://github.com/fmtlib/fmt/issues/320,
2452   https://github.com/fmtlib/fmt/pull/333,
2453   https://github.com/fmtlib/fmt/issues/347,
2454   https://github.com/fmtlib/fmt/pull/362). Thanks @smellman.
2455
2456 # 3.0.0 - 2016-05-07
2457
2458 - The project has been renamed from C++ Format (cppformat) to fmt for
2459   consistency with the used namespace and macro prefix
2460   (https://github.com/fmtlib/fmt/issues/307). Library headers
2461   are now located in the `fmt` directory:
2462
2463   ```c++
2464   #include "fmt/format.h"
2465   ```
2466
2467   Including `format.h` from the `cppformat` directory is deprecated
2468   but works via a proxy header which will be removed in the next major
2469   version.
2470
2471   The documentation is now available at <https://fmt.dev>.
2472
2473 - Added support for
2474   [strftime](http://en.cppreference.com/w/cpp/chrono/c/strftime)-like
2475   [date and time
2476   formatting](https://fmt.dev/3.0.0/api.html#date-and-time-formatting)
2477   (https://github.com/fmtlib/fmt/issues/283):
2478
2479   ```c++
2480   #include "fmt/time.h"
2481
2482   std::time_t t = std::time(nullptr);
2483   // Prints "The date is 2016-04-29." (with the current date)
2484   fmt::print("The date is {:%Y-%m-%d}.", *std::localtime(&t));
2485   ```
2486
2487 - `std::ostream` support including formatting of user-defined types
2488   that provide overloaded `operator<<` has been moved to
2489   `fmt/ostream.h`:
2490
2491   ```c++
2492   #include "fmt/ostream.h"
2493
2494   class Date {
2495     int year_, month_, day_;
2496   public:
2497     Date(int year, int month, int day) : year_(year), month_(month), day_(day) {}
2498
2499     friend std::ostream &operator<<(std::ostream &os, const Date &d) {
2500       return os << d.year_ << '-' << d.month_ << '-' << d.day_;
2501     }
2502   };
2503
2504   std::string s = fmt::format("The date is {}", Date(2012, 12, 9));
2505   // s == "The date is 2012-12-9"
2506   ```
2507
2508 - Added support for [custom argument
2509   formatters](https://fmt.dev/3.0.0/api.html#argument-formatters)
2510   (https://github.com/fmtlib/fmt/issues/235).
2511
2512 - Added support for locale-specific integer formatting with the `n`
2513   specifier (https://github.com/fmtlib/fmt/issues/305):
2514
2515   ```c++
2516   std::setlocale(LC_ALL, "en_US.utf8");
2517   fmt::print("cppformat: {:n}\n", 1234567); // prints 1,234,567
2518   ```
2519
2520 - Sign is now preserved when formatting an integer with an incorrect
2521   `printf` format specifier
2522   (https://github.com/fmtlib/fmt/issues/265):
2523
2524   ```c++
2525   fmt::printf("%lld", -42); // prints -42
2526   ```
2527
2528   Note that it would be an undefined behavior in `std::printf`.
2529
2530 - Length modifiers such as `ll` are now optional in printf formatting
2531   functions and the correct type is determined automatically
2532   (https://github.com/fmtlib/fmt/issues/255):
2533
2534   ```c++
2535   fmt::printf("%d", std::numeric_limits<long long>::max());
2536   ```
2537
2538   Note that it would be an undefined behavior in `std::printf`.
2539
2540 - Added initial support for custom formatters
2541   (https://github.com/fmtlib/fmt/issues/231).
2542
2543 - Fixed detection of user-defined literal support on Intel C++
2544   compiler (https://github.com/fmtlib/fmt/issues/311,
2545   https://github.com/fmtlib/fmt/pull/312).
2546   Thanks @dean0x7d and @speth.
2547
2548 - Reduced compile time
2549   (https://github.com/fmtlib/fmt/pull/243,
2550   https://github.com/fmtlib/fmt/pull/249,
2551   https://github.com/fmtlib/fmt/issues/317):
2552
2553   ![](https://cloud.githubusercontent.com/assets/4831417/11614060/b9e826d2-9c36-11e5-8666-d4131bf503ef.png)
2554
2555   ![](https://cloud.githubusercontent.com/assets/4831417/11614080/6ac903cc-9c37-11e5-8165-26df6efae364.png)
2556
2557   Thanks @dean0x7d.
2558
2559 - Compile test fixes (https://github.com/fmtlib/fmt/pull/313).
2560   Thanks @dean0x7d.
2561
2562 - Documentation fixes (https://github.com/fmtlib/fmt/pull/239,
2563   https://github.com/fmtlib/fmt/issues/248,
2564   https://github.com/fmtlib/fmt/issues/252,
2565   https://github.com/fmtlib/fmt/pull/258,
2566   https://github.com/fmtlib/fmt/issues/260,
2567   https://github.com/fmtlib/fmt/issues/301,
2568   https://github.com/fmtlib/fmt/pull/309).
2569   Thanks @ReadmeCritic @Gachapen and @jwilk.
2570
2571 - Fixed compiler and sanitizer warnings
2572   (https://github.com/fmtlib/fmt/issues/244,
2573   https://github.com/fmtlib/fmt/pull/256,
2574   https://github.com/fmtlib/fmt/pull/259,
2575   https://github.com/fmtlib/fmt/issues/263,
2576   https://github.com/fmtlib/fmt/issues/274,
2577   https://github.com/fmtlib/fmt/pull/277,
2578   https://github.com/fmtlib/fmt/pull/286,
2579   https://github.com/fmtlib/fmt/issues/291,
2580   https://github.com/fmtlib/fmt/issues/296,
2581   https://github.com/fmtlib/fmt/issues/308).
2582   Thanks @mwinterb, @pweiskircher and @Naios.
2583
2584 - Improved compatibility with Windows Store apps
2585   (https://github.com/fmtlib/fmt/issues/280,
2586   https://github.com/fmtlib/fmt/pull/285) Thanks @mwinterb.
2587
2588 - Added tests of compatibility with older C++ standards
2589   (https://github.com/fmtlib/fmt/pull/273). Thanks @niosHD.
2590
2591 - Fixed Android build
2592   (https://github.com/fmtlib/fmt/pull/271). Thanks @newnon.
2593
2594 - Changed `ArgMap` to be backed by a vector instead of a map.
2595   (https://github.com/fmtlib/fmt/issues/261,
2596   https://github.com/fmtlib/fmt/pull/262). Thanks @mwinterb.
2597
2598 - Added `fprintf` overload that writes to a `std::ostream`
2599   (https://github.com/fmtlib/fmt/pull/251).
2600   Thanks @nickhutchinson.
2601
2602 - Export symbols when building a Windows DLL
2603   (https://github.com/fmtlib/fmt/pull/245).
2604   Thanks @macdems.
2605
2606 - Fixed compilation on Cygwin
2607   (https://github.com/fmtlib/fmt/issues/304).
2608
2609 - Implemented a workaround for a bug in Apple LLVM version 4.2 of
2610   clang (https://github.com/fmtlib/fmt/issues/276).
2611
2612 - Implemented a workaround for Google Test bug
2613   https://github.com/google/googletest/issues/705 on gcc 6
2614   (https://github.com/fmtlib/fmt/issues/268). Thanks @octoploid.
2615
2616 - Removed Biicode support because the latter has been discontinued.
2617
2618 # 2.1.1 - 2016-04-11
2619
2620 - The install location for generated CMake files is now configurable
2621   via the `FMT_CMAKE_DIR` CMake variable
2622   (https://github.com/fmtlib/fmt/pull/299). Thanks @niosHD.
2623 - Documentation fixes
2624   (https://github.com/fmtlib/fmt/issues/252).
2625
2626 # 2.1.0 - 2016-03-21
2627
2628 - Project layout and build system improvements
2629   (https://github.com/fmtlib/fmt/pull/267):
2630
2631   -   The code have been moved to the `cppformat` directory. Including
2632       `format.h` from the top-level directory is deprecated but works
2633       via a proxy header which will be removed in the next major
2634       version.
2635   -   C++ Format CMake targets now have proper interface definitions.
2636   -   Installed version of the library now supports the header-only
2637       configuration.
2638   -   Targets `doc`, `install`, and `test` are now disabled if C++
2639       Format is included as a CMake subproject. They can be enabled by
2640       setting `FMT_DOC`, `FMT_INSTALL`, and `FMT_TEST` in the parent
2641       project.
2642
2643   Thanks @niosHD.
2644
2645 # 2.0.1 - 2016-03-13
2646
2647 - Improved CMake find and package support
2648   (https://github.com/fmtlib/fmt/issues/264). Thanks @niosHD.
2649 - Fix compile error with Android NDK and mingw32
2650   (https://github.com/fmtlib/fmt/issues/241). Thanks @Gachapen.
2651 - Documentation fixes
2652   (https://github.com/fmtlib/fmt/issues/248,
2653   https://github.com/fmtlib/fmt/issues/260).
2654
2655 # 2.0.0 - 2015-12-01
2656
2657 ## General
2658
2659 - \[Breaking\] Named arguments
2660   (https://github.com/fmtlib/fmt/pull/169,
2661   https://github.com/fmtlib/fmt/pull/173,
2662   https://github.com/fmtlib/fmt/pull/174):
2663
2664   ```c++
2665   fmt::print("The answer is {answer}.", fmt::arg("answer", 42));
2666   ```
2667
2668   Thanks @jamboree.
2669
2670 - \[Experimental\] User-defined literals for format and named
2671   arguments (https://github.com/fmtlib/fmt/pull/204,
2672   https://github.com/fmtlib/fmt/pull/206,
2673   https://github.com/fmtlib/fmt/pull/207):
2674
2675   ```c++
2676   using namespace fmt::literals;
2677   fmt::print("The answer is {answer}.", "answer"_a=42);
2678   ```
2679
2680   Thanks @dean0x7d.
2681
2682 - \[Breaking\] Formatting of more than 16 arguments is now supported
2683   when using variadic templates
2684   (https://github.com/fmtlib/fmt/issues/141). Thanks @Shauren.
2685
2686 - Runtime width specification
2687   (https://github.com/fmtlib/fmt/pull/168):
2688
2689   ```c++
2690   fmt::format("{0:{1}}", 42, 5); // gives "   42"
2691   ```
2692
2693   Thanks @jamboree.
2694
2695 - \[Breaking\] Enums are now formatted with an overloaded
2696   `std::ostream` insertion operator (`operator<<`) if available
2697   (https://github.com/fmtlib/fmt/issues/232).
2698
2699 - \[Breaking\] Changed default `bool` format to textual, \"true\" or
2700   \"false\" (https://github.com/fmtlib/fmt/issues/170):
2701
2702   ```c++
2703   fmt::print("{}", true); // prints "true"
2704   ```
2705
2706   To print `bool` as a number use numeric format specifier such as
2707   `d`:
2708
2709   ```c++
2710   fmt::print("{:d}", true); // prints "1"
2711   ```
2712
2713 - `fmt::printf` and `fmt::sprintf` now support formatting of `bool`
2714   with the `%s` specifier giving textual output, \"true\" or \"false\"
2715   (https://github.com/fmtlib/fmt/pull/223):
2716
2717   ```c++
2718   fmt::printf("%s", true); // prints "true"
2719   ```
2720
2721   Thanks @LarsGullik.
2722
2723 - \[Breaking\] `signed char` and `unsigned char` are now formatted as
2724   integers by default
2725   (https://github.com/fmtlib/fmt/pull/217).
2726
2727 - \[Breaking\] Pointers to C strings can now be formatted with the `p`
2728   specifier (https://github.com/fmtlib/fmt/pull/223):
2729
2730   ```c++
2731   fmt::print("{:p}", "test"); // prints pointer value
2732   ```
2733
2734   Thanks @LarsGullik.
2735
2736 - \[Breaking\] `fmt::printf` and `fmt::sprintf` now print null
2737   pointers as `(nil)` and null strings as `(null)` for consistency
2738   with glibc (https://github.com/fmtlib/fmt/pull/226).
2739   Thanks @LarsGullik.
2740
2741 - \[Breaking\] `fmt::(s)printf` now supports formatting of objects of
2742   user-defined types that provide an overloaded `std::ostream`
2743   insertion operator (`operator<<`)
2744   (https://github.com/fmtlib/fmt/issues/201):
2745
2746   ```c++
2747   fmt::printf("The date is %s", Date(2012, 12, 9));
2748   ```
2749
2750 - \[Breaking\] The `Buffer` template is now part of the public API and
2751   can be used to implement custom memory buffers
2752   (https://github.com/fmtlib/fmt/issues/140). Thanks @polyvertex.
2753
2754 - \[Breaking\] Improved compatibility between `BasicStringRef` and
2755   [std::experimental::basic_string_view](
2756   http://en.cppreference.com/w/cpp/experimental/basic_string_view)
2757   (https://github.com/fmtlib/fmt/issues/100,
2758   https://github.com/fmtlib/fmt/issues/159,
2759   https://github.com/fmtlib/fmt/issues/183):
2760
2761   -   Comparison operators now compare string content, not pointers
2762   -   `BasicStringRef::c_str` replaced by `BasicStringRef::data`
2763   -   `BasicStringRef` is no longer assumed to be null-terminated
2764
2765   References to null-terminated strings are now represented by a new
2766   class, `BasicCStringRef`.
2767
2768 - Dependency on pthreads introduced by Google Test is now optional
2769   (https://github.com/fmtlib/fmt/issues/185).
2770
2771 - New CMake options `FMT_DOC`, `FMT_INSTALL` and `FMT_TEST` to control
2772   generation of `doc`, `install` and `test` targets respectively, on
2773   by default (https://github.com/fmtlib/fmt/issues/197,
2774   https://github.com/fmtlib/fmt/issues/198,
2775   https://github.com/fmtlib/fmt/issues/200). Thanks @maddinat0r.
2776
2777 - `noexcept` is now used when compiling with MSVC2015
2778   (https://github.com/fmtlib/fmt/pull/215). Thanks @dmkrepo.
2779
2780 - Added an option to disable use of `windows.h` when
2781   `FMT_USE_WINDOWS_H` is defined as 0 before including `format.h`
2782   (https://github.com/fmtlib/fmt/issues/171). Thanks @alfps.
2783
2784 - \[Breaking\] `windows.h` is now included with `NOMINMAX` unless
2785   `FMT_WIN_MINMAX` is defined. This is done to prevent breaking code
2786   using `std::min` and `std::max` and only affects the header-only
2787   configuration (https://github.com/fmtlib/fmt/issues/152,
2788   https://github.com/fmtlib/fmt/pull/153,
2789   https://github.com/fmtlib/fmt/pull/154). Thanks @DevO2012.
2790
2791 - Improved support for custom character types
2792   (https://github.com/fmtlib/fmt/issues/171). Thanks @alfps.
2793
2794 - Added an option to disable use of IOStreams when `FMT_USE_IOSTREAMS`
2795   is defined as 0 before including `format.h`
2796   (https://github.com/fmtlib/fmt/issues/205,
2797   https://github.com/fmtlib/fmt/pull/208). Thanks @JodiTheTigger.
2798
2799 - Improved detection of `isnan`, `isinf` and `signbit`.
2800
2801 ## Optimization
2802
2803 - Made formatting of user-defined types more efficient with a custom
2804   stream buffer (https://github.com/fmtlib/fmt/issues/92,
2805   https://github.com/fmtlib/fmt/pull/230). Thanks @NotImplemented.
2806 - Further improved performance of `fmt::Writer` on integer formatting
2807   and fixed a minor regression. Now it is \~7% faster than
2808   `karma::generate` on Karma\'s benchmark
2809   (https://github.com/fmtlib/fmt/issues/186).
2810 - \[Breaking\] Reduced [compiled code
2811   size](https://github.com/fmtlib/fmt#compile-time-and-code-bloat)
2812   (https://github.com/fmtlib/fmt/issues/143,
2813   https://github.com/fmtlib/fmt/pull/149).
2814
2815 ## Distribution
2816
2817 - \[Breaking\] Headers are now installed in
2818   `${CMAKE_INSTALL_PREFIX}/include/cppformat`
2819   (https://github.com/fmtlib/fmt/issues/178). Thanks @jackyf.
2820
2821 - \[Breaking\] Changed the library name from `format` to `cppformat`
2822   for consistency with the project name and to avoid potential
2823   conflicts (https://github.com/fmtlib/fmt/issues/178).
2824   Thanks @jackyf.
2825
2826 - C++ Format is now available in [Debian](https://www.debian.org/)
2827   GNU/Linux
2828   ([stretch](https://packages.debian.org/source/stretch/cppformat),
2829   [sid](https://packages.debian.org/source/sid/cppformat)) and derived
2830   distributions such as
2831   [Ubuntu](https://launchpad.net/ubuntu/+source/cppformat) 15.10 and
2832   later (https://github.com/fmtlib/fmt/issues/155):
2833
2834       $ sudo apt-get install libcppformat1-dev
2835
2836   Thanks @jackyf.
2837
2838 - [Packages for Fedora and
2839   RHEL](https://admin.fedoraproject.org/pkgdb/package/cppformat/) are
2840   now available. Thanks Dave Johansen.
2841
2842 - C++ Format can now be installed via [Homebrew](http://brew.sh/) on
2843   OS X (https://github.com/fmtlib/fmt/issues/157):
2844
2845       $ brew install cppformat
2846
2847   Thanks @ortho and Anatoliy Bulukin.
2848
2849 ## Documentation
2850
2851 - Migrated from ReadTheDocs to GitHub Pages for better responsiveness
2852   and reliability (https://github.com/fmtlib/fmt/issues/128).
2853   New documentation address is <http://cppformat.github.io/>.
2854 - Added [Building thedocumentation](
2855   https://fmt.dev/2.0.0/usage.html#building-the-documentation)
2856   section to the documentation.
2857 - Documentation build script is now compatible with Python 3 and newer
2858   pip versions. (https://github.com/fmtlib/fmt/pull/189,
2859   https://github.com/fmtlib/fmt/issues/209).
2860   Thanks @JodiTheTigger and @xentec.
2861 - Documentation fixes and improvements
2862   (https://github.com/fmtlib/fmt/issues/36,
2863   https://github.com/fmtlib/fmt/issues/75,
2864   https://github.com/fmtlib/fmt/issues/125,
2865   https://github.com/fmtlib/fmt/pull/160,
2866   https://github.com/fmtlib/fmt/pull/161,
2867   https://github.com/fmtlib/fmt/issues/162,
2868   https://github.com/fmtlib/fmt/issues/165,
2869   https://github.com/fmtlib/fmt/issues/210).
2870   Thanks @syohex.
2871 - Fixed out-of-tree documentation build
2872   (https://github.com/fmtlib/fmt/issues/177). Thanks @jackyf.
2873
2874 ## Fixes
2875
2876 - Fixed `initializer_list` detection
2877   (https://github.com/fmtlib/fmt/issues/136). Thanks @Gachapen.
2878
2879 - \[Breaking\] Fixed formatting of enums with numeric format
2880   specifiers in `fmt::(s)printf`
2881   (https://github.com/fmtlib/fmt/issues/131,
2882   https://github.com/fmtlib/fmt/issues/139):
2883
2884   ```c++
2885   enum { ANSWER = 42 };
2886   fmt::printf("%d", ANSWER);
2887   ```
2888
2889   Thanks @Naios.
2890
2891 - Improved compatibility with old versions of MinGW
2892   (https://github.com/fmtlib/fmt/issues/129,
2893   https://github.com/fmtlib/fmt/pull/130,
2894   https://github.com/fmtlib/fmt/issues/132). Thanks @cstamford.
2895
2896 - Fixed a compile error on MSVC with disabled exceptions
2897   (https://github.com/fmtlib/fmt/issues/144).
2898
2899 - Added a workaround for broken implementation of variadic templates
2900   in MSVC2012 (https://github.com/fmtlib/fmt/issues/148).
2901
2902 - Placed the anonymous namespace within `fmt` namespace for the
2903   header-only configuration (https://github.com/fmtlib/fmt/issues/171).
2904   Thanks @alfps.
2905
2906 - Fixed issues reported by Coverity Scan
2907   (https://github.com/fmtlib/fmt/issues/187,
2908   https://github.com/fmtlib/fmt/issues/192).
2909
2910 - Implemented a workaround for a name lookup bug in MSVC2010
2911   (https://github.com/fmtlib/fmt/issues/188).
2912
2913 - Fixed compiler warnings
2914   (https://github.com/fmtlib/fmt/issues/95,
2915   https://github.com/fmtlib/fmt/issues/96,
2916   https://github.com/fmtlib/fmt/pull/114,
2917   https://github.com/fmtlib/fmt/issues/135,
2918   https://github.com/fmtlib/fmt/issues/142,
2919   https://github.com/fmtlib/fmt/issues/145,
2920   https://github.com/fmtlib/fmt/issues/146,
2921   https://github.com/fmtlib/fmt/issues/158,
2922   https://github.com/fmtlib/fmt/issues/163,
2923   https://github.com/fmtlib/fmt/issues/175,
2924   https://github.com/fmtlib/fmt/issues/190,
2925   https://github.com/fmtlib/fmt/pull/191,
2926   https://github.com/fmtlib/fmt/issues/194,
2927   https://github.com/fmtlib/fmt/pull/196,
2928   https://github.com/fmtlib/fmt/issues/216,
2929   https://github.com/fmtlib/fmt/pull/218,
2930   https://github.com/fmtlib/fmt/pull/220,
2931   https://github.com/fmtlib/fmt/pull/229,
2932   https://github.com/fmtlib/fmt/issues/233,
2933   https://github.com/fmtlib/fmt/issues/234,
2934   https://github.com/fmtlib/fmt/pull/236,
2935   https://github.com/fmtlib/fmt/issues/281,
2936   https://github.com/fmtlib/fmt/issues/289).
2937   Thanks @seanmiddleditch, @dixlorenz, @CarterLi, @Naios, @fmatthew5876,
2938   @LevskiWeng, @rpopescu, @gabime, @cubicool, @jkflying, @LogicalKnight,
2939   @inguin and @Jopie64.
2940
2941 - Fixed portability issues (mostly causing test failures) on ARM,
2942   ppc64, ppc64le, s390x and SunOS 5.11 i386
2943   (https://github.com/fmtlib/fmt/issues/138,
2944   https://github.com/fmtlib/fmt/issues/179,
2945   https://github.com/fmtlib/fmt/issues/180,
2946   https://github.com/fmtlib/fmt/issues/202,
2947   https://github.com/fmtlib/fmt/issues/225, [Red Hat Bugzilla
2948   Bug 1260297](https://bugzilla.redhat.com/show_bug.cgi?id=1260297)).
2949   Thanks @Naios, @jackyf and Dave Johansen.
2950
2951 - Fixed a name conflict with macro `free` defined in `crtdbg.h` when
2952   `_CRTDBG_MAP_ALLOC` is set (https://github.com/fmtlib/fmt/issues/211).
2953
2954 - Fixed shared library build on OS X
2955   (https://github.com/fmtlib/fmt/pull/212). Thanks @dean0x7d.
2956
2957 - Fixed an overload conflict on MSVC when `/Zc:wchar_t-` option is
2958   specified (https://github.com/fmtlib/fmt/pull/214).
2959   Thanks @slavanap.
2960
2961 - Improved compatibility with MSVC 2008
2962   (https://github.com/fmtlib/fmt/pull/236). Thanks @Jopie64.
2963
2964 - Improved compatibility with bcc32
2965   (https://github.com/fmtlib/fmt/issues/227).
2966
2967 - Fixed `static_assert` detection on Clang
2968   (https://github.com/fmtlib/fmt/pull/228). Thanks @dean0x7d.
2969
2970 # 1.1.0 - 2015-03-06
2971
2972 - Added `BasicArrayWriter`, a class template that provides operations
2973   for formatting and writing data into a fixed-size array
2974   (https://github.com/fmtlib/fmt/issues/105 and
2975   https://github.com/fmtlib/fmt/issues/122):
2976
2977   ```c++
2978   char buffer[100];
2979   fmt::ArrayWriter w(buffer);
2980   w.write("The answer is {}", 42);
2981   ```
2982
2983 - Added [0 A.D.](http://play0ad.com/) and [PenUltima Online
2984   (POL)](http://www.polserver.com/) to the list of notable projects
2985   using C++ Format.
2986
2987 - C++ Format now uses MSVC intrinsics for better formatting performance
2988   (https://github.com/fmtlib/fmt/pull/115,
2989   https://github.com/fmtlib/fmt/pull/116,
2990   https://github.com/fmtlib/fmt/pull/118 and
2991   https://github.com/fmtlib/fmt/pull/121). Previously these
2992   optimizations where only used on GCC and Clang.
2993   Thanks @CarterLi and @objectx.
2994
2995 - CMake install target
2996   (https://github.com/fmtlib/fmt/pull/119). Thanks @TrentHouliston.
2997
2998   You can now install C++ Format with `make install` command.
2999
3000 - Improved [Biicode](http://www.biicode.com/) support
3001   (https://github.com/fmtlib/fmt/pull/98 and
3002   https://github.com/fmtlib/fmt/pull/104).
3003   Thanks @MariadeAnton and @franramirez688.
3004
3005 - Improved support for building with [Android NDK](
3006   https://developer.android.com/tools/sdk/ndk/index.html)
3007   (https://github.com/fmtlib/fmt/pull/107). Thanks @newnon.
3008
3009   The [android-ndk-example](https://github.com/fmtlib/android-ndk-example)
3010   repository provides and example of using C++ Format with Android NDK:
3011
3012   ![](https://raw.githubusercontent.com/fmtlib/android-ndk-example/master/screenshot.png)
3013
3014 - Improved documentation of `SystemError` and `WindowsError`
3015   (https://github.com/fmtlib/fmt/issues/54).
3016
3017 - Various code improvements
3018   (https://github.com/fmtlib/fmt/pull/110,
3019   https://github.com/fmtlib/fmt/pull/111
3020   https://github.com/fmtlib/fmt/pull/112). Thanks @CarterLi.
3021
3022 - Improved compile-time errors when formatting wide into narrow
3023   strings (https://github.com/fmtlib/fmt/issues/117).
3024
3025 - Fixed `BasicWriter::write` without formatting arguments when C++11
3026   support is disabled
3027   (https://github.com/fmtlib/fmt/issues/109).
3028
3029 - Fixed header-only build on OS X with GCC 4.9
3030   (https://github.com/fmtlib/fmt/issues/124).
3031
3032 - Fixed packaging issues (https://github.com/fmtlib/fmt/issues/94).
3033
3034 - Added [changelog](https://github.com/fmtlib/fmt/blob/master/ChangeLog.md)
3035   (https://github.com/fmtlib/fmt/issues/103).
3036
3037 # 1.0.0 - 2015-02-05
3038
3039 - Add support for a header-only configuration when `FMT_HEADER_ONLY`
3040   is defined before including `format.h`:
3041
3042   ```c++
3043   #define FMT_HEADER_ONLY
3044   #include "format.h"
3045   ```
3046
3047 - Compute string length in the constructor of `BasicStringRef` instead
3048   of the `size` method
3049   (https://github.com/fmtlib/fmt/issues/79). This eliminates
3050   size computation for string literals on reasonable optimizing
3051   compilers.
3052
3053 - Fix formatting of types with overloaded `operator <<` for
3054   `std::wostream` (https://github.com/fmtlib/fmt/issues/86):
3055
3056   ```c++
3057   fmt::format(L"The date is {0}", Date(2012, 12, 9));
3058   ```
3059
3060 - Fix linkage of tests on Arch Linux
3061   (https://github.com/fmtlib/fmt/issues/89).
3062
3063 - Allow precision specifier for non-float arguments
3064   (https://github.com/fmtlib/fmt/issues/90):
3065
3066   ```c++
3067   fmt::print("{:.3}\n", "Carpet"); // prints "Car"
3068   ```
3069
3070 - Fix build on Android NDK (https://github.com/fmtlib/fmt/issues/93).
3071
3072 - Improvements to documentation build procedure.
3073
3074 - Remove `FMT_SHARED` CMake variable in favor of standard [BUILD_SHARED_LIBS](
3075   http://www.cmake.org/cmake/help/v3.0/variable/BUILD_SHARED_LIBS.html).
3076
3077 - Fix error handling in `fmt::fprintf`.
3078
3079 - Fix a number of warnings.
3080
3081 # 0.12.0 - 2014-10-25
3082
3083 - \[Breaking\] Improved separation between formatting and buffer
3084   management. `Writer` is now a base class that cannot be instantiated
3085   directly. The new `MemoryWriter` class implements the default buffer
3086   management with small allocations done on stack. So `fmt::Writer`
3087   should be replaced with `fmt::MemoryWriter` in variable
3088   declarations.
3089
3090   Old code:
3091
3092   ```c++
3093   fmt::Writer w;
3094   ```
3095
3096   New code:
3097
3098   ```c++
3099   fmt::MemoryWriter w;
3100   ```
3101
3102   If you pass `fmt::Writer` by reference, you can continue to do so:
3103
3104   ```c++
3105   void f(fmt::Writer &w);
3106   ```
3107
3108   This doesn\'t affect the formatting API.
3109
3110 - Support for custom memory allocators
3111   (https://github.com/fmtlib/fmt/issues/69)
3112
3113 - Formatting functions now accept [signed char]{.title-ref} and
3114   [unsigned char]{.title-ref} strings as arguments
3115   (https://github.com/fmtlib/fmt/issues/73):
3116
3117   ```c++
3118   auto s = format("GLSL version: {}", glGetString(GL_VERSION));
3119   ```
3120
3121 - Reduced code bloat. According to the new [benchmark
3122   results](https://github.com/fmtlib/fmt#compile-time-and-code-bloat),
3123   cppformat is close to `printf` and by the order of magnitude better
3124   than Boost Format in terms of compiled code size.
3125
3126 - Improved appearance of the documentation on mobile by using the
3127   [Sphinx Bootstrap
3128   theme](http://ryan-roemer.github.io/sphinx-bootstrap-theme/):
3129
3130   | Old | New |
3131   | --- | --- |
3132   | ![](https://cloud.githubusercontent.com/assets/576385/4792130/cd256436-5de3-11e4-9a62-c077d0c2b003.png) | ![](https://cloud.githubusercontent.com/assets/576385/4792131/cd29896c-5de3-11e4-8f59-cac952942bf0.png) |
3133
3134 # 0.11.0 - 2014-08-21
3135
3136 - Safe printf implementation with a POSIX extension for positional
3137   arguments:
3138
3139   ```c++
3140   fmt::printf("Elapsed time: %.2f seconds", 1.23);
3141   fmt::printf("%1$s, %3$d %2$s", weekday, month, day);
3142   ```
3143
3144 - Arguments of `char` type can now be formatted as integers (Issue
3145   https://github.com/fmtlib/fmt/issues/55):
3146
3147   ```c++
3148   fmt::format("0x{0:02X}", 'a');
3149   ```
3150
3151 - Deprecated parts of the API removed.
3152
3153 - The library is now built and tested on MinGW with Appveyor in
3154   addition to existing test platforms Linux/GCC, OS X/Clang,
3155   Windows/MSVC.
3156
3157 # 0.10.0 - 2014-07-01
3158
3159 **Improved API**
3160
3161 - All formatting methods are now implemented as variadic functions
3162   instead of using `operator<<` for feeding arbitrary arguments into a
3163   temporary formatter object. This works both with C++11 where
3164   variadic templates are used and with older standards where variadic
3165   functions are emulated by providing lightweight wrapper functions
3166   defined with the `FMT_VARIADIC` macro. You can use this macro for
3167   defining your own portable variadic functions:
3168
3169   ```c++
3170   void report_error(const char *format, const fmt::ArgList &args) {
3171     fmt::print("Error: {}");
3172     fmt::print(format, args);
3173   }
3174   FMT_VARIADIC(void, report_error, const char *)
3175
3176   report_error("file not found: {}", path);
3177   ```
3178
3179   Apart from a more natural syntax, this also improves performance as
3180   there is no need to construct temporary formatter objects and
3181   control arguments\' lifetimes. Because the wrapper functions are
3182   very lightweight, this doesn\'t cause code bloat even in pre-C++11
3183   mode.
3184
3185 - Simplified common case of formatting an `std::string`. Now it
3186   requires a single function call:
3187
3188   ```c++
3189   std::string s = format("The answer is {}.", 42);
3190   ```
3191
3192   Previously it required 2 function calls:
3193
3194   ```c++
3195   std::string s = str(Format("The answer is {}.") << 42);
3196   ```
3197
3198   Instead of unsafe `c_str` function, `fmt::Writer` should be used
3199   directly to bypass creation of `std::string`:
3200
3201   ```c++
3202   fmt::Writer w;
3203   w.write("The answer is {}.", 42);
3204   w.c_str();  // returns a C string
3205   ```
3206
3207   This doesn\'t do dynamic memory allocation for small strings and is
3208   less error prone as the lifetime of the string is the same as for
3209   `std::string::c_str` which is well understood (hopefully).
3210
3211 - Improved consistency in naming functions that are a part of the
3212   public API. Now all public functions are lowercase following the
3213   standard library conventions. Previously it was a combination of
3214   lowercase and CapitalizedWords. Issue
3215   https://github.com/fmtlib/fmt/issues/50.
3216
3217 - Old functions are marked as deprecated and will be removed in the
3218   next release.
3219
3220 **Other Changes**
3221
3222 - Experimental support for printf format specifications (work in
3223   progress):
3224
3225   ```c++
3226   fmt::printf("The answer is %d.", 42);
3227   std::string s = fmt::sprintf("Look, a %s!", "string");
3228   ```
3229
3230 - Support for hexadecimal floating point format specifiers `a` and
3231   `A`:
3232
3233   ```c++
3234   print("{:a}", -42.0); // Prints -0x1.5p+5
3235   print("{:A}", -42.0); // Prints -0X1.5P+5
3236   ```
3237
3238 - CMake option `FMT_SHARED` that specifies whether to build format as
3239   a shared library (off by default).
3240
3241 # 0.9.0 - 2014-05-13
3242
3243 - More efficient implementation of variadic formatting functions.
3244
3245 - `Writer::Format` now has a variadic overload:
3246
3247   ```c++
3248   Writer out;
3249   out.Format("Look, I'm {}!", "variadic");
3250   ```
3251
3252 - For efficiency and consistency with other overloads, variadic
3253   overload of the `Format` function now returns `Writer` instead of
3254   `std::string`. Use the `str` function to convert it to
3255   `std::string`:
3256
3257   ```c++
3258   std::string s = str(Format("Look, I'm {}!", "variadic"));
3259   ```
3260
3261 - Replaced formatter actions with output sinks: `NoAction` -\>
3262   `NullSink`, `Write` -\> `FileSink`, `ColorWriter` -\>
3263   `ANSITerminalSink`. This improves naming consistency and shouldn\'t
3264   affect client code unless these classes are used directly which
3265   should be rarely needed.
3266
3267 - Added `ThrowSystemError` function that formats a message and throws
3268   `SystemError` containing the formatted message and system-specific
3269   error description. For example, the following code
3270
3271   ```c++
3272   FILE *f = fopen(filename, "r");
3273   if (!f)
3274     ThrowSystemError(errno, "Failed to open file '{}'") << filename;
3275   ```
3276
3277   will throw `SystemError` exception with description \"Failed to open
3278   file \'\<filename\>\': No such file or directory\" if file doesn\'t
3279   exist.
3280
3281 - Support for AppVeyor continuous integration platform.
3282
3283 - `Format` now throws `SystemError` in case of I/O errors.
3284
3285 - Improve test infrastructure. Print functions are now tested by
3286   redirecting the output to a pipe.
3287
3288 # 0.8.0 - 2014-04-14
3289
3290 - Initial release