FWD » Core Development » Base Language

# This feature was added in FWD v4.0, see #5135 for more details.

#

# This mode is extremely flexible. It can do everything that the other modes can do and more. Except for some one-off usage from the command line (where an explicit list of filenames or file specification mode can be useful), -z mode if expected to be the way that most projects are configured.

#

# The input for this mode is a single relative filename for a text file that contains an explicit list of directives. This list of directives is called a "File Set". To use this approach, pass -z on the command line.

#

# Example:

#

# java -classpath $P2J_HOME/p2j/build/lib/p2j.jar com.goldencode.p2j.convert.ConversionDriver -z f2 my_file_set.txt

#

# The -z option forces the driver to calculate a list of files for processing based on the directives in the text file passed as the required parameter.

#

# These are the directives:

#

#    D <recursive_top_level_dir> <file_spec> adds a top level directory and a file spec which will be recursively processed to add 0 or more files into the list

#    N <non_recursive_top_level_dir> <file_spec> adds a top level dir and file spec which will be non-recursively processed to add 0 or more files into the list

#    F <absolute_or_relative_file_name> - explicitly adds a single/individual file into the list

#    X <exclusion_filter_expression_including_wildcards> - filter to remove from the list

#    I <inclusion_filter_expression_including_wildcards> - filter to add something removed back into the list

#

# The input file will be processed in 2 passes:

#

#    1. Process all D, N and F directives to make the maximal file list of all matching files. These can be processed in any order because each of these directives only ever add to the list. If there are no D, N and F directives, then we will create a maximal file list using D . (*.[pPwW]|*.cls) which will gather all .p, .P, .w, .W and .cls files under the current directory, recursively.

#    2. Process all X and I filters, in order from top to bottom, to modify the maximal list into the actual list of files to be processed.

#

# An example of the content for my_file_set.txt is:

#

# D ./abl/ (*.[pPwW]|*.cls)

# F ./other/my_app/module1/some-file.p

# F ./src/my_app/module1/another.p

# F ./src/my_app/module2/different-file.p

# N ./other/your_app/ *.[pP]

# X ./abl/possenet/*

# I ./abl/possenet/src/adecomm/as-utils.w

# I ./abl/possenet/src/adecomm/get-user.p

# I ./abl/possenet/src/adm2/containr.p

# I ./abl/possenet/src/adm2/dyndata.w

# I ./abl/possenet/src/adm2/fetchdata.p

# I ./abl/possenet/src/adm2/fetchrows.p

# I ./abl/possenet/src/adm2/smart.p

# I ./abl/possenet/src/adm2/support/visuald.w

# I ./abl/possenet/src/adm2/visual.p

# I ./abl/possenet/src/dynamics/af/cod2/aftemsuspd.w

#

# Please follow these rules:

#

#   o There is one directive per line.

#   o All filenames are relative to the project root.

#   o Spaces in filenames or file specifications can only be specified if the value is surrounded by double quote characters (e.g. "this is a stupid idea.p" or "*dumb\ spec*.[pPwW]").

#   o Double quote characters in a filename or file specification can be included but must be escaped with the backslash character \.

#   o The UNIX/Linux path separator character / is always used. The tools will convert this to the local platform's path separator as needed.

#   o A # as the first character on a line will treat the entire line as a comment (it will be ignored). A # character anywhere else will be considered part of the filename.

F ./abl/ade/src/web/objects/web-disp.p

F ./abl/ade/src/webutil/webstart.p

F ./abl/ade/src/web/objects/stateaware.p

F ./abl/ade/src/web/objects/web-util.p

F ./abl/ade/src/web/objects/session.p

F ./abl/ade/src/web/support/webinput.p

F ./abl/ade/src/web/support/webtog.p

F ./abl/ade/src/web/support/webradio.p

F ./abl/ade/src/web/support/weblist.p

F ./abl/ade/src/web/support/webedit.p

F ./abl/ade/src/web/support/tagrun.p

F ./abl/ade/src/web/support/webmsg.p