whitespace

This commit is contained in:
Paul Reeves 2023-06-15 08:30:38 +02:00
parent 0d18928101
commit 45ebbce139
1 changed files with 33 additions and 25 deletions

View File

@ -102,22 +102,26 @@ cbp2make --global -in project.cbp -out Makefile
Usage syntax:
Generate makefile:
cbp2make -in <project_file> [-cfg <configuration>] [-out <makefile>]
[-unix] [-windows] [-mac] [--all-os] [-targets "<target1>[,<target2>[, ...]]"]
[--flat-objects] [--flat-objpath] [--wrap-objects] [--wrap-options]
[--with-deps] [--keep-objdir] [--keep-outdir] [--target-case keep|lower|upper]
[--macros-case keep|lower|upper] [--quote-path auto|never|always]
cbp2make -list -in <project_file_list> [-cfg <configuration>]
[-unix] [-windows] [-mac] [--all-os] [-targets "<target1>[,<target2>[, ...]]"]
[--flat-objects] [--flat-objpath] [--wrap-objects] [--wrap-options]
[--with-deps] [--keep-objdir] [--keep-outdir] [--target-case keep|lower|upper]
[--macros-case keep|lower|upper] [--quote-path auto|never|always]
Manage toolchains:
cbp2make --config toolchain --add [-unix|-windows|-mac] -chain <toolchain>
cbp2make --config toolchain --remove [-unix|-windows|-mac] -chain <toolchain>
Manage build tools:
cbp2make --config tool --add [-unix|-windows|-mac] -chain <toolchain>
-tool <tool> -type <type> <tool options>
cbp2make --config tool --remove [-unix|-windows|-mac] -chain <toolchain>
@ -126,12 +130,15 @@ Usage syntax:
Tool types: pp=preprocessor as=assembler cc=compiler rc=resource compiler
sl=static linker dl=dynamic linker el=executable linker
nl=native linker
Tool options (common):
-desc <description> -program <executable> -command <command_template>
-mkv <make_variable> -srcext <source_extensions> -outext <output_extension>
-quotepath <yes|no> -fullpath <yes|no> -unixpath <yes|no>
Tool options (compiler):
-incsw <include_switch> -defsw <define_switch> -deps <yes|no>
Tool options (linker):
-ldsw <library_dir_switch> -llsw <link_library_switch> -lpfx <library_prefix>
-lext <library_extension> -objext <object_extension> -lflat <yes|no>
@ -155,36 +162,37 @@ Usage syntax:
cbp2make --config show
Common options:
cbp2make --local // use configuration from current directory
cbp2make --global // use configuration from home directory
cbp2make --verbose // show project information
cbp2make --quiet // hide all messages
cbp2make --help // display this message
cbp2make --version // display version information
cbp2make --local // use configuration from current directory
cbp2make --global // use configuration from home directory
cbp2make --verbose // show project information
cbp2make --quiet // hide all messages
cbp2make --help // display this message
cbp2make --version // display version information
```
## Options
''Makefile generation''
`-in <project_file>` // specifies an input file or a list of files;
`-cfg <configuration>` // specifies a configuration file, see also "--local" and "--global" options;
`-out <makefile>` // specifies the name of a makefile or a list of makefiles;
`-unix` // enables Unix / Linux compatible makefile generation;
`-windows` // enables Windows compatible makefile generation;
`-mac` // enables Macintosh compatible makefile generation;
`--all-os` // enables all target platforms at once;
`-targets "<target1>\[,<target2>\[, ...\]\]"` // specifies the only build targets that a makefile will be made for;
`--flat-objects` // forces "flat" names for object files with limited character set;
`--flat-objpath` // forces "flat" paths for object files with no subdirectories;
`--wrap-objects` // allows to use multiline lists of objects which makes a makefile easier to read;
`--wrap-options` // allows to use multiline macros;
`--with-deps` // allows a built-in dependency scanner for C/C++ projects;
`--keep-objdir` // disables command that erase directories for object files in 'clean' target;
`--keep-outdir` // disables command that erase directory for an output binary file in 'clean' target;
`--target-case \[keep|lower|upper\]` // specifies style for makefile targets;
##### Makefile generation
```bash
-in <project_file> # specifies an input file or a list of files
-cfg <configuration> # specifies a configuration file, see also "--local" and "--global" options
-out <makefile> # specifies the name of a makefile or a list of makefiles
-unix # enables Unix / Linux compatible makefile generation
-windows # enables Windows compatible makefile generation
-mac # enables Macintosh compatible makefile generation
--all-os # enables all target platforms at once
-targets "<target1>[,<target2>[, ...]]" # specifies the only build targets that a makefile will be made for
--flat-objects # forces "flat" names for object files with limited character set
--flat-objpath # forces "flat" paths for object files with no subdirectories
--wrap-objects # allows to use multiline lists of objects which makes a makefile easier to read
--wrap-options # allows to use multiline macros
--with-deps # allows a built-in dependency scanner for C/C++ projects
--keep-objdir # disables command that erase directories for object files in 'clean' target
--keep-outdir # disables command that erase directory for an output binary file in 'clean' target
--target-case [keep|lower|upper] # specifies style for makefile targets
```
## Examples