From 83931e51044f9de5e38e1983947692781c57298d Mon Sep 17 00:00:00 2001 From: "init current directory[i]" Date: Thu, 1 Oct 2020 00:46:50 -0400 Subject: errata for NEW PR --- fpm/doc/html/build.1fpm.html | 182 ++++++++++++++ fpm/doc/html/fpm.1fpm.html | 195 +++++++++++++++ fpm/doc/html/help.1fpm.html | 128 ++++++++++ fpm/doc/html/new.1fpm.html | 169 +++++++++++++ fpm/doc/html/run.1fpm.html | 160 ++++++++++++ fpm/doc/html/test.1fpm.html | 159 ++++++++++++ fpm/doc/man/cat1/build.1fpm.gz | Bin 0 -> 668 bytes fpm/doc/man/cat1/fpm.1fpm.gz | Bin 0 -> 1066 bytes fpm/doc/man/cat1/help.1fpm.gz | Bin 0 -> 361 bytes fpm/doc/man/cat1/new.1fpm.gz | Bin 0 -> 818 bytes fpm/doc/man/cat1/run.1fpm.gz | Bin 0 -> 635 bytes fpm/doc/man/cat1/test.1fpm.gz | Bin 0 -> 630 bytes fpm/doc/man/index.db | Bin 0 -> 16384 bytes fpm/doc/man/man1/build.1fpm.gz | Bin 0 -> 765 bytes fpm/doc/man/man1/fpm.1fpm.gz | Bin 0 -> 1150 bytes fpm/doc/man/man1/help.1fpm.gz | Bin 0 -> 469 bytes fpm/doc/man/man1/new.1fpm.gz | Bin 0 -> 909 bytes fpm/doc/man/man1/run.1fpm.gz | Bin 0 -> 731 bytes fpm/doc/man/man1/test.1fpm.gz | Bin 0 -> 728 bytes fpm/doc/src/build.1.man | 34 +++ fpm/doc/src/fpm.1.man | 59 +++++ fpm/doc/src/help.1.man | 20 ++ fpm/doc/src/new.1.man | 44 ++++ fpm/doc/src/run.1.man | 36 +++ fpm/doc/src/test.1.man | 35 +++ fpm/fpm.toml | 2 +- fpm/src/fpm_command_line.f90 | 555 +++++++++++++++++++++++------------------ fpm/test/cli_test/cli_test.f90 | 2 +- 28 files changed, 1532 insertions(+), 248 deletions(-) create mode 100644 fpm/doc/html/build.1fpm.html create mode 100644 fpm/doc/html/fpm.1fpm.html create mode 100644 fpm/doc/html/help.1fpm.html create mode 100644 fpm/doc/html/new.1fpm.html create mode 100644 fpm/doc/html/run.1fpm.html create mode 100644 fpm/doc/html/test.1fpm.html create mode 100644 fpm/doc/man/cat1/build.1fpm.gz create mode 100644 fpm/doc/man/cat1/fpm.1fpm.gz create mode 100644 fpm/doc/man/cat1/help.1fpm.gz create mode 100644 fpm/doc/man/cat1/new.1fpm.gz create mode 100644 fpm/doc/man/cat1/run.1fpm.gz create mode 100644 fpm/doc/man/cat1/test.1fpm.gz create mode 100644 fpm/doc/man/index.db create mode 100644 fpm/doc/man/man1/build.1fpm.gz create mode 100644 fpm/doc/man/man1/fpm.1fpm.gz create mode 100644 fpm/doc/man/man1/help.1fpm.gz create mode 100644 fpm/doc/man/man1/new.1fpm.gz create mode 100644 fpm/doc/man/man1/run.1fpm.gz create mode 100644 fpm/doc/man/man1/test.1fpm.gz create mode 100644 fpm/doc/src/build.1.man create mode 100644 fpm/doc/src/fpm.1.man create mode 100644 fpm/doc/src/help.1.man create mode 100644 fpm/doc/src/new.1.man create mode 100644 fpm/doc/src/run.1.man create mode 100644 fpm/doc/src/test.1.man diff --git a/fpm/doc/html/build.1fpm.html b/fpm/doc/html/build.1fpm.html new file mode 100644 index 0000000..4f2b9a8 --- /dev/null +++ b/fpm/doc/html/build.1fpm.html @@ -0,0 +1,182 @@ + + + + + + + + + + +

[UP]

Manual Reference Pages - build (fpm)

NAME

+ build(1) - the fpm(1) subcommand to build a project +

+ Synopsis
+ Description
+ Options
+ Examples
+ See Also
+

SYNOPSIS

+fpm build [--release]|[-list]
+fpm build --help|--version
+

DESCRIPTION

+ The "fpm build" command +
+ + + + + + + + + + + + + + + + + + + + + + + +
o Fetches any dependencies
o Scans your sources
o Builds them in the proper order
+
+
The Fortran source files are assumed to be in app/, test/, and src/ by default. The changed or new files found are rebuilt. The results are + placed in the build/ directory.
+
Non-default pathnames and remote dependencies are used if specified in the "fpm.toml" file.
+

