Update docs

include/fmt/core.h

@@ -1069,7 +1069,8 @@ class basic_format_args {
   }
 };
 
-// This is a separate type rather than a typedef to make symbols readable.
+/** An alias to ``basic_format_args<context>``. */
+// It is a separate type rather than a typedef to make symbols readable.
 struct format_args: basic_format_args<context> {
   template <typename ...Args>
   format_args(Args && ... arg)
@@ -1179,7 +1180,7 @@ std::wstring vformat(wstring_view format_str, wformat_args args);
 
   **Example**::
 
-    #include "fmt/core.h"
+    #include <fmt/core.h>
     std::string message = fmt::format("The answer is {}", 42);
   \endrst
 */

include/fmt/format.h

@@ -3315,7 +3315,7 @@ auto join(const Range &range, wstring_view sep)
 
   **Example**::
 
-    #include "fmt/format.h"
+    #include <fmt/format.h>
 
     std::string answer = fmt::to_string(42);
   \endrst
@@ -3528,6 +3528,16 @@ operator"" _a(const wchar_t *s, std::size_t) { return {s}; }
   }()
 
 #ifndef FMT_NO_FMT_STRING_ALIAS
+/**
+  \rst
+  Constructs a compile-time format string.
+
+  **Example**::
+
+    #include <fmt/format.h>
+    std::string s = fmt::format(fmt("{:d}"), "foo"); // fails to compile
+  \endrst
+ */
 # define fmt(s) FMT_STRING(s)
 #endif