diff options
Diffstat (limited to 'contrib/groff/src/preproc/soelim/soelim.man')
-rw-r--r-- | contrib/groff/src/preproc/soelim/soelim.man | 216 |
1 files changed, 0 insertions, 216 deletions
diff --git a/contrib/groff/src/preproc/soelim/soelim.man b/contrib/groff/src/preproc/soelim/soelim.man deleted file mode 100644 index fb17e3644fca..000000000000 --- a/contrib/groff/src/preproc/soelim/soelim.man +++ /dev/null @@ -1,216 +0,0 @@ -'\" p -.ig -Copyright (C) 1989-2000, 2001, 2003, 2004 Free Software Foundation, Inc. - -Permission is granted to make and distribute verbatim copies of -this manual provided the copyright notice and this permission notice -are preserved on all copies. - -Permission is granted to copy and distribute modified versions of this -manual under the conditions for verbatim copying, provided that the -entire resulting derived work is distributed under the terms of a -permission notice identical to this one. - -Permission is granted to copy and distribute translations of this -manual into another language, under the above conditions for modified -versions, except that this permission notice may be included in -translations approved by the Free Software Foundation instead of in -the original English. -.. -. -.mso pic.tmac -. -.TH @G@SOELIM @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@" -. -.SH NAME -@g@soelim \- interpret .so requests in groff input -. -.SH SYNOPSIS -.B @g@soelim -[ -.B \-Crtv -] -[ -.BI \-I dir -] -[ -.IR files \|.\|.\|.\| -] -. -.PP -It is possible to have whitespace between the -.B \-I -command line option and its parameter. -. -.SH DESCRIPTION -.B @g@soelim -reads -.I files -and replaces lines of the form -.IP -.BI .so\ file -.LP -by the contents of -.IR file . -It is useful if files included with -.B so -need to be preprocessed. -Normally, -.B @g@soelim -should be invoked with the -.B \-s -option of -.BR groff . -. -.PP -Note that there must be no whitespace between the leading dot and -the two characters `s' and `o'. Otherwise, only -.B groff -interprets the -.B .so -request (and -.B soelim -ignores it). -. -.SH OPTIONS -.TP -.B \-C -Recognize -.B .so -even when followed by a character other than space or newline. -. -.TP -.BI \-I dir -This option may be used to specify a directory to search for -files (both those on the command line and those named in -.B \&.so -requests). -The current directory is always searched first. -This option may be specified more than once, -the directories will be searched in the order specified. -No directory search is performed for files specified using an absolute path. -. -.TP -.B \-r -Do not add .lf requests (for general use, with non-groff files). -. -.TP -.B \-t -Don't emit .lf requests but TeX comment lines (starting with `%') giving -the current file and line number. -. -.TP -.B \-v -Print the version number. -. -.SH USAGE -The normal processing sequence of groff is this: -. -.PP -.ie t \{\ -.PS -box invisible width 0.5 height 0.4 "input" "file"; -move to last box .bottom; -down; -arrow 0.3; -box invisible width 0.8 height 0.2 "preprocessor"; -move to last box .right -right; -arrow 0.3; -A: box invisible width 0.35 height 0.2 "troff"; -move to last box .top; -up; -move 0.3; -box invisible width 0.6 height 0.4 "sourced" "file"; -line <- up 0.3 from A.top; -move to A.right; -right; -arrow 0.3; -box invisible width 0.85 height 0.2 "postprocessor"; -move to last box .bottom; -down; -arrow 0.3; -box invisible width 0.5 height 0.4 "output" "file" -.PE -.\} -.el \{\ -.nf - input sourced - file file - | | - v v - preprocessor -> troff -> postprocessor - | - v - output - file -.fi -.\} -.PP -. -That is, files sourced with -.B .so -are normally read -.I only -by -.B troff -(the actual formatter). -.B soelim -is -.I not -required for -.B troff -to source files. -. -.PP -If a file to be sourced should also be preprocessed, it must -already be read -.I before -the input file passes through the preprocessor. -This is handled by -.BR soelim : -. -.PP -.ie t \{\ -.PS -box invisible width 0.5 height 0.4 "input" "file"; -move to last box .bottom; -down; -arrow 0.3; -A: box invisible width 0.5 height 0.2 "soelim"; -line <- 0.3; -box invisible width 0.5 height 0.4 "sourced" "file"; -move to A.right; -right; -arrow 0.3; -box invisible width 0.8 height 0.2 "preprocessor"; -arrow 0.3; -box invisible width 0.35 height 0.2 "troff"; -arrow 0.3 -box invisible width 0.85 height 0.2 "postprocessor"; -move to last box .bottom; -down; -arrow 0.3; -box invisible width 0.5 height 0.4 "output" "file" -.PE -.\} -.el \{\ -.nf - input - file - | - v - soelim -> preprocessor -> troff -> postprocessor - ^ | - | v - sourced output - file file -.fi -.\} -. -.SH "SEE ALSO" -.BR groff (@MAN1EXT@) -. -.\" Local Variables: -.\" mode: nroff -.\" End: |