summary refs log tree commit diff
path: root/src
diff options
context:
space:
mode:
authorLudovic Courtès2012-05-24 00:06:21 +0200
committerLudovic Courtès2012-05-24 00:06:21 +0200
commit2c4f1e959082d20ea03f93274571316ffde5d0cc (patch)
tree007246afc3ebc1c5ed423faec3fb6e395ead52ae /src
parent1b2f2d42bd9151453f2b10a34aff3fbfc28d5223 (diff)
downloadskribilo-2c4f1e959082d20ea03f93274571316ffde5d0cc.tar.gz
skribilo-2c4f1e959082d20ea03f93274571316ffde5d0cc.tar.lz
skribilo-2c4f1e959082d20ea03f93274571316ffde5d0cc.zip
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.
Diffstat (limited to 'src')
-rw-r--r--src/guile/skribilo/engine/lout.scm3
1 files changed, 3 insertions, 0 deletions
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))