File: usage.cc

package info (click to toggle)
icmake 13.05.01-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 7,132 kB
  • sloc: cpp: 11,595; fortran: 883; makefile: 853; sh: 546; pascal: 342
file content (56 lines) | stat: -rw-r--r-- 2,733 bytes parent folder | download | duplicates (2)
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
//                     usage.cc

#include "main.ih"

namespace {
char const info1[] = R"_( [options] jobs [compiler]
Where:
    [options] - optional arguments (short options between parentheses):
        --help (-h)             - provide this help
        --nr (-n)               - show the thread number compiling a source
                                  file (not used when -qq is specified)
        --quiet (-q)            - only show the source filenames. Use twice to
                                  suppress listing the sourcefiles. 
        --threads (-t) nThreads - number of compilation threads
                                  (default )_";

char const info2[] = R"_( threads)
        --version (-v)          - show version information and terminate

    jobs     - the name of a file containing the specs of the files to
               compile. Specs start with lines like ': support tmp/o 5' where
               the 2nd element specifies the location of the source files; the
               3rd element specifies the destination directory of the compiled
               files; and the 4th element specifies the prefix to add in front
               of the compiled object files. The names of the source files to
               compile follow next. Non-existing destination directories are
               created. 

    compiler - this argument is optional. By default the following
               specification is used (all on one line)
           g++ -c -o $2 ${ICMAKE_CPPSTD} --Wall -Werror $1
              In this specification '$1' is replaced by the location of the
               source file to compile and '$2' is replaced by the location of
               the compiled object file. If the environment variable
               'ICMAKE_CPPSTD' is defined (specifying the bf(C++) standard to
               use, e.g., 'ICMAKE_CPPSTD=--std=c++26') then its value replaces
               '${ICMAKE_CPPSTD}' in the specification.
              Alternatively, the command compiling source files can be
               provided as second command-line argument (in which case it
               should be quoted), or the second command-line argument can be
               'f:file', where 'file' is the name of a file whose first line
               contains the specification of the command compiling source
               files (which must specify '$1' and '$2' and optionally
               '$ICMAKE_CPPSTD').
              The 'PATH' environment variable is used to locate
               the compiler; the compiler's absolute path can also be used.
)_";

}

void usage(std::string const &progname)
{
    Tools::usageTop(progname) << info1 << thread::hardware_concurrency() <<
                             info2;
}