read.me
来自「开放源码的编译器open watcom 1.6.0版的源代码」· ME 代码 · 共 675 行 · 第 1/2 页
ME
675 行
CAUSEWAY DOS EXTENDER SOURCE FILE DOCUMENTATION
GENERAL AND LEGAL NOTES
As of January 9, 2000, Michael Devore surrendered all his
copyrights for CauseWay for Watcom C/C++ & Assembly Language and
released it to the public domain. Runtime libraries for CauseWay
for Clipper 5, CauseWay for Clarion 2.1, and the trap file
source for Watcom retain their separate third party copyrights
or are covered by nondisclosure agreements and are not part of
the release of the CauseWay software to public domain.
There is no support or warranty whatsoever for the released
files. Under no conditions will Michael Devore be held liable
for damages arising out of use of, or inability to use, the
CauseWay files. You may send Devore Software & Consulting e-mail
to freesource@devoresoftware.com with any questions, but those
questions will, of necessity, have lower priority than paid
customer/client inquiries and development works in progress.
Such questions may be answered only after a long delay or not at
all. But, depending on workload, the nature and framing of the
request, and ineffable intangibles, it is within the realm of
possibility that they will be answered immediately. The small
minority of individuals who may feel that they deserve priority
attention by calling, faxing, or sending questions to other
e-mail addresses will probably be disappointed in the results,
at best.
This is a true public domain release. It is not Yet Another
Open Source licensing arrangement. You as an individual or as a
business entity may use the binary and source files in whatever
manner you desire, INCLUDING for commercial purposes, without
explicit credit or compensation to Michael Devore or Devore
Software & Consulting. If you make a million off the code, toss
a few thousand at a deserving charity. Or don't, it's your
choice.
And yes, this permission extends to any 386 DOS extender
developer who has previously claimed the title "fastest" or
"best" or "hot-damndest" (actually I've never heard that one)
extender by virtue of a mix of carefully chosen benchmarks,
feature sets, or chutzpah. It even includes 286 DOS extender
developers who may have enjoyed having their products grossly
hyped to live a lifespan far past normal for their technical
obsolescence. If any vendor can use any of the released code
here to help their customers or others, please have at it.
COMMENTS ON THE SOURCE CODE
The code for what was to become CauseWay had begun being written
before 1993 and remained under development through the end of
1999. CauseWay had two main programmers and several others were
peripherally involved. Obviously, the operating system and
programming landscape changed greatly in that time. Some
now-common specifications were still in flux or difficult to
acquire when the project began. Given the longer than
seven-year timespan over which the DOS extender was developed,
the programming team's learning curves, the what had been
cutting-edge technology, and the substantial codebase involved,
there doubtless remain a few generally minor operational errors
and numerous examples of what is now considered poor code or
technique. On the other hand, CauseWay-extended applications
have been and remain in use by millions of machines error-free,
so things have worked out pretty well. However, please keep the
historic perspective in mind if you choose to use or study the
source code.
The source code for the WL32 linker is in a separate
distribution. Look for WL32SRC.ZIP.
The source contains a few scattered swear words about
programming conditions as well as mild insults about drivers or
software that really annoyed us when changes were being made
(because they required us to make the changes). I think most
people should be able to handle the four "shit"'s, the two
"stupid"'s, and the one "silly" found during preparation for
release. Should take two minutes to edit them out if they
really bother you.
Read the READ.ME plus the Web FAQ, study well, and think hard
before assuming direct contact is vital. For those who wish to
modify or re-use the source code, please remember that messing
about with externally created source to a commercial DOS
extender and linker is not for the faint-hearted nor for those
not extremely well-versed in the arts of assembly language and
protected mode.
The copious misspellings in source code comments aren't Michael
Devore's. I had to say that.
If you wish to rebuild the source files, rather than use the
current binary release (found in CW349BIN.ZIP), you may use the
MAKEFILE's and batch files include in the distribution.
The original files were assembled with MASM 6.12 or TASM 2.5.
Linkers used are either Microsoft's Link (5.x version), WL32, or
CWL (internal CauseWay linker).
DISTRIBUTION FILES
Following is the full directory file list of the CauseWay DOS
extender.
DIRECTORY OF \CAUSEWAY\SOURCE\ALL
Makefiles for various CauseWay settings, e.g. NOVMMAK will make
a CauseWay with NOVM (no virtual memory) permanently burned-in
instead of requiring SET CAUSEWAY=NOVM. Fairly
self-explanatory.
09/10/99 08:33A 309 BGNOVMAK
10/29/99 03:43A 319 BNVMXMAK
09/21/98 05:02A 297 DEBUGMAK
06/09/97 11:54A 306 MAKEFILE
01/17/96 04:57P 266 NOCOMP
09/27/98 10:28P 298 NOEXMAK
10/28/98 12:53P 311 NOEXVMMK
07/15/98 11:20P 298 NOVMMAK
The main CauseWay DOS extender source files:
11/02/99 03:20A 170,538 API.ASM
12/30/99 11:29P 99,424 CW32.ASM
03/25/97 01:25A 7,492 DECODE_C.ASM
02/13/99 07:12A 45,746 EXCEPTN.ASM
05/04/97 05:49A 16,287 INT10H.ASM
05/20/98 04:08P 42,941 INT21H.ASM
01/24/96 01:44A 13,621 INT33H.ASM
04/05/99 09:34P 35,756 INTERRUP.ASM
06/13/95 08:43P 8,652 LDT.ASM
06/13/96 03:13A 50,855 MEMORY.ASM
11/15/99 01:27P 105,742 RAW&VCPI.ASM
Batch files which drive the MAKEFILE process. E.BAT, for
example is standard build, which D.BAT builds DEBUG version, and
BIG1NOVM.BAT builds a version with BIG1 and NOVM settings
permanently set.
03/27/94 09:55A 15 A.BAT
09/21/98 03:29A 65 B.BAT
09/10/99 02:40P 73 BIG1NOVM.BAT
10/29/99 03:42A 73 BIGNOVMX.BAT
06/11/98 10:50P 67 D.BAT
12/24/99 06:33A 50 E.BAT
01/17/96 04:57P 24 F.BAT
09/27/98 10:26P 68 NOEX.BAT
10/28/98 09:03P 111 NOEXVM.BAT
07/15/98 11:18P 68 NOVM.BAT
Definitions files. Actually, don't remember if these are still
used somewhere.
03/04/95 04:33P 348 CW32.DEF
03/06/95 06:55P 319 CW32EXP.DEF
Various executables. CW349 it a utility to update executables
to latest extender or otherwise change CauseWay settings. CWC
is the compression, CWD is the CauseWay debugger stub.
CWSTUB.EXE is used by Watcom for CauseWay extender. EXESPLIT
splits off the extender image from the extended application
image into FILE1.DSK (extender) and FILE2.DSK (application).
You can then use DOS command COPY /B to copy a different
extender image onto the application image. LE23P is the Watcom
LE to 3P format converter.
12/30/99 11:30P 58,241 CW349.EXE
01/05/00 05:11P 55,625 CWC.EXE
01/17/96 05:19P 2,399 CWD.EXE
12/30/99 11:30P 47,088 CWSTUB.EXE
12/27/93 12:36P 35,307 EXESPLIT.EXE
01/05/00 05:56P 55,915 LE23P.EXE
Assembly Language include files:
03/04/95 09:00P 30,753 CW.INC
03/04/95 04:36P 175 CW32.INC
12/04/93 12:32A 918 GENERAL.INC
09/21/98 03:29A 9,955 STRUCS.INC
LIB file use for DLLs:
03/06/95 06:55P 2,065 CW32.LIB
This documentation file:
01/09/00 xx:xxx xx,xxx READ.ME
Main CauseWay debugger binary file, launched by CWD.EXE. The
debugger is probably the crudest of all CauseWay utilities. It
was written quickly to get a decent testing and debugging
platform and was never really spiffed up after things got
running reasonably well.
12/24/99 06:50A 215,948 CWD.OVL
DIRECTORY OF \CAUSEWAY\SOURCE\ALL\CW
Assembly Language source used to build CW[349].EXE which can
update CauseWay DOS extender, along with build file support:
07/06/93 07:34A 4,461 COMMAND.ASM
06/11/96 03:21A 92,342 CW.ASM
01/27/96 09:49A 6,563 CWMAKE.ASM
09/15/93 11:39P 7,542 FILES.ASM
06/14/94 06:27P 460 PRINT.ASM
08/04/93 12:24P 14 A.BAT
06/11/98 12:35A 288 D.BAT
02/27/96 04:20P 197 E.BAT
09/01/93 10:13P 1,530 CW.CFG
01/27/96 09:49A 1,336 CWMAKE.EXE
08/24/93 04:36P 4,471 GENERAL.INC
DIRECTORY OF \CAUSEWAY\SOURCE\ALL\CWC
CWC CauseWay compressor utility source and support files:
10/09/95 10:00P 219 MAKEFILE
03/29/96 08:17A 1,461 COPYSTUB.ASM
06/03/97 03:13P 52,986 CWC.ASM
03/29/96 07:22A 4,756 DECSTUB.ASM
11/18/95 04:33A 20 A.BAT
03/29/96 08:19A 1,167 COPYSTUB.COM
03/29/96 08:19A 461 DECSTUB.COM
11/17/95 05:59A 3,131 MAKEASM.COM
06/03/97 02:41P 1,679 COPYSTUB.EXE
06/04/97 03:39P 55,312 CWC.EXE
06/03/97 02:41P 973 DECSTUB.EXE
06/03/97 02:41P 2,856 COPYSTUB.INC
03/04/95 09:00P 30,753 CW.INC
11/10/94 10:10P 71,275 CWLIB.INC
06/03/97 02:41P 1,731 DECSTUB.INC
03/29/96 07:23A 9,553 STRUCS.INC
03/30/95 04:15P 159,367 CW.LIB
DIRECTORY OF \CAUSEWAY\SOURCE\ALL\CWD
CWD CauseWay debugger utility source and support files. As
noted previously, the debugger is probably the crudest of all
CauseWay utilities. It was written quickly to get a decent
testing and debugging platform and was never really spiffed up
after things got running reasonably well.
11/19/96 01:28A 370 MAKEFILE
07/08/97 01:12A 372 WL
01/17/96 05:19P 11,174 CWD.ASM
05/20/98 04:10P 240,058 CWD-OVL.ASM
07/08/97 09:44P 157,249 DISAS.ASM
07/10/95 03:50P 1,573 EQUATES.ASM
07/10/95 03:53P 26,394 EVALUATE.ASM
07/10/95 03:54P 7,394 FILES.ASM
11/20/96 06:33A 13,518 FPU.ASM
11/30/95 03:53P 24,306 GENERR.ASM
07/10/95 03:58P 469 GETKEYS.ASM
11/16/96 02:56A 453 ISFPU.ASM
05/14/93 02:00P 2,615 MACROS.ASM
11/18/96 01:43A 446 PRINT.ASM
11/30/95 03:23P 84,365 WIN.ASM
08/04/93 12:24P 14 A.BAT
07/08/97 01:11A 20 W.BAT
11/02/94 12:03A 916 CWD.CFG
01/17/96 05:19P 2,399 CWD.EXE
11/08/95 04:56A 78,088 CWL.EXE
07/10/95 03:50P 1,750 DISAS.INC
01/30/94 04:16P 1,110 MACROS.INC
05/20/98 04:11P 215,724 CWD.OVL
DIRECTORY OF \CAUSEWAY\SOURCE\ALL\CWL
CWL, CauseWay linker source and support files. Very basic
linker, only used internally to bootstrap and test the CauseWay
system while the WL32 linker was being built.
03/07/95 07:46P 199,976 CWL.ASM
10/09/95 10:08P 50 A.BAT
03/28/95 10:58P 6,142 CWL.DOC
11/08/95 04:56A 78,088 CWL.EXE
03/07/95 07:09P 5,909 CWL.INC
DIRECTORY OF \CAUSEWAY\SOURCE\ALL\CWLIB
Binary and include file of utility library, used for a couple of
CauseWay utilities.
11/10/94 10:10P 71,275 CWLIB.INC
03/30/95 04:15P 159,367 CW.LIB
DIRECTORY OF \CAUSEWAY\SOURCE\ALL\CWLIB\CW.ASM
Source and support files for the utility library. This was a
general utility library written for other projects, so many of
the modules listed here aren't used by CauseWay at all. No
support at all on this one, it's strictly an at own risk
collection of old source code.
11/10/94 09:23P 2,371 MAKEFILE
01/31/94 07:55P 487 _APNDSTR.ASM
01/31/94 07:55P 343 _BEEP.ASM
01/31/94 07:55P 529 _BIN2DEC.ASM
02/28/94 11:26A 604 _BIN2HEX.ASM
01/31/94 08:06P 446 _BORD.ASM
01/31/94 07:55P 1,472 _BUFFILE.ASM
01/31/94 07:55P 369 _CLOSEF.ASM
01/31/94 08:07P 528 _CLOSEW.ASM
01/31/94 07:55P 1,100 _COMMAND.ASM
01/31/94 07:55P 481 _COPYSTR.ASM
02/01/94 11:27A 657 _CRBTMP.ASM
01/31/94 07:56P 483 _CREATEF.ASM
01/31/94 07:56P 356 _DELAY.ASM
01/31/94 07:56P 502 _DELETEF.ASM
02/07/94 09:53P 814 _DLGBTWN.ASM
01/31/94 09:43P 623 _DLGDRAW.ASM
01/31/94 09:52P 582 _DLGGTBD.ASM
01/31/94 10:01P 580 _DLGGTBW.ASM
01/31/94 10:06P 587 _DLGGTBX.ASM
01/31/94 10:17P 582 _DLGGTBY.ASM
01/31/94 10:23P 496 _DLGGTD.ASM
01/31/94 10:30P 576 _DLGGTST.ASM
01/31/94 10:36P 494 _DLGGTW.ASM
01/31/94 10:42P 631 _DLGSTST.ASM
01/31/94 10:52P 871 _DLGWHCH.ASM
02/07/94 09:37P 2,084 _FILESEL.ASM
01/31/94 07:56P 915 _FLMKNM.ASM
01/31/94 07:56P 369 _FREE.ASM
01/31/94 07:56P 339 _GETDRV.ASM
01/31/94 07:56P 642 _GETDRVS.ASM
01/31/94 07:56P 411 _GETKEY.ASM
01/31/94 07:56P 423 _GETPATH.ASM
01/31/94 10:58P 598 _LDFONT.ASM
02/01/94 12:12P 722 _LDGIF.ASM
⌨️ 快捷键说明
复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?