|
|
1.1 root 1: .\" Copyright (c) 1983, 1990 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" This code is derived from software contributed to Berkeley by
5: .\" Asa Romberger and Jerry Berkman.
6: .\"
7: .\" Redistribution and use in source and binary forms are permitted provided
8: .\" that: (1) source distributions retain this entire copyright notice and
9: .\" comment, and (2) distributions including binaries display the following
10: .\" acknowledgement: ``This product includes software developed by the
11: .\" University of California, Berkeley and its contributors'' in the
12: .\" documentation or other materials provided with the distribution and in
13: .\" all advertising materials mentioning features or use of this software.
14: .\" Neither the name of the University nor the names of its contributors may
15: .\" be used to endorse or promote products derived from this software without
16: .\" specific prior written permission.
17: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
18: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
19: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
20: .\"
21: .\" @(#)fsplit.1 6.5 (Berkeley) 7/24/90
22: .\"
23: .Dd July 24, 1990
24: .Dt FSPLIT 1
25: .Os BSD 4.2
26: .Sh NAME
27: .Nm fsplit
28: .Nd split a multi-routine Fortran file into individual files
29: .Sh SYNOPSIS
30: .Nm fsplit
31: .Op Fl e Ar efile
32: \&...
33: .Op Ar file
34: .Sh DESCRIPTION
35: .Nm Fsplit
36: takes as input either a file or standard input containing Fortran source code.
37: It attempts to split the input into separate routine files of the
38: form
39: .Ar name.f ,
40: where
41: .Ar name
42: is the name of the program unit (e.g. function, subroutine, block data or
43: program). The name for unnamed block data subprograms has the form
44: .Ar blkdtaNNN.f
45: where NNN is three digits and a file of this name does not already exist.
46: For unnamed main programs the name has the form
47: .Ar mainNNN.f .
48: If there is an error in classifying a program unit, or if
49: .Ar name.f
50: already exists,
51: the program unit will be put in a file of the form
52: .Ar zzzNNN.f
53: where
54: .Ar zzzNNN.f
55: does not already exist.
56: .Pp
57: .Tw Ar
58: .Tc Fl e
59: .Ws
60: .Ar efile
61: .Cx
62: Normally each subprogram unit is split into a separate file. When the
63: .Fl e
64: option is used, only the specified subprogram units are split into separate
65: files. E.g.:
66: .Pp
67: .Dl fsplit -e readit -e doit prog.f
68: .Pp
69: will split readit and doit into separate files.
70: .Tp
71: .Sh DIAGNOSTICS
72: If names specified via the
73: .Fl e
74: option are not found, a diagnostic is written to
75: standard error.
76: .Sh HISTORY
77: .Nm Fsplit
78: appeared in 4.2 BSD.
79: .Sh AUTHORS
80: Asa Romberger and Jerry Berkman
81: .Sh BUGS
82: .Nm Fsplit
83: assumes the subprogram name is on the first noncomment line of the subprogram
84: unit. Nonstandard source formats may confuse
85: .Nm fsplit .
86: .Pp
87: It is hard to use
88: .Fl e
89: for unnamed main programs and block data subprograms since you must
90: predict the created file name.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.