FPT and WinFPT Reference Manual - Command-line Commands

| SimCon Home | Reference Manual Home |


KEEP OUTPUT DIRECTORIES

Syntax:

[DO NOT] KEEP [ OUTPUT ] DIRECTORIES

Function:

Instructs FPT to write the Fortran output files to the same directories as the corresponding input files. FPT changes the output file name extensions, so name collisions may be avoided between the input and output files. If collisions occur, the behaviour is controlled by the commands [ DO NOT ] OVERWRITE EXISTING FILES and MAXIMUM BASE FILE NAME LENGTH. The possible actions are:

  1. DO NOT OVERWRITE EXISTING FILES and either no specification for MAXIMUM BASE FILE NAME LENGTH or a value which is sufficiently long to accommodate the new name - FPT renames the output file by appending one or more digits to the base file name;

  2. DO NOT OVERWRITE EXISTING FILES but a specification for MAXIMUM BASE FILE NAME LENGTH which is too short too accommodate a lengthened file name - FPT renames the output file by replacing the last, or last few characters of the base name with digits;

  3. OVERWRITE EXISTING FILES - FPT replaces the input file, or, under VMS, writes a new file with a higher version number. (This is not normally recommended).

FPT may generate new Fortran files which have no direct correspondence to specific input files. These are written to the current working directory, or to the directory specified by an OUTPUT DIRECTORY, PRIMARY OUTPUT DIRECTORY or INCLUDE OUTPUT DIRECTORY command.

This command may be used in combination with the EDIT OUTPUT FILE NAMES command to preserve a directory structure for the output files, but to move them to a different base directory. For example, in an FSP file:

! heli.fsp
%input directory: “/home/john/vt3/pre_fpt/aero”
kinetics.f90
aerotab.f90
rotor.f90
trotor.f90
 
%input directory: “/home/john/vt3/pre_fpt/control”
pal.f90
cyclic.f90
collective.f90
switches.f90
 
%keep output directories
%edit output file names: replace "pre_fpt" by "post_fpt"

The files will be written to the directories:

/home/john/vt3/post_fpt/aero

/home/john/vt3/post_fpt/control

The listing (FPL) file and temporary files used in processing are always written to the current working directory.

Where to use this command:

Operating system command line

Yes


Configuration file, config.fsp

Yes


Specification (FSP) files, *.fsp

Yes


Interactively, to FPT> prompt:

Yes


Interactive command files

Yes


Embedded in the Fortran code

Yes


Default:

DO NOT KEEP OUTPUT DIRECTORIES

See also:

MAXIMUM BASE FILE NAME LENGTH

OUTPUT DIRECTORY

OVERWRITE EXISTING FILES


Copyright ©1995 to 2014 Software Validation Ltd. All rights reserved.