From 2c4f1e959082d20ea03f93274571316ffde5d0cc Mon Sep 17 00:00:00 2001
From: Ludovic Courtès
Date: Thu, 24 May 2012 00:06:21 +0200
Subject: doc: lout: Render examples in a colored box.

* doc/modules/skribilo/documentation/api.scm (le)[inline-definitions-proc]:
  Add @SkribiloExample.
* doc/modules/skribilo/documentation/manual.scm (example)[lout]: Use
  @SkribiloExample.
  (le): Set the `includes' custom to include `diag'.

* src/guile/skribilo/engine/lout.scm (frame): Mark the trick about
  @Floater.
---
 src/guile/skribilo/engine/lout.scm | 3 +++
 1 file changed, 3 insertions(+)

(limited to 'src')

diff --git a/src/guile/skribilo/engine/lout.scm b/src/guile/skribilo/engine/lout.scm
index b194e25..95cbc4b 100644
--- a/src/guile/skribilo/engine/lout.scm
+++ b/src/guile/skribilo/engine/lout.scm
@@ -1712,6 +1712,9 @@
    ;; @Box won't span over several pages so this may cause
    ;; problems if large frames are used.  The workaround here consists
    ;; in using an @Tbl with one single cell.
+   ;; FIXME: The workaround seems broken since the manual states that "[p]age
+   ;; breaks cannot occur within rows" (Section 6.11, "Multi-page tables").
+   ;; Use @Floater instead, as for @SkribiloExample.
    :options '(:width :border :margin :bg)
    :before (lambda (n e)
 	     (let ((width (markup-option n :width))
-- 
cgit v1.2.3