...
Applies to: v10
v10 changes to this chapter:
LAYER.Hand2030.H(the Btrieve-name compatibility macros this chapter relies on) are not in the shared v10inc/(a project-localLAYER.Hexists in the ported modules, e.g.src/isv/mjwmut/), so onlydfa*()names work unless you copy it; whether theGALPORTrenames still compile against v10 is unverified. TheEXPORT_*macros changed signature (chapter 29, section 29.5),BBSVERis nowBBSVERS(server.h:61), andffblk.ff_nameis 260 bytes (FIOAPI.H:44). Theconst CHAR *section of this chapter is the WG3.2 view; the v10 version, with the v10 prototypes, is chapter 29, section 29.4.
Applies to: WG3.x
Editor's note: this chapter is new. It is not part of the Developer's Addendum for Worldgroup 3.12 (
wg312dev); the addendum is silent on porting. It collects, for the WG3 layer, what happens when the WG1/WG2 source and the code printed in chapters 1-19 are built against the WG3.2 headers (/mnt/b/WG/WGDEV/INC). The sources are the kit utilityGALPORT.C(SRC/devutils/galport, identical to the copy in this repository), the headers themselves, and the header-level deltas inanalysis/deltas. Everyfile:linecitation is to the WG3.2 headers unless it says "WG2" (/mnt/b/WG/WGSERV2/SRC). The symbols in this chapter were checked against the headers (see CROSSCHECK.md).
...
GALPORT.EXE ships in \WGDEV\BIN; the addendum's list of new utilities (chapter 21) does not describe it. Its banner reads "developer's utility to help developers port their add-on source code from Worldgroup v2.x to Worldgroup v3.x" (C. Robert, 4/27/96, $Revision: 3 $). Usage:
| Code Block |
|---|
GALPORT filename |
The file is rewritten in place (through a work file GALPORT.OUT). The rules it follows, taken from the source:
...
- Show every read-only string parameter as
const CHAR *; leaveCHAR *only where the table above says the engine writes. - For each function in the first table, the receiving variable is
const CHAR *, or the result is copied withstlcpy(buf, p, sizeof buf)(GCOMM.H:409) before being edited. getfnm()returnsNULLif the file does not exist (otherv3tov32 changes.txt).skpwht(),getasc()andfnmcse()are the only places where a string literal can still crash a module.GALPORTnever touches constness: it renameschartoCHAR, soconst char *becomesconst CHAR *correctly,unsigned char *becomesCHAR *(the defect noted above), and noconstis added anywhere. The 3.2 prototypes must be compared by hand.
...
Previous: Major BBS v10: 27 Date and Time API | Contents | Next: Major BBS v10: 29 Major BBS v10