NAME

       fcasplit - tool to split source code into separate per-routine files

SYNOPSIS

       fcasplit [ -f  nmft ] [ -c  nmcc ] [ -a  nmas ] [-noh] [-log]
                [ +fo incf ] [ +co incc ] [ +ao incs ]
                [ -fo optf ] [ -co optc ] [ -ao opts ] file.ext

       fcasplit file.ext [ fca_n ] [ optf [ optc [ opts
                                   [ nmft [ nmcc [ nmas ]]]]]]

DESCRIPTION

       fcasplit,  used  with a command line of either form shown above, splits file file.ext having a mixture of
       FORTRAN / C / assembler routines into separate files n.f or n.c or  n.s,  "n"  being  the  name  of  each
       routine,  creating at the same time a shell script file.shfca and a Make file file.mkfca  either of which
       can be used to compile all routines individually.  All new files are generated in the current  directory,
       even if the original file.ext is in a different location.

       NOTE  that  the  program  does  not work on source code written without having it in mind, since fcasplit
       looks for special identifying lines in comments of the source code in the original file, as noted  below.
       It is able to operate, for instance, on source code output by nypatchy.

       Defaults  are  defined in fcasplit for the names by which the compilers are called in the generated shell
       script and Makefile; with the -f, -c, -a options they could  be  changed.   In  Debian  GNU/Linux,  these
       defaults are gcc for the C compiler, gfortran for the FORTRAN compiler, and as for the assembler.

       Defaults are also defined for the options with which they are called; with the -fo, -co, -ao options they
       can be re-defined; with the +fo, +co, +ao options they can be incremented.  In  Debian  GNU/Linux,  these
       defaults  are "-c -g -O2" for the C compiler, "-c -g -O2 -fno-automatic" for the FORTRAN compiler, and ""
       (i.e., no flags) for the assembler.

       To be backward compatible these options can also be specified by  the  positional  parameters  after  the
       file-name (as in the second form of the command shown above).

       If  the  -noh  option is given (or if the first parameter after the file-name is "fca_n") the identifying
       header line of each routine is not written out. If the -log option is given the name of each  routine  is
       printed on standard output.

FILE FORMAT

       Each routine in the original file file.ext must start with an identifying line:
         "CDECK  ID>, "      in cols.  1-12  for FORTRAN
         "/*DECK ID>, "      in cols.  1-12  for C
         ";DECK  ID>, "      in cols.  1-12  for assembler
          "DECK  ID>, "      in cols.  2-12  or
           "DECK ID>, "      in cols.  3-12  for anything else
                     "name"  in cols. 13-40  gives the name

       In  the  last  two  cases,  or  if "name" contains an extension,  the file created will be "name" without
       extension .f, .c or .s added to it and without an entry into the script.

       A trailing blank terminates the name, symbol . followed by blank also terminates, symbols  ; < # !    all
       terminate, symbol   */        also  terminates.

SEE ALSO

       nycheck(1),   nydiff(1),   nyindex(1),   nylist(1),  nymerge(1),  nypatchy(1),  nyshell(1),  nysynopt(1),
       nytidy(1), yexpand(1)

       The reference manual for the Nypatchy suite of programs is available in compressed PostScript  format  at
       the following URL:
       http://wwwasdoc.web.cern.ch/wwwasdoc/psdir/p5refman.ps.gz

AUTHOR

       This  manual page was written by Kevin McCarty <kmccarty@debian.org> for the Debian GNU/Linux system (but
       may be used by others), based on the help information printed by the fcasplit program when called with no
       arguments.   Both fcasplit and this man page are licensed under the GNU General Public License, version 2
       or later (at your choice).

COPYRIGHT

       Copyright (C) CERN, 1996, 1999 and Kevin B. McCarty, 2008.

                                                  Mar 12, 2008                                       FCASPLIT(1)