aboutsummaryrefslogtreecommitdiff
path: root/docs/index.html
blob: f351396c3c83848607cada200f47e58e2b0fb6a3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
<html> 
<head> 
<title> </title>
<style> 
px {font-family: "Lucida Console", Monaco }
p { font-size:100%; line-height:1.1em; }
body {xfont-style: sans-serif}
body {
color:#333; font-family:Verdana, Arial, Helvetica, sans-serif; font-size:1em; line-height:1.3em; }
a:visited { color:#666; }
h1,h2,h3,h4,h5,h6 { color:#333; font-family:georgia, verdana, sans-serif; }
h1 { font-size:150%; page-break-before:auto;background-color: #aaaaff}
h2 { font-size:143%;color:teal; }
h3 { font-size:134%;color:blue; }
h4 { font-size:120%;color:gray; }
img { max-width: 55em}
p{ padding: 0;margin:0; }
p{ padding-right:1.4em; }
p{ padding-bottom:1em; }
p{ padding-top:1em; }
p{ whitespace: pre-wrap; }
h5,h6 { font-size:100% }
a.nav,a:link.nav, a:visited.nav { background-color:#FFF; color:#000; }
XXtable { border:double #000; border-collapse:collapse; }
XXtable { border-collapse:collapse; }
XXtd { border:thin solid #888; }
XXtd { border:none; }
li { margin-bottom:0.5em; }
blockquote { display:block; font-size:100%; line-height:1.1em; margin:0 0 1.5em; padding:0 2.5em; }
pre { background-color:#DDD; font-size:100%; overflow:auto; padding:1em; }
a,li span { color:#000; }
a:hover, a.nav:hover, a:hover math { background-color:#000; color:#FFF; }
#Container { margin:0 10px; text-align:center; background-color: #BBB}
#Content { border-top:none; margin:auto; padding:0.3em; text-align:left; width:100%; max-width:55em; background:#FFF}
span.webName { font-size:.5em; }
textarea#content { font-size: 1em; line-height: 1.125; }
h1#pageName { line-height:1em; margin:0.2em 0 0.2em 0; padding:0; }
.property { color:#666; font-size:100%; }
a.existingWikiWord[title]{ //border: 1px dashed #BBB; }
.byline { color:#666; font-size:1.0em; font-style:italic; margin-bottom:1em; padding-top:1px; } 
</style> 
</head>
<BODY bgcolor=#F0F0F0 text=#000000 link=#0000ff vlink=#C000C0 alink=#ff0000><A NAME=top></A>
<h5><a href="download.html">[UP]</a></h5>
<div id="Container">
<div id="Content">
<CENTER>
<H1><HR><I>Manual Reference Pages &nbsp;-&nbsp;</I><NOBR>untitled ()</NOBR><HR></H1>
</CENTER>
<A name=37>

     <H3>NAME</H3>

</A>
<BLOCKQUOTE>
<B>fpm</B>(1) - A Fortran package manager and build system
<P>
</BLOCKQUOTE>
<A name=43>

     <H3>SYNOPSIS</H3>

</A>
<BLOCKQUOTE>
<B>fpm</B> <I>SUBCOMMAND</I> [SUBCOMMAND_OPTIONS]
<P>
<B>fpm</B> <B>--help</B>|<B>--version</B>|<B>--list</B>
</BLOCKQUOTE>
<A name=39>

     <H3>DESCRIPTION</H3>

</A>
<BLOCKQUOTE>
<B>fpm</B>(1) is a package manager that helps you create Fortran projects
from source.
<P>
Most significantly <B>fpm</B>(1) lets you pull upon other <B>fpm</B>(1) packages
in distributed <B>git</B>(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.
<P>
See the <B>fpm</B>(1) repository at https://fortran-lang.org/packages
for a listing of registered projects.
<P>
All output goes into the directory "build/" which can generally be
removed and rebuilt if required. Note that if external packages are
being used you need network connectivity to rebuild from scratch.
</BLOCKQUOTE>
<A name=3>

     <H3>SUBCOMMANDS</H3>

</A>
<BLOCKQUOTE>
Valid <B>fpm</B> subcommands are:
<P>
<PRE>
     build [--release] [--list]
                     Compile the packages into the "build/" directory.
     new NAME [--lib|--src] [--app] [--test] [--backfill]
                     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
     list [--list]   Display brief descriptions of all subcommands.
<P>
</PRE>
</BLOCKQUOTE>
<A name=4>

     <H3>SUBCOMMAND OPTIONS</H3>

</A>
<BLOCKQUOTE>
<TABLE cellpadding=3>
<TR valign=top><TD colspan=2>
<B></B><B>--release</B> </TD></TR><TR valign=top><TD width=6%>&nbsp;</TD><TD>
Builds or runs in release mode (versus debug mode). <B>fpm</B>(1)
Defaults to using common compiler debug flags and building
in "build/*_debug/". When this flag is present build
output goes into "build/*_release/" and common compiler
optimization flags are used.
</TD></TR>
<TR valign=top><TD width=6% nowrap>
<B></B><B>--list</B> </TD><TD valign=bottom>
List candidates instead of building or running them.
On the <B>fpm</B> command this shows a brief list of subcommands.
</TD></TR>
<TR valign=top><TD colspan=2>
<B>-- ARGS</B> </TD></TR><TR valign=top><TD width=6%>&nbsp;</TD><TD>
Arguments to pass to executables/tests
</TD></TR>
<TR valign=top><TD width=6% nowrap>
<B></B><B>--help</B> </TD><TD valign=bottom>
Show help text and exit. Valid for all subcommands.
</TD></TR>
<TR valign=top><TD colspan=2>
<B></B><B>--version</B> </TD></TR><TR valign=top><TD width=6%>&nbsp;</TD><TD>
Show version information and exit. Valid for all
subcommands.
</TD></TR>
<TR></TR></TABLE></BLOCKQUOTE>
<A name=41>

     <H3>EXAMPLES</H3>

</A>
<BLOCKQUOTE>
sample commands:
<P>
<PRE>
    fpm new mypackage --app --test
    fpm build
    fpm test
    fpm run
    fpm new --help
    fpm run myprogram --release -- -x 10 -y 20 --title "my title"
<P>
</PRE>
</BLOCKQUOTE>
<A name=42>

     <H3>SEE ALSO</H3>

</A>
<BLOCKQUOTE>
The <B>fpm</B>(1) home page at https://github.com/fortran-lang/<B>fpm</B>
</BLOCKQUOTE>
<A name=37>

     <H3>NAME</H3>

</A>
<BLOCKQUOTE>
<B>new</B>(1) - the <B>fpm</B>(1) subcommand to initialize a new project
</BLOCKQUOTE>
<A name=38>

     <H3>SYNOPSIS</H3>

</A>
<BLOCKQUOTE>
<B>fpm</B> <I>new</I> <I><A HREF=#37>NAME</A></I> [-<B>-lib</B>|<B>--src</B>] [-<B>-app</B>] [-<B>-test</B>] [-<B>-backfill</B>]
<P>
<B>fpm</B> <I>new</I> <B>--help</B>|<B>--version</B>
</BLOCKQUOTE>
<A name=39>

     <H3>DESCRIPTION</H3>

</A>
<BLOCKQUOTE>
"<B>fpm</B> <I>new</I>" creates a <I>new</I> programming project in a <I>new</I> directory.
<P>
The "<I>new</I>" subcommand creates a directory with the specified
name and runs the command "git init" in that directory and
populates it with an example "fpm.toml" file, a src/, test/,
and app/ directory with trivial example Fortran source files
and a ".gitignore" file for ignoring the build/ directory
(where <B>fpm</B>-generated output will be placed):
<P>
<PRE>
    NAME/
      fpm.toml
      .gitignore
      src/
          NAME.f90
      app/
          main.f90
      test/
          main.f90
<P>
</PRE>
Remember to update the information in the sample "fpm.toml"
file with your name and e-mail address.
</BLOCKQUOTE>
<A name=40>

     <H3>OPTIONS</H3>

</A>
<BLOCKQUOTE>
<TABLE cellpadding=3>
<TR valign=top><TD width=6% nowrap>
<B></B><I>NAME</I> </TD><TD valign=bottom>
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.
</TD></TR>
<TR><TD colspan=2>
The default is to create all of the src/, app/, and test/
directories. If any of the following options are specified
then only selected subdirectories are generated:
</TD></TR>
<TR valign=top><TD colspan=2>
<B></B><B>--lib</B>,<B>--src</B> </TD></TR><TR valign=top><TD width=6%>&nbsp;</TD><TD>
create directory src/ and a placeholder module
named "NAME.f90" for use with subcommand "build".
</TD></TR>
<TR valign=top><TD width=6% nowrap>
<B></B><B>--app</B> </TD><TD valign=bottom>
create directory app/ and a placeholder main
program for use with subcommand "run".
</TD></TR>
<TR valign=top><TD width=6% nowrap>
<B></B><B>--test</B> </TD><TD valign=bottom>
create directory test/ and a placeholder program
for use with the subcommand "test". Note that sans
"<B>--lib</B>" it really does not have anything to test.
</TD></TR>
<TR><TD colspan=2>
So the default is equivalent to "<B>fpm</B> <I><A HREF=#37>NAME</A></I> <B>--lib</B> <B>--app</B> <B>--test</B>".
</TD></TR>
<TR valign=top><TD colspan=2>
<B></B><B>--backfill</B> </TD></TR><TR valign=top><TD width=6%>&nbsp;</TD><TD>
By default the directory must not exist. If this
option is present the directory may pre-exist and
only subdirectories and files that do not
already exist will be created. For example, if you
previously entered "<B>fpm</B> <I>new</I> myname <B>--lib</B>" entering
"<B>fpm</B> <I>new</I> myname <B>--backfill</B>" will create the missing
app/ and test/ directories and programs.
</TD></TR>
<TR valign=top><TD width=6% nowrap>
<B></B><B>--help</B> </TD><TD valign=bottom>
print this help and exit
</TD></TR>
<TR valign=top><TD colspan=2>
<B></B><B>--version</B> </TD></TR><TR valign=top><TD width=6%>&nbsp;</TD><TD>
print program version information and exit
</TD></TR>
<TR></TR></TABLE></BLOCKQUOTE>
<A name=41>

     <H3>EXAMPLES</H3>

</A>
<BLOCKQUOTE>
Sample use
<P>
<PRE>
   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            # run example application program
   fpm test           # run example test program
<P>
</PRE>
</BLOCKQUOTE>
<A name=42>

     <H3>SEE ALSO</H3>

</A>
<BLOCKQUOTE>
The <B>fpm</B>(1) home page at https://github.com/fortran-lang/<B>fpm</B>
<P>
Registered packages are at https://fortran-lang.org/packages
</BLOCKQUOTE>
<A name=37>

     <H3>NAME</H3>

</A>
<BLOCKQUOTE>
<B>build</B>(1) - the <B>fpm</B>(1) subcommand to build a project
<P>
</BLOCKQUOTE>
<A name=38>

     <H3>SYNOPSIS</H3>

</A>
<BLOCKQUOTE>
<B>fpm</B> <I>build</I> [-<B>-release</B>]|[-list]
<P>
<B>fpm</B> <I>build</I> <B>--help</B>|<B>--version</B>
</BLOCKQUOTE>
<A name=39>

     <H3>DESCRIPTION</H3>

</A>
<BLOCKQUOTE>
The "<B>fpm</B> <I>build</I>" command
<BLOCKQUOTE>
<TABLE cellpadding=3><!-- tsb: The "<B>fpm</B> <I>build</I>" command
 -->
<TR></TR><TR></TR>
<TR valign=top><TD width=3%>
o
</TD><TD>
Fetches any dependencies
</TD></TR>
<TR valign=top><TD width=3%>
o
</TD><TD>
Scans your sources
</TD></TR>
<TR valign=top><TD width=3%>
o
</TD><TD>
Builds them in the proper order
</TD></TR>
<TR></TR></TABLE></BLOCKQUOTE>
<P>
The Fortran source files are assumed by default to be in
<BLOCKQUOTE>
<TABLE cellpadding=3><!-- tsb: The Fortran source files are assumed by default to be in
 -->
<TR></TR><TR></TR>
<TR valign=top><TD width=3%>
o
</TD><TD>
src/ for modules and procedure source
</TD></TR>
<TR valign=top><TD width=3%>
o
</TD><TD>
app/ main <B>program</B>(s) for applications
</TD></TR>
<TR valign=top><TD width=3%>
o
</TD><TD>
test/ main <B>program</B>(s) and support files for project tests
Changed or <I>new</I> files found are rebuilt. The results are placed in
the <I>build</I>/ directory.
</TD></TR>
<TR></TR></TABLE></BLOCKQUOTE>
<P>
Non-default pathnames and remote dependencies are used if
specified in the "fpm.toml" file.
</BLOCKQUOTE>
<A name=40>

     <H3>OPTIONS</H3>

</A>
<BLOCKQUOTE>
<TABLE cellpadding=3>
<TR valign=top><TD colspan=2>
<B></B><B>--release</B> </TD></TR><TR valign=top><TD width=6%>&nbsp;</TD><TD>
<I>build</I> in <I>build</I>/*_release instead of <I>build</I>/*_debug with
high optimization instead of full debug options.
</TD></TR>
<TR valign=top><TD width=6% nowrap>
<B></B><B>--list</B> </TD><TD valign=bottom>
list candidates instead of building or running them
</TD></TR>
<TR valign=top><TD width=6% nowrap>
<B></B><B>--help</B> </TD><TD valign=bottom>
print this help and exit
</TD></TR>
<TR valign=top><TD colspan=2>
<B></B><B>--version</B> </TD></TR><TR valign=top><TD width=6%>&nbsp;</TD><TD>
print program version information and exit
</TD></TR>
<TR></TR></TABLE></BLOCKQUOTE>
<A name=41>

     <H3>EXAMPLES</H3>

</A>
<BLOCKQUOTE>
Sample commands:
<P>
<PRE>
  fpm build           # build with debug options
  fpm build --release # build with high optimization
<P>
</PRE>
</BLOCKQUOTE>
<A name=42>

     <H3>SEE ALSO</H3>

</A>
<BLOCKQUOTE>
The <B>fpm</B>(1) home page at https://github.com/fortran-lang/<B>fpm</B>
</BLOCKQUOTE>
<A name=37>

     <H3>NAME</H3>

</A>
<BLOCKQUOTE>
<B>run</B>(1) - the <B>fpm</B>(1) subcommand to run project applications
<P>
</BLOCKQUOTE>
<A name=38>

     <H3>SYNOPSIS</H3>

</A>
<BLOCKQUOTE>
<B>fpm</B> run <B>[NAME</B>(<I>s</I>)] [-<B>-release</B>] [-- ARGS]
<P>
<B>fpm</B> run <B>--help</B>|<B>--version</B>
</BLOCKQUOTE>
<A name=39>

     <H3>DESCRIPTION</H3>

</A>
<BLOCKQUOTE>
Run applications you have built in your <B>fpm</B>(1) project.
</BLOCKQUOTE>
<A name=40>

     <H3>OPTIONS</H3>

</A>
<BLOCKQUOTE>
<TABLE cellpadding=3>
<TR valign=top><TD width=6% nowrap>
<B></B><I>NAME</I>(<I>s</I>) </TD><TD valign=bottom>
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.
</TD></TR>
<TR valign=top><TD colspan=2>
<B></B><B>--release</B> </TD></TR><TR valign=top><TD width=6%>&nbsp;</TD><TD>
selects the optimized <I>build</I> instead of the debug
<I>build</I>.
</TD></TR>
<TR valign=top><TD width=6% nowrap>
<B></B><B>--list</B> </TD><TD valign=bottom>
list candidates instead of building or running them
</TD></TR>
<TR valign=top><TD colspan=2>
<B>-- ARGS</B> </TD></TR><TR valign=top><TD width=6%>&nbsp;</TD><TD>
optional arguments to pass to the <B>program</B>(<I>s</I>).
The same arguments are passed to all names
specified.
</TD></TR>
<TR></TR></TABLE></BLOCKQUOTE>
<A name=41>

     <H3>EXAMPLES</H3>

</A>
<BLOCKQUOTE>
run <B>fpm</B>(1) project applications
<P>
<PRE>
  # run default programs in /app or as specified in "fpm.toml"
  fpm run
<P>
  # run a specific program and pass arguments to the command
  fpm run mytest -- -x 10 -y 20 --title "my title line"
<P>
  # run production version of two applications
  fpm run prg1 prg2 --release
<P>
</PRE>
</BLOCKQUOTE>
<A name=42>

     <H3>SEE ALSO</H3>

</A>
<BLOCKQUOTE>
The <B>fpm</B>(1) home page at https://github.com/fortran-lang/<B>fpm</B>
</BLOCKQUOTE>
<A name=37>

     <H3>NAME</H3>

</A>
<BLOCKQUOTE>
<B>test</B>(1) - the <B>fpm</B>(1) subcommand to run project tests
<P>
</BLOCKQUOTE>
<A name=38>

     <H3>SYNOPSIS</H3>

</A>
<BLOCKQUOTE>
<B>fpm</B> test <B>[NAME</B>(<I>s</I>)] [-<B>-release</B>] [-<B>-list</B>] [-- ARGS]
<P>
<B>fpm</B> test <B>--help</B>|<B>--version</B>
</BLOCKQUOTE>
<A name=39>

     <H3>DESCRIPTION</H3>

</A>
<BLOCKQUOTE>
Run applications you have built to test your project.
</BLOCKQUOTE>
<A name=40>

     <H3>OPTIONS</H3>

</A>
<BLOCKQUOTE>
<TABLE cellpadding=3>
<TR valign=top><TD width=6% nowrap>
<B></B><I>NAME</I>(<I>s</I>) </TD><TD valign=bottom>
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.
</TD></TR>
<TR valign=top><TD colspan=2>
<B></B><B>--release</B> </TD></TR><TR valign=top><TD width=6%>&nbsp;</TD><TD>
selects the optimized <I>build</I> instead of the debug
<I>build</I>.
</TD></TR>
<TR valign=top><TD width=6% nowrap>
<B></B><B>--list</B> </TD><TD valign=bottom>
list candidates instead of building or running them
</TD></TR>
<TR valign=top><TD colspan=2>
<B>-- ARGS</B> </TD></TR><TR valign=top><TD width=6%>&nbsp;</TD><TD>
optional arguments to pass to the test <B>program</B>(<I>s</I>).
The same arguments are passed to all test names
specified.
</TD></TR>
<TR></TR></TABLE></BLOCKQUOTE>
<A name=41>

     <H3>EXAMPLES</H3>

</A>
<BLOCKQUOTE>
run tests
<P>
<PRE>
 # run default tests in /test or as specified in "fpm.toml"
 fpm test
<P>
 # run a specific test and pass arguments to the command
 fpm test mytest -- -x 10 -y 20 --title "my title line"
<P>
 fpm test tst1 tst2 --release # production version of two tests
<P>
</PRE>
</BLOCKQUOTE>
<A name=42>

     <H3>SEE ALSO</H3>

</A>
<BLOCKQUOTE>
The <B>fpm</B>(1) home page at https://github.com/fortran-lang/<B>fpm</B>
</BLOCKQUOTE>
<A name=37>

     <H3>NAME</H3>

</A>
<BLOCKQUOTE>
<B>help</B>(1) - the <B>fpm</B>(1) subcommand to display help
<P>
</BLOCKQUOTE>
<A name=38>

     <H3>SYNOPSIS</H3>

</A>
<BLOCKQUOTE>
<I>fpm</I> <I>help</I> [fpm] [new] [build] [run] [test] [help] [version] [manual]
<P>
<B>fpm</B> <I>help</I> [fortran|fortran_manual][FORTRAN_INTRINSIC_NAME]
</BLOCKQUOTE>
<A name=39>

     <H3>DESCRIPTION</H3>

</A>
<BLOCKQUOTE>
The "<B>fpm</B> <I>help</I>" command is an alternative to the --<I>help</I> parameter
on the <B>fpm</B>(1) command and its subcommands.
</BLOCKQUOTE>
<A name=40>

     <H3>OPTIONS</H3>

</A>
<BLOCKQUOTE>
<TABLE cellpadding=3>
<TR valign=top><TD width=6% nowrap>
<B></B><I>NAME</I>(<I>s</I>) </TD><TD valign=bottom>
A list of topic names to display. All the subcommands
have their own page (<I>new</I>, <I>build</I>, <I>run</I>, <I>test</I>, &#46;&#46;&#46;).
<P>
The special name "<I>manual</I>" displays all the <B>fpm</B>(1)
built-in documentation.
<P>
The default is to display <I>help</I> for the <B>fpm</B>(1) command
itself.
</TD></TR>
<TR valign=top><TD colspan=2>
<B></B><B>INTRINSIC</B>(<I>s</I>) </TD></TR><TR valign=top><TD width=6%>&nbsp;</TD><TD>
In addition, Fortran intrinsics can be described.
The special name "fortran" prints a list of available
topics. "fortran_manual" displays all the built-in
fortran documentation. Entries should be in
uppercase to avoid conflicts with <B>fpm</B>(1) topics;
but can be in lowercase if there is no conflict.
</TD></TR>
<TR></TR></TABLE></BLOCKQUOTE>
<A name=41>

     <H3>EXAMPLES</H3>

</A>
<BLOCKQUOTE>
Sample usage:
<P>
<PRE>
     fpm help           # general fpm(1) command help
     fpm help version   # show program version
     fpm help new       # display help for "new" subcommand
     fpm help manual    # All fpm(1) built-in documentation
<P>
</PRE>
</BLOCKQUOTE>
<A name=>

    <H4>&nbsp; &nbsp; FORTRAN INTRINSICS</H4>
</A>
<BLOCKQUOTE>
Additional general Fortran documentation
<P>
<PRE>
     fpm help SIN COS TAN    # selected Fortran Intrinsic help
     fpm help fortran        # index of Fortran documentation
     fpm help fortran_manual # all Fortran documentation
<P>
</PRE>
</BLOCKQUOTE>
<A name=42>

     <H3>SEE ALSO</H3>

</A>
<BLOCKQUOTE>
The <B>fpm</B>(1) home page at https://github.com/fortran-lang/<B>fpm</B>
</BLOCKQUOTE>
<A name=37>

     <H3>NAME</H3>

</A>
<BLOCKQUOTE>
<B>list</B>(1) - list summary of <B>fpm</B>(1) subcommands
<P>
</BLOCKQUOTE>
<A name=38>

     <H3>SYNOPSIS</H3>

</A>
<BLOCKQUOTE>
<B>fpm</B> <I>list</I> [-<I>list</I>]
<P>
<B>fpm</B> <I>list</I> --<I>help</I>|--<I>version</I>
</BLOCKQUOTE>
<A name=39>

     <H3>DESCRIPTION</H3>

</A>
<BLOCKQUOTE>
Display a short description for each <B>fpm</B>(1) subcommand.
</BLOCKQUOTE>
<A name=40>

     <H3>OPTIONS</H3>

</A>
<BLOCKQUOTE>
<TABLE cellpadding=3>
<TR valign=top><TD width=6% nowrap>
<B>--</B><I>list</I> </TD><TD valign=bottom>
display a <I>list</I> of command options as well. This is the
same output as generated by "<B>fpm</B> --<I>list</I>".
</TD></TR>
<TR></TR></TABLE></BLOCKQUOTE>
<A name=41>

     <H3>EXAMPLES</H3>

</A>
<BLOCKQUOTE>
display a short <I>list</I> of <B>fpm</B>(1) subcommands
<P>
<PRE>
  fpm list
  fpm --list
<P>
</PRE>
</BLOCKQUOTE>
<A name=42>

     <H3>SEE ALSO</H3>

</A>
<BLOCKQUOTE>
The <B>fpm</B>(1) home page at https://github.com/fortran-lang/<B>fpm</B>
<P>
<PRE>
   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
   OS Type:     Linux
</PRE>
</BLOCKQUOTE>
<P><HR>
<TABLE width=100%><TR> <TD width=33%><I></I></TD> <TD width=33% align=center>untitled ()</TD> <TD align=right width=33%><I>October 17, 2020</I></TD> </TR></TABLE><FONT SIZE=-1>Generated by <A HREF="http://www.squarebox.co.uk/download/manServer.shtml">manServer 1.08</A> from x.1 using man macros.</FONT>
<br><br><center><img src="images/x.1.gif"></center>
</div>
</div>
</body>
</HTML>