4.3BSD-Reno/share/man/cat1/fsplit.0

FSPLIT(1)		    UNIX Reference Manual		     FSPLIT(1)

NNAAMMEE
     ffsspplliitt - split a multi-routine Fortran file into individual files

SSYYNNOOPPSSIISS
     ffsspplliitt [--ee _e_f_i_l_e] ...  [_f_i_l_e]

DDEESSCCRRIIPPTTIIOONN
     FFsspplliitt 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 _n_a_m_e._f, where _n_a_m_e 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 _b_l_k_d_t_a_N_N_N._f where NNN is three digits and a
     file of this name does not already exist.	For unnamed main programs the
     name has the form _m_a_i_n_N_N_N._f.  If there is an error in classifying a pro-
     gram unit, or if _n_a_m_e._f already exists, the program unit will be put in a
     file of the form _z_z_z_N_N_N._f where _z_z_z_N_N_N._f does not already exist.

     --ee _e_f_i_l_e	 Normally each subprogram unit is split into a separate file.
		 When the --ee option is used, only the specified subprogram un-
		 its are split into separate files.  E.g.:

		       fsplit -e readit -e doit prog.f

		 will split readit and doit into separate files.

DDIIAAGGNNOOSSTTIICCSS
     If names specified via the --ee option are not found, a diagnostic is writ-
     ten to standard error.

HHIISSTTOORRYY
     FFsspplliitt appeared in 4.2 BSD.

AAUUTTHHOORRSS
     Asa Romberger and Jerry Berkman

BBUUGGSS
     FFsspplliitt assumes the subprogram name is on the first noncomment line of the
     subprogram unit.  Nonstandard source formats may confuse ffsspplliitt.

     It is hard to use --ee for unnamed main programs and block data subprograms
     since you must predict the created file name.