5a2a287752
* *
* partial sync with the 3.4 fork codebase. These are the things
synces for the most part:
- copyright headers
- grammar/typos in comments and some readmes
- comment/whitespace/decorations
- variable scoping in C files
- DO CASE/SWITCH and some other alternate syntax usage
- minimal amount of human readable text in strings
- minor code updates
- HB_TRACE() void * casts for pointers and few other changes to
avoid C compiler warnings
- various other, minor code cleanups
- only Harbour/C code/headers were touched in src, utils, contrib,
include. No 3rd party code, no make files, and with just a few
exceptions, no 'tests' code was touched.
- certain components were not touched were 3.4 diverged too much
already, like f.e. hbmk2, hbssl, hbcurl, hbexpat
- the goal was that no actual program logic should be altered by
these changes. Except some possible minor exceptions, any such
change is probably a bug in this patch.
It's a massive patch, if you find anything broken after it, please
open an Issue with the details. Build test was done on macOS.
The goal is make it easier to see what actual code/logic was changed
in 3.4 compared to 3.2 and to make patches easier to apply in both
ways.
48 lines
1.3 KiB
Groff
48 lines
1.3 KiB
Groff
.TH HBPP 1
|
|
|
|
.SH NAME
|
|
hbpp \- Harbour Preprocessor
|
|
|
|
.SH SYNOPSIS
|
|
.B hbpp
|
|
.RI \fR\fI<file\fP[\fR\fI.prg\fP]\fR\fI>\fP
|
|
[
|
|
.I options
|
|
]
|
|
|
|
.SH DESCRIPTION
|
|
\fBhbpp\fP is fully functional standalone Harbour preprocessor
|
|
which can be used to preprocess any files but also to generate
|
|
C source code with preprocesor rules defined in given files.
|
|
|
|
.SH OPTIONS
|
|
.IP "\fB\-d\fR\fI<id>\fP[\fB=\fR\fI<val>\fP]" 16
|
|
#define \fR\fI<id>\fP
|
|
.IP "\fB-e\fP[\fR\fI<func>\fP]" 16
|
|
use \fR\fI<func>\fP as entry function in generated .c PP rules
|
|
.IP "\fB-i\fR\fI<path>\fP" 16
|
|
add #include file search path
|
|
.IP "\fB-u\fP[\fR\fI<file>\fP]" 16
|
|
use command def set in \fR\fI<file>\fP (or none)
|
|
.IP "\fB-c\fP[\fR\fI<file>\fP]" 16
|
|
look for ChangeLog file to extract version information
|
|
.IP "\fB-o\fR\fI<file>\fP" 16
|
|
creates .c file with PP rules
|
|
.IP "\fB-v\fR\fI<file>\fP" 16
|
|
creates .h file with version information
|
|
.IP "\fB-w\fP" 16
|
|
write preprocessed (.ppo) file
|
|
.IP "\fB-q\fP[\fB012\fP]" 16
|
|
disable information messages
|
|
.PP
|
|
If neither -o nor -v is specified then -w is default action.
|
|
|
|
.SH "ENVIRONMENT VARIABLES"
|
|
.IP "\fBINCLUDE\fR"
|
|
The value of \fB\s-1INCLUDE\s0\fR is a colon-separated list of
|
|
directories, much like shell's \fB\s-1PATH\s0\fR. It's used by
|
|
\fBhbpp\fR as default search paths for included files.
|
|
|
|
.SH AUTHOR
|
|
Przemyslaw Czerpak, The Harbour Project
|