NAME

       SDoP - a Simple DocBook Processor

SYNOPSIS

       sdop [options] [source file]

DESCRIPTION

       sdop  reads  DocBook  XML input, processes it into page images, and writes the result as PostScript. This
       can be turned into PDF using an application such as ps2pdf. SDoP is "simple"  because  (a)  it  does  not
       check  that  the input conforms to the DTD, and (b) it supports only a simple subset of DocBook features.
       If no source file is given, the standard input is read.

OPTIONS

       -d        Produce debugging output. Adding +all generates voluminous output; some other words can be used
                 to generate subsets of this.

       -help or --help
                 List the available options.

       -o <output file>
                 Specify an output file. To specify the standard output, use "-". The default is to replace  the
                 input  file's  extension  with  ".ps",  or  to write to the standard output if the input is the
                 standard input.

       -p <pagelist>
                 Output only the given pages, counting from the start of the body  of  the  document,  that  is,
                 after  the  front  matter and preface(s), if any. Page numbers in the list are comma-separated,
                 and ranges can be given using a hyphen.

       -pf <pagelist>
                 Output only the given pages from the front matter, counting from the very  first  page  of  the
                 document. Page numbers in the list are comma-separated, and ranges can be given using a hyphen.

       -q        Suppress  warnings  for  unsupported  DocBook  features (which are ignored). This overrides any
                 setting in the input file.

       -qc       Suppress warnings for unsupported characters. This overrides any setting in the input file.

       -S <colon-separated directory list>
                 The given directories are searched in order for SDoP's shared data files, before searching  the
                 installed  directory  (usually  /usr/local/share/sdop).   This  overrides  any  setting  in  an
                 SDOP_SHARE environment variable.

       -w        Do not suppress warnings for unsupported DocBook features (which are ignored).  This  overrides
                 any setting in the input file.

       -wc       Do  not  suppress  warnings for unsupported characters. This overrides any setting in the input
                 file.

       -v or --version
                 Show SDoP's version and list any optional facilities that this implementation supports.

       A page list for -p (but not for -pf) may include ``odd'' or ``even'', to further restrict which pages are
       output. If you want only odd or even pages from the frontmatter, you can use, for example, -p odd with an
       appropriate -pf setting.

ENVIRONMENT

       The environment variable SDOP_SHARE may be set to  a  colon-separated  list  of  directories.  These  are
       searched  in  order  for  SDoP's  shared  data  files,  before searching the installed directory (usually
       /usr/local/share/sdop). The -S option can be used to override SDOP_SHARE.

FURTHER INFORMATION

       The SDoP manual gives a full description of the program and the features that it provides.

DIAGNOSTICS AND RETURN CODES

       Error messages are written to the standard error stream. The return code is 0 for success, and 1 if there
       have been any diagnostics more serious than a warning.

AUTHOR

       Philip Hazel
       Cambridge, England.

REVISION

       Last updated: 23 November 2013
       Copyright (c) 2013 Philip Hazel

                                                                                                         SDOP(1)