From c385dcf15930d2754b68c2794986ad30fc65c141 Mon Sep 17 00:00:00 2001
From: 魏曹先生 <1992414357@qq.com>
Date: Mon, 20 Jul 2026 09:50:28 +0800
Subject: docs: migrate renderer examples to buffer macro and update docs

Update all documentation and code examples to use the new
`#[renderer(buffer)]`
pattern with `r_println!` instead of manually constructing
`RenderResult`
with `writeln!`.
---
 docs/pages/9-error-handling.md | 34 ++++++++++++++--------------------
 1 file changed, 14 insertions(+), 20 deletions(-)

(limited to 'docs/pages/9-error-handling.md')

diff --git a/docs/pages/9-error-handling.md b/docs/pages/9-error-handling.md
index 3e004f2..f6e05e3 100644
--- a/docs/pages/9-error-handling.md
+++ b/docs/pages/9-error-handling.md
@@ -38,23 +38,20 @@ fn handle_greet(args: EntryGreet) -> Next {
 Then write separate Renderers:
 
 ```rust
+@@@use mingling::macros::buffer;
 @@@dispatcher!("greet", CMDGreet => EntryGreet);
 @@@pack!(ResultGreeting = String);
 @@@pack!(ErrorNameEmpty = String);
 @@@#[chain] fn handle_greet(args: EntryGreet) -> Next { ResultGreeting::new(args.inner.first().cloned().unwrap_or_default()).to_render() }
  
-#[renderer]
-fn render_greeting(result: ResultGreeting) -> RenderResult {
-    let mut r = RenderResult::new();
-    writeln!(r, "Hello, {}!", *result).ok();
-    r
+#[renderer(buffer)]
+fn render_greet(result: ResultGreeting) {
+    r_println!("Hello, {}!", *result);
 }
  
-#[renderer]
-fn render_error_name_empty(err: ErrorNameEmpty) -> RenderResult {
-    let mut r = RenderResult::new();
-    writeln!(r, "Error: {}", *err).ok();
-    r
+#[renderer(buffer)]
+fn render_error_name_empty(err: ErrorNameEmpty) {
+    r_println!("Error: {}", *err);
 }
 ```
  
@@ -63,6 +60,7 @@ Each Renderer does its own job; what the user sees depends on what the Chain ret
 ## Complete Example
 
 ```rust
+@@@use mingling::macros::buffer;
 dispatcher!("greet", CMDGreet => EntryGreet);
  
 pack!(ResultGreeting = String);
@@ -78,18 +76,14 @@ fn handle_greet(args: EntryGreet) -> Next {
     }
 }
  
-#[renderer]
-fn render_greeting(result: ResultGreeting) -> RenderResult {
-    let mut r = RenderResult::new();
-    writeln!(r, "Hello, {}!", *result).ok();
-    r
+#[renderer(buffer)]
+fn render_greet(result: ResultGreeting) {
+    r_println!("Hello, {}!", *result);
 }
  
-#[renderer]
-fn render_error_name_empty(err: ErrorNameEmpty) -> RenderResult {
-    let mut r = RenderResult::new();
-    writeln!(r, "Error: {}", *err).ok();
-    r
+#[renderer(buffer)]
+fn render_error_name_empty(err: ErrorNameEmpty) {
+    r_println!("Error: {}", *err);
 }
  
 fn main() {
-- 
cgit