refactor: simplify handlebars generators

include/mrdocs/Generator.hpp

@@ -82,10 +82,19 @@ class MRDOCS_VISIBLE
         depending on the generator and how it is
         configured.
 
+        The default implentation assumes the output
+        is single-page and emits the file `reference.ext`
+        using @ref buildOne to generate the content.
+
+        The typical implementation will have behavior
+        similar to the default implementation if the
+        output is single-page, or will iterate over
+        the symbols in the corpus to generate multiple
+        files if the output is multi-page.
+
         @return The error, if any occurred.
 
-        @param outputPath An existing directory or
-        a filename.
+        @param outputPath A directory or filename.
 
         @param corpus The symbols to emit. The
         generator may modify the contents of

include/mrdocs/Support/Error.hpp

@@ -2747,6 +2747,13 @@ void
 setMinimumLevel(
     Level level) noexcept;
 
+/** If true, source location information will be
+    printed with warnings, errors, and fatal messages.
+*/
+MRDOCS_DECL
+void
+setSourceLocationWarnings(bool b) noexcept;
+
 /** Report a message to the console.
 
     @param text The message to print. A

share/mrdocs/addons/generator/html/layouts/single-symbol.html.hbs

@@ -1,5 +1,2 @@
 {{! The section with a symbol in single page output or the symbol page in multi page output }}
-{{#if relfileprefix}}:relfileprefix: {{relfileprefix}}{{/if}}
-[#{{#if (is_multipage)}}{{symbol.id}}{{else}}{{symbol.ref}}{{/if}}]
-
 {{> (concat 'symbols' '/' (lookup symbol 'kind')) symbol=symbol}}

share/mrdocs/addons/generator/html/partials/symbols/alias.html.hbs

@@ -1,5 +1,5 @@
 {{!-- alias --}}
-<div id="{{symbol.id}}">
+<div {{#if sectionref}}id="{{sectionref}}"{{/if}}>
     <div>
         <h2>{{>types/nested-name-specifier symbol=symbol.parent}}{{symbol.name}}</h2>
         {{{symbol.doc.brief}}}

share/mrdocs/addons/generator/html/partials/symbols/concept.html.hbs

@@ -1,5 +1,5 @@
 {{!-- concept --}}
-<div id="{{symbol.id}}">
+<div {{#if sectionref}}id="{{sectionref}}"{{/if}}>
     <div>
         <h2>{{>types/nested-name-specifier symbol=symbol.parent includeNamespace=true}}{{symbol.name}}</h2>
         {{symbol.doc.brief}}

share/mrdocs/addons/generator/html/partials/symbols/enum.html.hbs

@@ -1,5 +1,5 @@
 {{!-- enum --}}
-<div id="{{symbol.id}}">
+<div {{#if sectionref}}id="{{sectionref}}"{{/if}}>
     <div>
         <h2>{{#if symbol.name}}Enum {{>types/nested-name-specifier symbol=symbol.parent}}{{symbol.name}}{{else}}Unnamed enum{{/if}}</h2>
         {{{symbol.doc.brief}}}

share/mrdocs/addons/generator/html/partials/symbols/enumerator.html.hbs

@@ -1,5 +1,5 @@
 {{!-- enumerator --}}
-<div id="{{symbol.id}}">
+<div {{#if sectionref}}id="{{sectionref}}"{{/if}}>
     <div>
         <h2>Enumerator {{>types/nested-name-specifier symbol=symbol.parent}}{{symbol.name}}</h2>
         {{{symbol.doc.brief}}}

share/mrdocs/addons/generator/html/partials/symbols/field.html.hbs

@@ -1,5 +1,5 @@
 {{!-- field --}}
-<div id="{{symbol.id}}">
+<div {{#if sectionref}}id="{{sectionref}}"{{/if}}>
     <div>
         <h2>{{>types/nested-name-specifier symbol=symbol.parent}}{{symbol.name}}</h2>
         {{{symbol.doc.brief}}}

share/mrdocs/addons/generator/html/partials/symbols/friend.html.hbs

@@ -1,5 +1,5 @@
 {{!-- friend --}}
-<div id="{{symbol.id}}">
+<div {{#if sectionref}}id="{{sectionref}}"{{/if}}>
     <div>
         <h2>Friend {{#if symbol.symbol}}{{symbol.symbol.name}}{{else}}{{symbol.type.name}}{{/if}}</h2>
         {{{symbol.doc.brief}}}

share/mrdocs/addons/generator/html/partials/symbols/function.html.hbs

@@ -1,5 +1,5 @@
 {{!-- function --}}
-<div id="{{symbol.id}}">
+<div {{#if sectionref}}id="{{sectionref}}"{{/if}}>
     <div>
         <h2>Function {{>types/nested-name-specifier symbol=symbol.parent}}{{symbol.name}}</h2>
         {{{symbol.doc.brief}}}

share/mrdocs/addons/generator/html/partials/symbols/guide.html.hbs

@@ -1,5 +1,5 @@
 {{!-- guides --}}
-<div id="{{symbol.id}}">
+<div {{#if sectionref}}id="{{sectionref}}"{{/if}}>
     <div>
         <h2>Deduction guide {{>types/nested-name-specifier symbol=symbol.parent}}{{symbol.name}}</h2>
         {{{symbol.doc.brief}}}

share/mrdocs/addons/generator/html/partials/symbols/namespace.html.hbs

@@ -1,5 +1,5 @@
 {{!-- namespace --}}
-<div id="{{symbol.id}}">
+<div {{#if sectionref}}id="{{sectionref}}"{{/if}}>
     <div>
         <h2>{{#if symbol.name}}Namespace {{>types/nested-name-specifier symbol=symbol.parent}}{{symbol.name}}{{else if symbol.parent}}Unnamed namespace{{else}}Global namespace{{/if}}</h2>
     </div>

share/mrdocs/addons/generator/html/partials/symbols/record.html.hbs

@@ -1,5 +1,5 @@
 {{!-- record --}}
-<div id="{{symbol.id}}">
+<div {{#if sectionref}}id="{{sectionref}}"{{/if}}>
     <div>
         <h2>{{#if symbol.name}}Class {{>types/nested-name-specifier symbol=symbol.parent}}{{symbol.name}}{{else}}Unnamed class{{/if}}</h2>
         {{{symbol.doc.brief}}}

share/mrdocs/addons/generator/html/partials/symbols/typedef.html.hbs

@@ -1,5 +1,5 @@
 {{!-- typedef --}}
-<div id="{{symbol.id}}">
+<div {{#if sectionref}}id="{{sectionref}}"{{/if}}>
     <div>
         <h2>{{>types/nested-name-specifier symbol=symbol.parent}}{{symbol.name}}</h2>
         {{{symbol.doc.brief}}}

share/mrdocs/addons/generator/html/partials/symbols/using.html.hbs

@@ -1,5 +1,5 @@
 {{!-- symbols/using.html.hbs --}}
-<div id="{{symbol.id}}">
+<div {{#if sectionref}}id="{{sectionref}}"{{/if}}>
     <div>
         <h2>Using {{#if (eq symbol.class "namespace")}}Directive: {{symbol.qualifier.name}}{{else}}Declaration: {{symbol.name}}{{/if}}</h2>
         {{{symbol.doc.brief}}}

share/mrdocs/addons/generator/html/partials/symbols/variable.html.hbs

@@ -1,5 +1,5 @@
 {{!-- variable --}}
-<div id="{{symbol.id}}">
+<div {{#if sectionref}}id="{{sectionref}}"{{/if}}>
     <div>
         <h2>{{>types/nested-name-specifier symbol=symbol.parent}}{{symbol.name}}</h2>
         {{{symbol.doc.brief}}}

src/lib/Dom/LazyObject.hpp

@@ -266,6 +266,10 @@ namespace detail
             }
         }
     };
+
+    // Deduction guide
+    template <class MapFn, class DeferFn = void*>
+    LazyObjectIO(MapFn, DeferFn = {}) -> LazyObjectIO<MapFn, DeferFn>;
 }
 
 template <class T, class Context>
@@ -274,7 +278,7 @@ std::size_t
 LazyObjectImpl<T, Context>::
 size() const
 {
-    std::size_t result;
+    std::size_t result = 0;
     detail::LazyObjectIO io(
         [&result, this](std::string_view name, auto const& /* value or deferred */)
         {