Annotation of 43BSDReno/pgrm/fsplit/fsplit.1, revision 1.1.1.1

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.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.