summaryrefslogtreecommitdiff
path: root/bin/MakeProjectCreator/USAGE
blob: e66edecf08a0ec63864802d1438acfc63fdf1e9e (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
Running the Workspace Generator
-------------------------------

The most common way to use the Make Project Creator is to run the
workspace generator (mwc.pl).  This script will generate projects and a
single workspace that contains the generated projects.  If no input file
(.mwc file) is specified, it will recurse into the directory in which the
script was started.  It looks for .mpc files and generates a project or
projects for each one found.


Usage: mwc.pl [-global <file>] [-include <directory>]
              [-ti <dll | lib | dll_exe | lib_exe>:<file>]
              [-template <file>] [-dynamic_only] [-static_only]
              [-type <bor | em3 | gnu | nma | va4 | vc6 | vc7>]
              [files]

       -global       Specifies the global input file.  Values stored
                     within this file are applied to all projects.
       -include      Specifies a directory to search when looking for base
                     projects, template input files and templates.  This
                     option can be used multiple times to add directories.
       -ti           Specifies the template input file (with no extension)
                     for the specific type as shown above
                     (ex. -ti dll_exe:vc8exe)
       -template     Specifies the template name (with no extension).
       -dynamic_only Specifies that only dynamic projects will be generated.
       -static_only  Specifies that only static projects will be generated.
       -type         Specifies the type of project file to generate.  This
                     option can be used multiple times to generate multiple
                     types.

The default global input file
(ACE_wrappers/bin/MakeProjectCreator/config/global.mpb) is used if -global
is not specified on the command line.

Two include directories are used by default
(ACE_wrappers/bin/MakeProjectCreator/config and
ACE_wrappers/bin/MakeProjectCreator/templates) if -include is not used.

Each project creator has a default template input file for each type of
project (dll_exe, lib_exe, dll, lib).  You can override the default template
input file name with the -ti option.  The file must have a 'mpt' extension
and must reside within the include search directories.  NOTE: the 'lib' and
the 'lib_exe' template input files are only used if the project creator makes
a separate project file for dynamic libraries and static libraries.

The -template option is used to override the default template name.  This
file should have a .mpd extension and sit in one of the include search
directores.  NOTE: The -template option overrides the template file for all
types specified.

The -dynamic_only option can be used to avoid generating static project
files.  This currently only applies to the vc6 type.

The -static_only option can be used to avoid generating dynamic project
files.  This currently only applies to the vc6 type.

The -type option can be used multiple times on the same command line to
generate projects of different types per mpc file.  NOTE: The -ti option
overrides the template input file for all types specified.


Running only the Project Generator
----------------------------------

Most of what is stated about the Workspace Generator applies to the Project
Generator except that it only generates projects.  If an input file (.mpc
file) is not provided, the project creator will attempt to create a default
project in the directory from which the script was started.


Usage: mpc.pl [-global <file>] [-include <directory>]
              [-ti <dll | lib | dll_exe | lib_exe>:<file>]
              [-template <file>] [-dynamic_only] [-static_only]
              [-type <bor | em3 | ghs | gnu | nma | va4 | vc6 | vc7>]
              [files]

       -global       Specifies the global input file.  Values stored
                     within this file are applied to all projects.
       -include      Specifies a directory to search when looking for base
                     projects, template input files and templates.  This
                     option can be used multiple times to add directories.
       -ti           Specifies the template input file (with no extension)
                     for the specific type as shown above
                     (ex. -ti dll_exe:vc8exe)
       -template     Specifies the template name (with no extension).
       -dynamic_only Specifies that only dynamic projects will be generated.
       -static_only  Specifies that only static projects will be generated.
       -type         Specifies the type of project file to generate.  This
                     option can be used multiple times to generate multiple
                     types.