# $Id$
#
# >>Copyright::
# Copyright (c) 1992-1996, Ian Clatworthy (ianc@mincom.com).
# You may distribute under the terms specified in the LICENSE file.
#
# >>History::
# -----------------------------------------------------------------------
# Date Who Change
# 29-Feb-96 ianc SDF 2.000
# -----------------------------------------------------------------------
#
H1: Book Mode
By default, {{CMD:sdf}} processes each argument as a single document.
i.e. a single stream of paragraphs is passed to the {{format driver}}
for conversion. This mode is good enough for most documents.
In {{book mode}}, {{CMD:sdf}} processes each argument as a "book".
i.e. a set of {{MAC:include}} macros specifying the chapters.
In this mode, a shell script is generated which treats each chapter
as a "pseudo-document". This mode is required when:
^ you wish to generate a [[FrameMaker]] book
+ you want to generate a list of figures, list of tables or index
+ each chapter has a fancy cover page.
Book mode can be activated via {{CMD:sdf}}'s -b option.
Note: The {{VAR:OPT_BOOK}} variable can be used to check if book mode is
active. However, it cannot be used to enable or disable the mode.
!end_topic