doc: Documented spacing.

* NEWS: Mention `breakable-space'.

* doc/user/markup.skb: Include "spacing.skb".

git-archimport-id: lcourtes@laas.fr--2006-libre/skribilo--devo--1.2--patch-34

3 files changed, 39 insertions, 1 deletions

diff --git a/NEWS b/NEWS
index 5ac9227..908d920 100644
--- a/NEWS
+++ b/NEWS
@@ -4,7 +4,8 @@ New in Skribilo 1.2 (compared to Skribe 1.2d)
 
   * New package `eq' for equation formatting.
 
-  * New markups: `~', `numref', `!lout', `lout-illustration'.
+  * New markups: `~', `breakable-space', `numref',
+    `!lout', `lout-illustration'.
 
   * Extended markups:
 
diff --git a/doc/user/markup.skb b/doc/user/markup.skb
index 3607053..b904e65 100644
--- a/doc/user/markup.skb
+++ b/doc/user/markup.skb
@@ -77,6 +77,7 @@ calls are legal ,(tt "section") calls:])
 ;*    Markups                                                          */
 ;*---------------------------------------------------------------------*/
 (include "document.skb")
+(include "spacing.skb")
 (include "sectioning.skb")
 (include "toc.skb")
 (include "ornament.skb")
diff --git a/doc/user/spacing.skb b/doc/user/spacing.skb
new file mode 100644
index 0000000..d47d2fc
--- /dev/null
+++ b/doc/user/spacing.skb
@@ -0,0 +1,36 @@
+;;; spacing.skb  --  Spacing.
+;;;
+;;; Copyright 2007  Ludovic Courtès <ludovic.courtes@laas.fr>
+;;;
+;;;
+;;; This program is free software; you can redistribute it and/or modify
+;;; it under the terms of the GNU General Public License as published by
+;;; the Free Software Foundation; either version 2 of the License, or
+;;; (at your option) any later version.
+;;;
+;;; This program is distributed in the hope that it will be useful,
+;;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+;;; GNU General Public License for more details.
+;;;
+;;; You should have received a copy of the GNU General Public License
+;;; along with this program; if not, write to the Free Software
+;;; Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
+;;; USA.
+
+(section :title [Spacing] :file #t
+   
+   (p [By default, the spacing rules are the same as those of TeX/LaTeX,
+for instance: subsequent white spaces in the input text are coalesced
+into a single space in the output.  Language-dependent spacing rules
+(e.g., for punctuation) are to be handled by the engine.  This frees you
+from having to remember all the spacing details.])
+   
+   (p [Additionally, the following markups allow you to produce explicit
+unbreakable and breakable space, respectively:])
+
+   (doc-markup '~ '() :common-args '((:class "The node class.")))
+
+   (doc-markup 'breakable-space '()))
+	
+;;; arch-tag: a6a542b9-6bf0-406d-8cf1-3cfffbdfa40d