BSD 4_4_Lite2 development
[unix-history] / usr / share / man / cat1 / fsplit.0
FSPLIT(1) BSD Reference Manual FSPLIT(1)
N\bNA\bAM\bME\bE
f\bfs\bsp\bpl\bli\bit\bt - split a multi-routine Fortran file into individual files
S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
f\bfs\bsp\bpl\bli\bit\bt [-\b-e\be _\be_\bf_\bi_\bl_\be] ... [_\bf_\bi_\bl_\be]
D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
F\bFs\bsp\bpl\bli\bit\bt takes as input either a file or standard input containing Fortran
source code. It attempts to split the input into separate routine files
of the form _\bn_\ba_\bm_\be_\b._\bf, where _\bn_\ba_\bm_\be is the name of the program unit (e.g.
function, subroutine, block data or program). The name for unnamed block
data subprograms has the form _\bb_\bl_\bk_\bd_\bt_\ba_\bN_\bN_\bN_\b._\bf where NNN is three digits and a
file of this name does not already exist. For unnamed main programs the
name has the form _\bm_\ba_\bi_\bn_\bN_\bN_\bN_\b._\bf. If there is an error in classifying a pro-
gram unit, or if _\bn_\ba_\bm_\be_\b._\bf already exists, the program unit will be put in a
file of the form _\bz_\bz_\bz_\bN_\bN_\bN_\b._\bf where _\bz_\bz_\bz_\bN_\bN_\bN_\b._\bf does not already exist.
-\b-e\be _\be_\bf_\bi_\bl_\be Normally each subprogram unit is split into a separate file.
When the -\b-e\be option is used, only the specified subprogram
units are split into separate files. E.g.:
fsplit -e readit -e doit prog.f
will split readit and doit into separate files.
D\bDI\bIA\bAG\bGN\bNO\bOS\bST\bTI\bIC\bCS\bS
If names specified via the -\b-e\be option are not found, a diagnostic is writ-
ten to standard error.
H\bHI\bIS\bST\bTO\bOR\bRY\bY
The f\bfs\bsp\bpl\bli\bit\bt command appeared in 4.2BSD.
A\bAU\bUT\bTH\bHO\bOR\bRS\bS
Asa Romberger and Jerry Berkman
B\bBU\bUG\bGS\bS
F\bFs\bsp\bpl\bli\bit\bt assumes the subprogram name is on the first noncomment line of the
subprogram unit. Nonstandard source formats may confuse f\bfs\bsp\bpl\bli\bit\bt.
It is hard to use -\b-e\be for unnamed main programs and block data subprograms
since you must predict the created file name.
4.2 Berkeley Distribution June 6, 1993 1