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/11-resource-system.md | 18 ++++++++----------
 1 file changed, 8 insertions(+), 10 deletions(-)

(limited to 'docs/pages/11-resource-system.md')

diff --git a/docs/pages/11-resource-system.md b/docs/pages/11-resource-system.md
index 9491212..0e2bd19 100644
--- a/docs/pages/11-resource-system.md
+++ b/docs/pages/11-resource-system.md
@@ -27,6 +27,7 @@ Since `ResCurrentDir` implements both `Default` and `Clone`, the framework autom
 In a Chain or Renderer, simply declare the resource in the parameter list:
 
 ```rust
+@@@use mingling::macros::buffer;
 @@@#[derive(Default, Clone)]
 @@@struct ResCurrentDir(String);
 @@@dispatcher!("pwd", CMDPrintWorkingDir => EntryPrintWorkingDir);
@@ -37,11 +38,9 @@ fn handle_pwd(_args: EntryPrintWorkingDir, cwd: &ResCurrentDir) -> Next {
     ResultPath::new(cwd.0.clone()).to_render()
 }
  
-#[renderer]
-fn render_path(result: ResultPath) -> RenderResult {
-    let mut r = RenderResult::new();
-    writeln!(r, "{}", *result).ok();
-    r
+#[renderer(buffer)]
+fn render_path(result: ResultPath) {
+    r_println!("{}", *result);
 }
 ```
  
@@ -50,6 +49,7 @@ fn render_path(result: ResultPath) -> RenderResult {
 Use `&mut T` to inject a mutable resource:
 
 ```rust
+@@@use mingling::macros::buffer;
 @@@#[derive(Default, Clone)]
 @@@struct ResVisitCount(u32);
 @@@dispatcher!("visit", CMDVisit => EntryVisit);
@@ -60,11 +60,9 @@ fn handle_visit(_args: EntryVisit, counter: &mut ResVisitCount) -> Next {
     ResultDone::default().into()
 }
  
-#[renderer]
-fn render_done(_done: ResultDone, counter: &ResVisitCount) -> RenderResult {
-    let mut r = RenderResult::new();
-    writeln!(r, "visit count is : {}", counter.0).ok();
-    r
+#[renderer(buffer)]
+fn render_done(_done: ResultDone, counter: &ResVisitCount) {
+    r_println!("visit count is : {}", counter.0);
 }
 ```
  
-- 
cgit