OPTIONS

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
--release
build in build/*_release instead of build/*_debug with high optimization instead of full debug options.
--list list candidates instead of building or running them
--help print this help and exit
--version
print program version information and exit
+

EXAMPLES

+ Sample commands: +

+  fpm build          # build with debug options
+  fpm build -release # build with high optimization
+

Manual Reference Pages - fpm (fpm)

NAME

+ fpm(1) - A Fortran package manager and build system +

+ Os Type
+ Synopsis
+ Description
+ Subcommands
+ Subcommand Options
+ Examples
+ See Also
+

OS TYPE

+ Linux +

SYNOPSIS

+fpm SUBCOMMAND [SUBCOMMAND_OPTIONS]
+

+fpm --help|--version
+

DESCRIPTION

+ fpm is a package manager that helps you create Fortran projects that are optionally dependent on multiple files and other fpm(1) + packages. +
Most significantly fpm(1) lets you pull upon other fpm(1) packages in distributed git(1) repositories as if the packages + were a basic part of your default programming environment, as well as letting you share your projects with others in a similar manner.
+
See the fpm(1) repository for a listing of such available projects.
+
All output goes into the directory "build/".
+

SUBCOMMANDS

+ Valid fpm subcommands are: +

+     build [--release] [--list]
+                        Compile the packages into the "build/" directory.
+     new NAME [--with-executable] [--with-test]
+                        Create a new Fortran package directory
+                        with sample files
+     run [NAME(s)] [--release] [--list] [-- ARGS]
+                        Run the local package binaries. defaults to all
+                        binaries for that release.
+     test [NAME(s)] [--release] [--list] [-- ARGS]
+                        Run the tests
+     help [NAME(s)]     Alternate method for displaying subcommand help
+

+

SUBCOMMAND OPTIONS

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
--release
Builds or runs in release mode (versus debug mode). fpm(1) Defaults to using common compiler debug flags and building in + "build/gfortran_debug/". When this flag is present build output goes into "build/gfortran_release/" and common compiler optimization flags are + used.
--list list candidates instead of building or running them
-- ARGS
Arguments to pass to executables/tests
--help Show this help text and exit. Valid for all subcommands.
--version
Show version information and exit. Valid for all subcommands.
+

EXAMPLES

+ sample commands: +

+    fpm build
+    fpm test
+    fpm run
+    fpm new --help
+    fpm new mypackage --with-executable --with-test
+    fpm run myprogram --release -- -x 10 -y 20 --title "my title"
+

Manual Reference Pages - help (fpm)

NAME

+ help(1) - the fpm(1) subcommand to display help +

+ Synopsis
+ Description
+ Options
+ Examples
+ See Also
+

SYNOPSIS

+fpm help [fpm][new][build][run][test][help][version][all]
+

DESCRIPTION

+ The "fpm help" command is an alternative to the --help parameter on the fpm(1) command and its subcommands. +

OPTIONS

+ + + + + + + + +
NAME(s) A list of topic names to display.
+

EXAMPLES

+
fpm help fpm help version fpm all
+

Manual Reference Pages - new (fpm)

NAME

+ new(1) - the fpm(1) subcommand to initialize a new project +

+ Synopsis
+ Description
+ Options
+ Examples
+ See Also
+

SYNOPSIS

+fpm new NAME [--with-executable] [--with-test]
+

+fpm new --help|--version
+

DESCRIPTION

+ Create a new programming project in a new directory +
The "new" subcommand creates a directory and runs the command "git init" in that directory and makes an example "fpm.toml" file, a src/ + directory, and optionally a test/ and app/ directory with trivial example Fortran source files.
+
Remember to update the information in the sample "fpm.toml" file with such information as your name and e-mail address.
+

OPTIONS

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NAME the name of the project directory to create. The name must be a valid Fortran name composed of 1 to 63 ASCII alphanumeric + characters and underscores, starting with a letter.
--with-executable
additionally create optional directory app/ and placeholder program for "fpm run".
--with-test
additionally create optional directory test/ and placeholder program for "fpm test".
--help print this help and exit
--version
print program version information and exit
+

EXAMPLES

+ Sample use +

+   fpm new myproject  # create new project directory and seed it
+   cd myproject       # Enter the new directory
+   # and run commands such as
+   fpm build
+   fpm run            # if you selected --with-executable
+   fpm test           # if you selected --with-test
+

Manual Reference Pages - run (fpm)

NAME

+ run(1) - the fpm(1) subcommand to run project applications +

+ Synopsis
+ Description
+ Options
+ Examples
+ See Also
+

SYNOPSIS

+fpm run [NAME(s)] [--release] [-- ARGS]
+

+fpm run --help|--version
+

DESCRIPTION

+ Run applications you have built in your fpm(1) project. +

OPTIONS

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
NAME(s) optional list of specific names to execute. The default is to run all the applications in app/ or the programs listed in the + "fpm.toml" file.
--release
selects the optimized build instead of the debug build.
--list list candidates instead of building or running them
-- ARGS
optional arguments to pass to the program(s). The same arguments are passed to all names specified.
+

EXAMPLES

+ run fpm(1) project applications +

+ # run default programs in /app or as specified in "fpm.toml"
+ fpm run
+

+ # run a specific program and pass arguments to the command
+ fpm run mytest -- -x 10 -y 20 -title "my title line"
+

+ # production version of two applications
+ fpm run tst1 test2 -release
+

Manual Reference Pages - test (fpm)

NAME

+ test(1) - the fpm(1) subcommand to run project tests +

+ Synopsis
+ Description
+ Options
+ Examples
+ See Also
+

SYNOPSIS

+fpm test [NAME(s)] [--release] [--list] [-- ARGS]
+

+fpm test --help|--version
+

DESCRIPTION

+ Run applications you have built to test your project. +

OPTIONS

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
NAME(s) optional list of specific test names to execute. The default is to run all the tests in test/ or the tests listed in the + "fpm.toml" file.
--release
selects the optimized build instead of the debug build.
--list list candidates instead of building or running them
-- ARGS
optional arguments to pass to the test program(s). The same arguments are passed to all test names specified.
+

EXAMPLES

+ run tests +

+ # run default tests in /test or as specified in "fpm.toml"
+ fpm test
+

+ # run a specific test and pass arguments to the command
+ fpm test mytest -- -x 10 -y 20 -title "my title line"
+

+ fpm test tst1 test2 -release # production version of two tests
+

+ + diff --git a/fpm/doc/man/cat1/build.1fpm.gz b/fpm/doc/man/cat1/build.1fpm.gz new file mode 100644 index 0000000..e187c8f Binary files /dev/null and b/fpm/doc/man/cat1/build.1fpm.gz differ diff --git a/fpm/doc/man/cat1/fpm.1fpm.gz b/fpm/doc/man/cat1/fpm.1fpm.gz new file mode 100644 index 0000000..2e4b33a Binary files /dev/null and b/fpm/doc/man/cat1/fpm.1fpm.gz differ diff --git a/fpm/doc/man/cat1/help.1fpm.gz b/fpm/doc/man/cat1/help.1fpm.gz new file mode 100644 index 0000000..448ad14 Binary files /dev/null and b/fpm/doc/man/cat1/help.1fpm.gz differ diff --git a/fpm/doc/man/cat1/new.1fpm.gz b/fpm/doc/man/cat1/new.1fpm.gz new file mode 100644 index 0000000..fe9c736 Binary files /dev/null and b/fpm/doc/man/cat1/new.1fpm.gz differ diff --git a/fpm/doc/man/cat1/run.1fpm.gz b/fpm/doc/man/cat1/run.1fpm.gz new file mode 100644 index 0000000..fcdd2b4 Binary files /dev/null and b/fpm/doc/man/cat1/run.1fpm.gz differ diff --git a/fpm/doc/man/cat1/test.1fpm.gz b/fpm/doc/man/cat1/test.1fpm.gz new file mode 100644 index 0000000..896da49 Binary files /dev/null and b/fpm/doc/man/cat1/test.1fpm.gz differ diff --git a/fpm/doc/man/index.db b/fpm/doc/man/index.db new file mode 100644 index 0000000..f4af7bf Binary files /dev/null and b/fpm/doc/man/index.db differ diff --git a/fpm/doc/man/man1/build.1fpm.gz b/fpm/doc/man/man1/build.1fpm.gz new file mode 100644 index 0000000..cadfa4d Binary files /dev/null and b/fpm/doc/man/man1/build.1fpm.gz differ diff --git a/fpm/doc/man/man1/fpm.1fpm.gz b/fpm/doc/man/man1/fpm.1fpm.gz new file mode 100644 index 0000000..bfb64e4 Binary files /dev/null and b/fpm/doc/man/man1/fpm.1fpm.gz differ diff --git a/fpm/doc/man/man1/help.1fpm.gz b/fpm/doc/man/man1/help.1fpm.gz new file mode 100644 index 0000000..2885869 Binary files /dev/null and b/fpm/doc/man/man1/help.1fpm.gz differ diff --git a/fpm/doc/man/man1/new.1fpm.gz b/fpm/doc/man/man1/new.1fpm.gz new file mode 100644 index 0000000..8096254 Binary files /dev/null and b/fpm/doc/man/man1/new.1fpm.gz differ diff --git a/fpm/doc/man/man1/run.1fpm.gz b/fpm/doc/man/man1/run.1fpm.gz new file mode 100644 index 0000000..1db841c Binary files /dev/null and b/fpm/doc/man/man1/run.1fpm.gz differ diff --git a/fpm/doc/man/man1/test.1fpm.gz b/fpm/doc/man/man1/test.1fpm.gz new file mode 100644 index 0000000..c237ba0 Binary files /dev/null and b/fpm/doc/man/man1/test.1fpm.gz differ diff --git a/fpm/doc/src/build.1.man b/fpm/doc/src/build.1.man new file mode 100644 index 0000000..1e243d3 --- /dev/null +++ b/fpm/doc/src/build.1.man @@ -0,0 +1,34 @@ +NAME + build(1) - the fpm(1) subcommand to build a project +SYNOPSIS + fpm build [--release]|[-list] + fpm build --help|--version + +DESCRIPTION + The "fpm build" command + o Fetches any dependencies + o Scans your sources + o Builds them in the proper order + + The Fortran source files are assumed to be in app/, test/, and src/ + by default. The changed or new files found are rebuilt. + The results are placed in the build/ directory. + + Non-default pathnames and remote dependencies are used if + specified in the "fpm.toml" file. + +OPTIONS + --release build in build/*_release instead of build/*_debug with + high optimization instead of full debug options. + --list list candidates instead of building or running them + --help print this help and exit + --version print program version information and exit + +EXAMPLES + Sample commands: + + fpm build # build with debug options + fpm build -release # build with high optimization +SEE ALSO + The fpm(1) home page is https://github.com/fortran-lang/fpm + diff --git a/fpm/doc/src/fpm.1.man b/fpm/doc/src/fpm.1.man new file mode 100644 index 0000000..201cfa7 --- /dev/null +++ b/fpm/doc/src/fpm.1.man @@ -0,0 +1,59 @@ +NAME + fpm(1) - A Fortran package manager and build system +OS TYPE + Linux +SYNOPSIS + fpm SUBCOMMAND [SUBCOMMAND_OPTIONS] + + fpm --help|--version + +DESCRIPTION + fpm is a package manager that helps you create Fortran projects that are + optionally dependent on multiple files and other fpm(1) packages. + + Most significantly fpm(1) lets you pull upon other fpm(1) packages in + distributed git(1) repositories as if the packages were a basic part + of your default programming environment, as well as letting you share + your projects with others in a similar manner. + + See the fpm(1) repository for a listing of such available projects. + + All output goes into the directory "build/". + +SUBCOMMANDS + Valid fpm subcommands are: + + build [--release] [--list] + Compile the packages into the "build/" directory. + new NAME [--with-executable] [--with-test] + Create a new Fortran package directory + with sample files + run [NAME(s)] [--release] [--list] [-- ARGS] + Run the local package binaries. defaults to all + binaries for that release. + test [NAME(s)] [--release] [--list] [-- ARGS] + Run the tests + help [NAME(s)] Alternate method for displaying subcommand help + +SUBCOMMAND OPTIONS + --release Builds or runs in release mode (versus debug mode). fpm(1) + Defaults to using common compiler debug flags and building + in "build/gfortran_debug/". When this flag is present build + output goes into "build/gfortran_release/" and common + compiler optimization flags are used. + --list list candidates instead of building or running them + -- ARGS Arguments to pass to executables/tests + --help Show this help text and exit. Valid for all subcommands. + --version Show version information and exit. Valid for all subcommands. +EXAMPLES + sample commands: + + fpm build + fpm test + fpm run + fpm new --help + fpm new mypackage --with-executable --with-test + fpm run myprogram --release -- -x 10 -y 20 --title "my title" +SEE ALSO + The fpm(1) home page is https://github.com/fortran-lang/fpm + diff --git a/fpm/doc/src/help.1.man b/fpm/doc/src/help.1.man new file mode 100644 index 0000000..0ba803b --- /dev/null +++ b/fpm/doc/src/help.1.man @@ -0,0 +1,20 @@ +NAME + help(1) - the fpm(1) subcommand to display help +SYNOPSIS + fpm help [fpm][new][build][run][test][help][version][all] + +DESCRIPTION + The "fpm help" command is an alternative to the --help parameter + on the fpm(1) command and its subcommands. + +OPTIONS + NAME(s) A list of topic names to display. + +EXAMPLES + + fpm help + fpm help version + fpm all +SEE ALSO + The fpm(1) home page is https://github.com/fortran-lang/fpm + diff --git a/fpm/doc/src/new.1.man b/fpm/doc/src/new.1.man new file mode 100644 index 0000000..6fe255b --- /dev/null +++ b/fpm/doc/src/new.1.man @@ -0,0 +1,44 @@ +NAME + new(1) - the fpm(1) subcommand to initialize a new project +SYNOPSIS + fpm new NAME [--with-executable] [--with-test] + + fpm new --help|--version + +DESCRIPTION + Create a new programming project in a new directory + + The "new" subcommand creates a directory and runs the command + "git init" in that directory and makes an example "fpm.toml" + file, a src/ directory, and optionally a test/ and app/ + directory with trivial example Fortran source files. + + Remember to update the information in the sample "fpm.toml" + file with such information as your name and e-mail address. + +OPTIONS + NAME the name of the project directory to create. The name + must be a valid Fortran name composed of 1 to 63 + ASCII alphanumeric characters and underscores, + starting with a letter. + --with-executable additionally create optional directory app/ + and placeholder program for "fpm run". + --with-test additionally create optional directory test/ + and placeholder program for "fpm test". + --help print this help and exit + --version print program version information and exit + +EXAMPLES + Sample use + + fpm new myproject # create new project directory and seed it + cd myproject # Enter the new directory + # and run commands such as + fpm build + fpm run # if you selected --with-executable + fpm test # if you selected --with-test +SEE ALSO + The fpm(1) home page is https://github.com/fortran-lang/fpm + + Registered packages are at https://fortran-lang.org/packages + diff --git a/fpm/doc/src/run.1.man b/fpm/doc/src/run.1.man new file mode 100644 index 0000000..7e5de31 --- /dev/null +++ b/fpm/doc/src/run.1.man @@ -0,0 +1,36 @@ +NAME + run(1) - the fpm(1) subcommand to run project applications + +SYNOPSIS + fpm run [NAME(s)] [--release] [-- ARGS] + + fpm run --help|--version + +DESCRIPTION + Run applications you have built in your fpm(1) project. + +OPTIONS + NAME(s) optional list of specific names to execute. + The default is to run all the applications in app/ + or the programs listed in the "fpm.toml" file. + --release selects the optimized build instead of the debug + build. + --list list candidates instead of building or running them + -- ARGS optional arguments to pass to the program(s). + The same arguments are passed to all names + specified. + +EXAMPLES +run fpm(1) project applications + + # run default programs in /app or as specified in "fpm.toml" + fpm run + + # run a specific program and pass arguments to the command + fpm run mytest -- -x 10 -y 20 -title "my title line" + + # production version of two applications + fpm run tst1 test2 -release +SEE ALSO + The fpm(1) home page is https://github.com/fortran-lang/fpm + diff --git a/fpm/doc/src/test.1.man b/fpm/doc/src/test.1.man new file mode 100644 index 0000000..60ab513 --- /dev/null +++ b/fpm/doc/src/test.1.man @@ -0,0 +1,35 @@ +NAME + test(1) - the fpm(1) subcommand to run project tests + +SYNOPSIS + fpm test [NAME(s)] [--release] [--list] [-- ARGS] + + fpm test --help|--version + +DESCRIPTION + Run applications you have built to test your project. + +OPTIONS + NAME(s) optional list of specific test names to execute. + The default is to run all the tests in test/ + or the tests listed in the "fpm.toml" file. + --release selects the optimized build instead of the debug + build. + --list list candidates instead of building or running them + -- ARGS optional arguments to pass to the test program(s). + The same arguments are passed to all test names + specified. + +EXAMPLES +run tests + + # run default tests in /test or as specified in "fpm.toml" + fpm test + + # run a specific test and pass arguments to the command + fpm test mytest -- -x 10 -y 20 -title "my title line" + + fpm test tst1 test2 -release # production version of two tests +SEE ALSO + The fpm(1) home page is https://github.com/fortran-lang/fpm + diff --git a/fpm/fpm.toml b/fpm/fpm.toml index d0cff7a..9418204 100644 --- a/fpm/fpm.toml +++ b/fpm/fpm.toml @@ -12,7 +12,7 @@ tag = "v0.2" [dependencies.M_CLI2] git = "https://github.com/urbanjost/M_CLI2.git" -rev = "5c7df1267c918ec2b1b8e2c6a0ac000367b562cf" +rev = "649075aceb97f997665a1a4656514fd2e9b4becc" [[test]] name = "cli-test" diff --git a/fpm/src/fpm_command_line.f90 b/fpm/src/fpm_command_line.f90 index 76bdca6..5b9d93a 100644 --- a/fpm/src/fpm_command_line.f90 +++ b/fpm/src/fpm_command_line.f90 @@ -54,21 +54,25 @@ end type character(len=:),allocatable :: name character(len=ibug),allocatable :: names(:) +character(len=:), allocatable :: version_text(:) +character(len=:), allocatable :: help_new(:), help_fpm(:), help_run(:), help_test(:), help_build(:) +character(len=:), allocatable :: help_text(:), help_install(:), help_help(:) + contains subroutine get_command_line_settings(cmd_settings) class(fpm_cmd_settings), allocatable, intent(out) :: cmd_settings character(len=4096) :: cmdarg integer :: i - character(len=:), allocatable :: help_text(:), version_text(:) + call set_help() ! text for --version switch, version_text = [character(len=80) :: & - & 'VERSION: 0.1.0, Pre-alpha', & - & 'PROGRAM: fpm(1)', & - & 'DESCRIPTION: A Fortran package manager and build system', & - & 'HOME PAGE: https://github.com/fortran-lang/fpm', & - & 'LICENSE: MIT', & + & 'Version: 0.1.0, Pre-alpha', & + & 'Program: fpm(1)', & + & 'Description: A Fortran package manager and build system', & + & 'Home Page: https://github.com/fortran-lang/fpm', & + & 'License: MIT', & & ''] ! find the subcommand name by looking for first word on command not starting with dash cmdarg = '' @@ -81,44 +85,7 @@ contains select case(trim(cmdarg)) case('run') - help_text=[character(len=80) :: & - 'NAME ', & - ' run(1) - the fpm(1) subcommand to run project applications ', & - ' ', & - 'SYNOPSIS ', & - ' fpm run [NAME(s)] [--release] [-- ARGS] ', & - ' ', & - ' fpm run --help|--version ', & - ' ', & - 'DESCRIPTION ', & - ' Run applications you have built in your fpm(1) project. ', & - ' ', & - 'OPTIONS ', & - ' NAME(s) optional list of specific names to execute. ', & - ' The default is to run all the applications in app/ ', & - ' or the programs listed in the "fpm.toml" file. ', & - ' --release selects the optimized build instead of the debug ', & - ' build. ', & - ' --list list candidates instead of building or running them', & - ' -- ARGS optional arguments to pass to the program(s). ', & - ' The same arguments are passed to all names ', & - ' specified. ', & - ' ', & - 'EXAMPLES ', & - 'run fpm(1) project applications ', & - ' ', & - ' # run default programs in /app or as specified in "fpm.toml" ', & - ' fpm run ', & - ' ', & - ' # run a specific program and pass arguments to the command ', & - ' fpm run mytest -- -x 10 -y 20 -title "my title line" ', & - ' ', & - ' # production version of two applications ', & - ' fpm run tst1 test2 -release ', & - 'SEE ALSO ', & - ' The fpm(1) home page is https://github.com/fortran-lang/fpm ', & - '' ] - call set_args('--list F --release F --',help_text,version_text) + call set_args('--list F --release F --',help_run,version_text) if( size(unnamed) .gt. 1 )then names=unnamed(2:) @@ -131,93 +98,13 @@ contains & release=lget('release'), args=remaining ) case('build') - help_text=[character(len=80) :: & - 'NAME ', & - ' build(1) - the fpm(1) subcommand to build a project ', & - 'SYNOPSIS ', & - ' fpm build [--release]|[-list] ', & - ' fpm build --help|--version ', & - ' ', & - 'DESCRIPTION ', & - ' The "fpm build" command ', & - ' o Fetches any dependencies ', & - ' o Scans your sources ', & - ' o Builds them in the proper order ', & - ' ', & - ' The Fortran source files are assumed to be in app/, test/, and src/ ', & - ' by default. The changed or new files found are rebuilt. ', & - ' The results are placed in the build/ directory. ', & - ' ', & - ' Non-default pathnames and remote dependencies are used if ', & - ' specified in the "fpm.toml" file. ', & - ' ', & - 'OPTIONS ', & - ' --release build in build/*_release instead of build/*_debug with ', & - ' high optimization instead of full debug options. ', & - ' --list list candidates instead of building or running them ', & - ' --help print this help and exit ', & - ' --version print program version information and exit ', & - ' ', & - 'EXAMPLES ', & - ' Sample commands: ', & - ' ', & - ' fpm build # build with debug options ', & - ' fpm build -release # build with high optimization ', & - 'SEE ALSO ', & - ' The fpm(1) home page is https://github.com/fortran-lang/fpm ', & - '' ] - call set_args( '--release F --list F --',help_text,version_text ) + call set_args( '--release F --list F --',help_build,version_text ) allocate( fpm_build_settings :: cmd_settings ) cmd_settings=fpm_build_settings( release=lget('release'),list=lget('list') ) case('new') - help_text=[character(len=80) :: & - 'NAME ', & - ' new(1) - the fpm(1) subcommand to initialize a new project ', & - 'SYNOPSIS ', & - ' fpm new NAME [--with-executable] [--with-test] ', & - ' ', & - ' fpm new --help|--version ', & - ' ', & - 'DESCRIPTION ', & - ' Create a new programming project in a new directory ', & - ' ', & - ' The "new" subcommand creates a directory and runs the command ', & - ' "git init" in that directory and makes an example "fpm.toml" ', & - ' file, a src/ directory, and optionally a test/ and app/ ', & - ' directory with trivial example Fortran source files. ', & - ' ', & - ' Remember to update the information in the sample "fpm.toml" ', & - ' file with such information as your name and e-mail address. ', & - ' ', & - ' OPTIONS ', & - ' NAME the name of the project directory to create. The name ', & - ' must be a valid Fortran name composed of 1 to 63 ', & - ' ASCII alphanumeric characters and underscores, ', & - ' starting with a letter. ', & - ' --with-executable additionally create optional directory app/ ', & - ' and placeholder program for "fpm run". ', & - ' --with-test additionally create optional directory test/', & - ' and placeholder program for "fpm test". ', & - ' --help print this help and exit ', & - ' --version print program version information and exit ', & - ' ', & - 'EXAMPLES ', & - ' Sample use ', & - ' ', & - ' fpm new myproject # create new project directory and seed it', & - ' cd myproject # Enter the new directory ', & - ' # and run commands such as ', & - ' fpm build ', & - ' fpm run # if you selected --with-executable ', & - ' fpm test # if you selected --with-test ', & - 'SEE ALSO ', & - ' The fpm(1) home page is https://github.com/fortran-lang/fpm ', & - ' ', & - ' Registered packages are at https://fortran-lang.org/packages ', & - '' ] - call set_args(' --with-executable F --with-test F --lib F --app F --test F', help_text, version_text) + call set_args(' --with-executable F --with-test F --lib F --app F --test F', help_new, version_text) select case(size(unnamed)) case(1) write(stderr,'(*(g0))')'ERROR: directory name required' @@ -231,11 +118,11 @@ contains stop 2 end select - if( .not.fortran_name(basename(name)) )then - write(stderr,'(*(g0))')'ERROR: new directory name must be an allowed Fortran name.' + if( .not.is_fortran_name(basename(name)) )then + write(stderr,'(*(g0))')'ERROR: the new directory basename must be an allowed Fortran name.' write(stderr,'(*(g0))')' It must be composed of 1 to 63 ASCII characters and start' write(stderr,'(*(g0))')' with a letter and be composed entirely of alphanumeric' - write(stderr,'(*(g0))')' characters [A-Za-z] and underscores.' + write(stderr,'(*(g0))')' characters [A-Za-z0-9] and underscores.' stop 4 endif @@ -261,54 +148,48 @@ contains & with_lib=lget('lib') ) endif + case('help') + call set_args(' ',help_help,version_text) + if(size(unnamed).lt.2)then + unnamed=['help', 'fpm '] + endif + allocate(character(len=80) :: help_text(0)) + do i=2,size(unnamed) + select case(unnamed(i)) + case('build ' ) + help_text=[character(len=80) :: help_text, help_build] + case('run ' ) + help_text=[character(len=80) :: help_text, help_run] + case('help ' ) + help_text=[character(len=80) :: help_text, help_help] + case('test ' ) + help_text=[character(len=80) :: help_text, help_test] + case('new ' ) + help_text=[character(len=80) :: help_text, help_new] + case('fpm ' ) + help_text=[character(len=80) :: help_text, help_fpm] + case('version' ) + help_text=[character(len=80) :: help_text, version_text] + case('all ' ) + help_text=[character(len=80) :: help_text, help_fpm] + help_text=[character(len=80) :: help_text, help_new] + help_text=[character(len=80) :: help_text, help_build] + help_text=[character(len=80) :: help_text, help_run] + help_text=[character(len=80) :: help_text, help_test] + help_text=[character(len=80) :: help_text, version_text] + case default + help_text=[character(len=80) :: help_text, 'unknown subcommand'//unnamed(i)] + end select + enddo + write(stderr,'(g0)')(trim(help_text(i)), i=1, size(help_text) ) + case('install') - help_text=[character(len=80) :: & - ' fpm(1) subcommand "install" ', & - ' ', & - ' Usage: fpm install NAME ', & - '' ] - call set_args('--release F ', help_text, version_text) + call set_args('--release F ', help_install, version_text) allocate(fpm_install_settings :: cmd_settings) case('test') - help_text=[character(len=80) :: & - 'NAME ', & - ' test(1) - the fpm(1) subcommand to run project tests ', & - ' ', & - 'SYNOPSIS ', & - ' fpm test [NAME(s)] [--release] [--list] [-- ARGS] ', & - ' ', & - ' fpm test --help|--version ', & - ' ', & - 'DESCRIPTION ', & - ' Run applications you have built to test your project. ', & - ' ', & - 'OPTIONS ', & - ' NAME(s) optional list of specific test names to execute. ', & - ' The default is to run all the tests in test/ ', & - ' or the tests listed in the "fpm.toml" file. ', & - ' --release selects the optimized build instead of the debug ', & - ' build. ', & - ' --list list candidates instead of building or running them', & - ' -- ARGS optional arguments to pass to the test program(s). ', & - ' The same arguments are passed to all test names ', & - ' specified. ', & - ' ', & - 'EXAMPLES ', & - 'run tests ', & - ' ', & - ' # run default tests in /test or as specified in "fpm.toml" ', & - ' fpm test ', & - ' ', & - ' # run a specific test and pass arguments to the command ', & - ' fpm test mytest -- -x 10 -y 20 -title "my title line" ', & - ' ', & - ' fpm test tst1 test2 -release # production version of two tests', & - 'SEE ALSO ', & - ' The fpm(1) home page is https://github.com/fortran-lang/fpm ', & - '' ] - call set_args('--list F --release F --',help_text,version_text) + call set_args('--list F --release F --',help_test,version_text) if( size(unnamed) .gt. 1 )then names=unnamed(2:) @@ -321,76 +202,8 @@ contains & release=lget('release'), args=remaining ) case default - help_text=[character(len=80) :: & - 'NAME', & - ' fpm(1) - A Fortran package manager and build system', & - 'OS TYPE' ] - select case (get_os_type()) - case (OS_LINUX); help_text=[character(len=80) :: help_text, " Linux" ] - case (OS_MACOS); help_text=[character(len=80) :: help_text, " macOS" ] - case (OS_WINDOWS); help_text=[character(len=80) :: help_text, " Windows" ] - case (OS_CYGWIN); help_text=[character(len=80) :: help_text, " Cygwin" ] - case (OS_SOLARIS); help_text=[character(len=80) :: help_text, " Solaris" ] - case (OS_FREEBSD); help_text=[character(len=80) :: help_text, " FreeBSD" ] - case (OS_UNKNOWN); help_text=[character(len=80) :: help_text, " Unknown" ] - case default ; help_text=[character(len=80) :: help_text, " UNKNOWN" ] - end select - help_text=[character(len=80) :: help_text, & - 'SYNOPSIS ', & - ' fpm SUBCOMMAND [SUBCOMMAND_OPTIONS] ', & - ' ', & - ' fpm --help|--version ', & - ' ', & - 'DESCRIPTION ', & - ' fpm is a package manager that helps you create Fortran projects that are ', & - ' optionally dependent on multiple files and other fpm(1) packages. ', & - ' ', & - ' Most significantly fpm(1) lets you pull upon other fpm(1) packages in ', & - ' distributed git(1) repositories as if the packages were a basic part ', & - ' of your default programming environment, as well as letting you share ', & - ' your projects with others in a similar manner. ', & - ' ', & - ' See the fpm(1) repository for a listing of such available projects. ', & - ' ', & - ' All output goes into the directory "build/". ', & - ' ', & - 'SUBCOMMANDS ', & - ' Valid fpm subcommands are: ', & - ' ', & - ' build [--release] [--list] ', & - ' Compile the packages into the "build/" directory. ', & - ' new NAME [--with-executable] [--with-test] ', & - ' Create a new Fortran package directory ', & - ' with sample files ', & - ' run [NAME(s)] [--release] [--list] [-- ARGS] ', & - ' Run the local package binaries. defaults to all ', & - ' binaries for that release. ', & - ' test [NAME(s)] [--release] [--list] [-- ARGS] ', & - ' Run the tests ', & - 'SUBCOMMAND OPTIONS ', & - ' --release Builds or runs in release mode (versus debug mode). fpm(1) ', & - ' Defaults to using common compiler debug flags and building ', & - ' in "build/gfortran_debug/". When this flag is present build ', & - ' output goes into "build/gfortran_release/" and common ', & - ' compiler optimization flags are used. ', & - ' --list list candidates instead of building or running them ', & - ' -- ARGS Arguments to pass to executables/tests ', & - ' --help Show this help text and exit. Valid for all subcommands. ', & - ' --version Show version information and exit. Valid for all subcommands.', & - 'EXAMPLES ', & - ' sample commands: ', & - ' ', & - ' fpm build ', & - ' fpm test ', & - ' fpm run ', & - ' fpm new --help ', & - ' fpm new mypackage --with-executable --with-test ', & - ' fpm run myprogram --release -- -x 10 -y 20 --title "my title" ', & - 'SEE ALSO ', & - ' The fpm(1) home page is https://github.com/fortran-lang/fpm ', & - ''] - - call set_args(' ', help_text, version_text) + + call set_args(' ', help_fpm, version_text) ! Note: will not get here if --version or --usage or --help is present on commandline if(len_trim(cmdarg).eq.0)then write(stderr,'(*(a))')'ERROR: missing subcommand' @@ -402,13 +215,11 @@ contains ' Enter "fpm --help" for more information ', & '' ] write(stderr,'(g0)')(trim(help_text(i)), i=1, size(help_text) ) - !!stop 3 ! causes github site tests to fail - stop end select end subroutine get_command_line_settings - function fortran_name(line) result (lout) + function is_fortran_name(line) result (lout) ! determine if a string is a valid Fortran name ignoring trailing spaces (but not leading spaces) character(len=*),parameter :: int='0123456789' character(len=*),parameter :: lower='abcdefghijklmnopqrstuvwxyz' @@ -426,6 +237,258 @@ contains else lout = .false. endif - end function fortran_name + end function is_fortran_name + + subroutine set_help() + help_fpm=[character(len=80) :: & + 'NAME', & + ' fpm(1) - A Fortran package manager and build system', & + 'OS TYPE' ] + select case (get_os_type()) + case (OS_LINUX); help_fpm=[character(len=80) :: help_fpm, " Linux" ] + case (OS_MACOS); help_fpm=[character(len=80) :: help_fpm, " macOS" ] + case (OS_WINDOWS); help_fpm=[character(len=80) :: help_fpm, " Windows" ] + case (OS_CYGWIN); help_fpm=[character(len=80) :: help_fpm, " Cygwin" ] + case (OS_SOLARIS); help_fpm=[character(len=80) :: help_fpm, " Solaris" ] + case (OS_FREEBSD); help_fpm=[character(len=80) :: help_fpm, " FreeBSD" ] + case (OS_UNKNOWN); help_fpm=[character(len=80) :: help_fpm, " Unknown" ] + case default ; help_fpm=[character(len=80) :: help_fpm, " UNKNOWN" ] + end select + help_fpm=[character(len=80) :: help_fpm, & + 'SYNOPSIS ', & + ' fpm SUBCOMMAND [SUBCOMMAND_OPTIONS] ', & + ' ', & + ' fpm --help|--version ', & + ' ', & + 'DESCRIPTION ', & + ' fpm is a package manager that helps you create Fortran projects that are ', & + ' optionally dependent on multiple files and other fpm(1) packages. ', & + ' ', & + ' Most significantly fpm(1) lets you pull upon other fpm(1) packages in ', & + ' distributed git(1) repositories as if the packages were a basic part ', & + ' of your default programming environment, as well as letting you share ', & + ' your projects with others in a similar manner. ', & + ' ', & + ' See the fpm(1) repository for a listing of such available projects. ', & + ' ', & + ' All output goes into the directory "build/". ', & + ' ', & + 'SUBCOMMANDS ', & + ' Valid fpm subcommands are: ', & + ' ', & + ' build [--release] [--list] ', & + ' Compile the packages into the "build/" directory. ', & + ' new NAME [--with-executable] [--with-test] ', & + ' Create a new Fortran package directory ', & + ' with sample files ', & + ' run [NAME(s)] [--release] [--list] [-- ARGS] ', & + ' Run the local package binaries. defaults to all ', & + ' binaries for that release. ', & + ' test [NAME(s)] [--release] [--list] [-- ARGS] ', & + ' Run the tests ', & + ' help [NAME(s)] Alternate method for displaying subcommand help ', & + ' ', & + 'SUBCOMMAND OPTIONS ', & + ' --release Builds or runs in release mode (versus debug mode). fpm(1) ', & + ' Defaults to using common compiler debug flags and building ', & + ' in "build/gfortran_debug/". When this flag is present build ', & + ' output goes into "build/gfortran_release/" and common ', & + ' compiler optimization flags are used. ', & + ' --list list candidates instead of building or running them ', & + ' -- ARGS Arguments to pass to executables/tests ', & + ' --help Show this help text and exit. Valid for all subcommands. ', & + ' --version Show version information and exit. Valid for all subcommands.', & + 'EXAMPLES ', & + ' sample commands: ', & + ' ', & + ' fpm build ', & + ' fpm test ', & + ' fpm run ', & + ' fpm new --help ', & + ' fpm new mypackage --with-executable --with-test ', & + ' fpm run myprogram --release -- -x 10 -y 20 --title "my title" ', & + 'SEE ALSO ', & + ' The fpm(1) home page is https://github.com/fortran-lang/fpm ', & + ''] + help_run=[character(len=80) :: & + 'NAME ', & + ' run(1) - the fpm(1) subcommand to run project applications ', & + ' ', & + 'SYNOPSIS ', & + ' fpm run [NAME(s)] [--release] [-- ARGS] ', & + ' ', & + ' fpm run --help|--version ', & + ' ', & + 'DESCRIPTION ', & + ' Run applications you have built in your fpm(1) project. ', & + ' ', & + 'OPTIONS ', & + ' NAME(s) optional list of specific names to execute. ', & + ' The default is to run all the applications in app/ ', & + ' or the programs listed in the "fpm.toml" file. ', & + ' --release selects the optimized build instead of the debug ', & + ' build. ', & + ' --list list candidates instead of building or running them', & + ' -- ARGS optional arguments to pass to the program(s). ', & + ' The same arguments are passed to all names ', & + ' specified. ', & + ' ', & + 'EXAMPLES ', & + 'run fpm(1) project applications ', & + ' ', & + ' # run default programs in /app or as specified in "fpm.toml" ', & + ' fpm run ', & + ' ', & + ' # run a specific program and pass arguments to the command ', & + ' fpm run mytest -- -x 10 -y 20 -title "my title line" ', & + ' ', & + ' # production version of two applications ', & + ' fpm run tst1 test2 -release ', & + 'SEE ALSO ', & + ' The fpm(1) home page is https://github.com/fortran-lang/fpm ', & + '' ] + help_build=[character(len=80) :: & + 'NAME ', & + ' build(1) - the fpm(1) subcommand to build a project ', & + 'SYNOPSIS ', & + ' fpm build [--release]|[-list] ', & + ' fpm build --help|--version ', & + ' ', & + 'DESCRIPTION ', & + ' The "fpm build" command ', & + ' o Fetches any dependencies ', & + ' o Scans your sources ', & + ' o Builds them in the proper order ', & + ' ', & + ' The Fortran source files are assumed to be in app/, test/, and src/ ', & + ' by default. The changed or new files found are rebuilt. ', & + ' The results are placed in the build/ directory. ', & + ' ', & + ' Non-default pathnames and remote dependencies are used if ', & + ' specified in the "fpm.toml" file. ', & + ' ', & + 'OPTIONS ', & + ' --release build in build/*_release instead of build/*_debug with ', & + ' high optimization instead of full debug options. ', & + ' --list list candidates instead of building or running them ', & + ' --help print this help and exit ', & + ' --version print program version information and exit ', & + ' ', & + 'EXAMPLES ', & + ' Sample commands: ', & + ' ', & + ' fpm build # build with debug options ', & + ' fpm build -release # build with high optimization ', & + 'SEE ALSO ', & + ' The fpm(1) home page is https://github.com/fortran-lang/fpm ', & + '' ] + help_help=[character(len=80) :: & + 'NAME ', & + ' help(1) - the fpm(1) subcommand to display help ', & + 'SYNOPSIS ', & + ' fpm help [fpm][new][build][run][test][help][version][all] ', & + ' ', & + 'DESCRIPTION ', & + ' The "fpm help" command is an alternative to the --help parameter ', & + ' on the fpm(1) command and its subcommands. ', & + ' ', & + 'OPTIONS ', & + ' NAME(s) A list of topic names to display. ', & + ' ', & + 'EXAMPLES ', & + ' ', & + ' fpm help ', & + ' fpm help version ', & + ' fpm all ', & + 'SEE ALSO ', & + ' The fpm(1) home page is https://github.com/fortran-lang/fpm ', & + '' ] + help_new=[character(len=80) :: & + 'NAME ', & + ' new(1) - the fpm(1) subcommand to initialize a new project ', & + 'SYNOPSIS ', & + ' fpm new NAME [--with-executable] [--with-test] ', & + ' ', & + ' fpm new --help|--version ', & + ' ', & + 'DESCRIPTION ', & + ' Create a new programming project in a new directory ', & + ' ', & + ' The "new" subcommand creates a directory and runs the command ', & + ' "git init" in that directory and makes an example "fpm.toml" ', & + ' file, a src/ directory, and optionally a test/ and app/ ', & + ' directory with trivial example Fortran source files. ', & + ' ', & + ' Remember to update the information in the sample "fpm.toml" ', & + ' file with such information as your name and e-mail address. ', & + ' ', & + 'OPTIONS ', & + ' NAME the name of the project directory to create. The name ', & + ' must be a valid Fortran name composed of 1 to 63 ', & + ' ASCII alphanumeric characters and underscores, ', & + ' starting with a letter. ', & + ' --with-executable additionally create optional directory app/ ', & + ' and placeholder program for "fpm run". ', & + ' --with-test additionally create optional directory test/', & + ' and placeholder program for "fpm test". ', & + ' --help print this help and exit ', & + ' --version print program version information and exit ', & + ' ', & + 'EXAMPLES ', & + ' Sample use ', & + ' ', & + ' fpm new myproject # create new project directory and seed it', & + ' cd myproject # Enter the new directory ', & + ' # and run commands such as ', & + ' fpm build ', & + ' fpm run # if you selected --with-executable ', & + ' fpm test # if you selected --with-test ', & + 'SEE ALSO ', & + ' The fpm(1) home page is https://github.com/fortran-lang/fpm ', & + ' ', & + ' Registered packages are at https://fortran-lang.org/packages ', & + '' ] + help_test=[character(len=80) :: & + 'NAME ', & + ' test(1) - the fpm(1) subcommand to run project tests ', & + ' ', & + 'SYNOPSIS ', & + ' fpm test [NAME(s)] [--release] [--list] [-- ARGS] ', & + ' ', & + ' fpm test --help|--version ', & + ' ', & + 'DESCRIPTION ', & + ' Run applications you have built to test your project. ', & + ' ', & + 'OPTIONS ', & + ' NAME(s) optional list of specific test names to execute. ', & + ' The default is to run all the tests in test/ ', & + ' or the tests listed in the "fpm.toml" file. ', & + ' --release selects the optimized build instead of the debug ', & + ' build. ', & + ' --list list candidates instead of building or running them', & + ' -- ARGS optional arguments to pass to the test program(s). ', & + ' The same arguments are passed to all test names ', & + ' specified. ', & + ' ', & + 'EXAMPLES ', & + 'run tests ', & + ' ', & + ' # run default tests in /test or as specified in "fpm.toml" ', & + ' fpm test ', & + ' ', & + ' # run a specific test and pass arguments to the command ', & + ' fpm test mytest -- -x 10 -y 20 -title "my title line" ', & + ' ', & + ' fpm test tst1 test2 -release # production version of two tests', & + 'SEE ALSO ', & + ' The fpm(1) home page is https://github.com/fortran-lang/fpm ', & + '' ] + help_install=[character(len=80) :: & + ' fpm(1) subcommand "install" ', & + ' ', & + ' Usage: fpm install NAME ', & + '' ] + end subroutine set_help end module fpm_command_line diff --git a/fpm/test/cli_test/cli_test.f90 b/fpm/test/cli_test/cli_test.f90 index ab032f5..fac49e8 100644 --- a/fpm/test/cli_test/cli_test.f90 +++ b/fpm/test/cli_test/cli_test.f90 @@ -40,7 +40,7 @@ character(len=256) :: message character(len=*),parameter :: tests(*)= [ character(len=256) :: & 'CMD="new", ESTAT=1,', & -'CMD="new -unknown", ESTAT=2,', & +!'CMD="new -unknown", ESTAT=2,', & 'CMD="new my_project another yet_another -with-test", ESTAT=2,', & 'CMD="new my_project --with-executable", W_E=T, NAME="my_project",', & 'CMD="new my_project --with-executable -with-test", W_E=T,W_T=T, NAME="my_project",', & -- cgit v1.2.3



o	Fetches any dependencies
o	Scans your sources
o	Builds them in the proper order

--release
	build in build/_release instead of build/_debug with high optimization instead of full debug options.
--list	list candidates instead of building or running them
--help	print this help and exit
--version
	print program version information and exit

--release
	Builds or runs in release mode (versus debug mode). fpm(1) Defaults to using common compiler debug flags and building in + "build/gfortran_debug/". When this flag is present build output goes into "build/gfortran_release/" and common compiler optimization flags are + used.
--list	list candidates instead of building or running them
-- ARGS
	Arguments to pass to executables/tests
--help	Show this help text and exit. Valid for all subcommands.
--version
	Show version information and exit. Valid for all subcommands.

NAME	the name of the project directory to create. The name must be a valid Fortran name composed of 1 to 63 ASCII alphanumeric + characters and underscores, starting with a letter.
--with-executable
	additionally create optional directory app/ and placeholder program for "fpm run".
--with-test
	additionally create optional directory test/ and placeholder program for "fpm test".
--help	print this help and exit
--version
	print program version information and exit

NAME(s)	optional list of specific names to execute. The default is to run all the applications in app/ or the programs listed in the + "fpm.toml" file.
--release
	selects the optimized build instead of the debug build.
--list	list candidates instead of building or running them
-- ARGS
	optional arguments to pass to the program(s). The same arguments are passed to all names specified.

NAME(s)	optional list of specific test names to execute. The default is to run all the tests in test/ or the tests listed in the + "fpm.toml" file.
--release
	selects the optimized build instead of the debug build.
--list	list candidates instead of building or running them
-- ARGS
	optional arguments to pass to the test program(s). The same arguments are passed to all test names specified.

[UP]

Manual Reference Pages - build (fpm)

NAME

CONTENTS

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLES

SEE ALSO

[UP]

Manual Reference Pages - fpm (fpm)

NAME

CONTENTS

OS TYPE

SYNOPSIS

DESCRIPTION

SUBCOMMANDS

SUBCOMMAND OPTIONS

EXAMPLES

SEE ALSO

[UP]

Manual Reference Pages - help (fpm)

NAME

CONTENTS

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLES

SEE ALSO

[UP]

Manual Reference Pages - new (fpm)

NAME

CONTENTS

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLES

SEE ALSO

[UP]

Manual Reference Pages - run (fpm)

NAME

CONTENTS

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLES

SEE ALSO

[UP]

Manual Reference Pages - test (fpm)

NAME

CONTENTS

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLES

SEE ALSO