From 1d239f2504dffc05c39efd38a10a27dba9e9c85e Mon Sep 17 00:00:00 2001
From: Ralph Amissah <ralph@amissah.com>
Date: Sun, 26 Jun 2011 21:26:07 -0400
Subject: v3: documentation, on additional breaks in document, (remove some old
 info)

* linebreak \\ (previously undocumented <br> kept but depreciated)
  [it is intended that this should close #617298 (post mail)]
* page break (breaks column if column, else breaks page)
* page new (new page, breaks page)
* sisurc.yml set output directory structure by language
* removed section on hyperestraier, too specialised for general manpage
  (also section not checked recently)
---
 .../markup-samples/sisu_manual/sisu_markup.sst     | 39 ++++++++++++++++++++++
 1 file changed, 39 insertions(+)

(limited to 'data/doc/sisu/markup-samples/sisu_manual/sisu_markup.sst')

diff --git a/data/doc/sisu/markup-samples/sisu_manual/sisu_markup.sst b/data/doc/sisu/markup-samples/sisu_manual/sisu_markup.sst
index 65dc4e91..a246d160 100644
--- a/data/doc/sisu/markup-samples/sisu_manual/sisu_markup.sst
+++ b/data/doc/sisu/markup-samples/sisu_manual/sisu_markup.sst
@@ -1108,6 +1108,45 @@ code{#
 
 }code
 
+2~ Additional breaks - linebreaks within objects, column and page-breaks
+
+3~ line-breaks
+
+To break a line within a "paragraph object", two backslashes \\\\ \\ with a space before and a space or newline after them \\ may be used.
+
+code{
+
+To break a line within a "paragraph object",
+two backslashes \\ with a space before
+and a space or newline after them \\
+may be used.
+
+}code
+
+The html break br enclosed in angle brackets (though undocumented) is available in versions prior to 3.0.13 and 2.9.7 (it remains available for the time being, but is depreciated).
+
+3~ page breaks
+
+Page breaks are only relevant and honored in some output formats. A page break or a new page may be inserted manually using the following markup on a line on its own:
+
+code{
+
+<:pb>
+
+}code
+
+or
+
+code{
+
+<:pn>
+
+}code
+
+page new <:pn> breaks the page, starts a new page.
+
+page break <:pb> breaks a column, starts a new column, if using columns, else breaks the page, starts a new page.
+
 2~ Book index
 
 To make an index append to paragraph the book index term relates to it, using an equal sign and curly braces.
-- 
cgit v1.2.3