Trailing-Edge
-
PDP-10 Archives
-
BB-4172H-BM
-
4-1-documentation/maklib.doc
There are 22 other files named maklib.doc in the archive. Click here to see a list.
MKL2B.DOC -- Changes from V2A(67) TO V2B(104)
February 1981
COPYRIGHT (C) 1975,1978,1979,1980,1981 BY
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS.
THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED
ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER
COPIES THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY
OTHER PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY
TRANSFERRED.
THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE
AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT
CORPORATION.
DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL.
MKL2B.DOC Page 2
MAKLIB.DOC -- Changes from V2A(67) to V2B(104)
February 1981
1.0 SUMMARY
Version 2B is a maintenance release of MAKLIB and contains bug fixes
and minor enhancements.
MAKLIB should be compiled with MACRO V53A or later. The latest
distributed copies of MACTEN.UNV, UUOSYM.UNV, SCNMAC.UNV, HELPER.REL,
SCAN.REL, and WILD.REL should be used. In addition, LINK 4A(1220) or
a later version should be used.
2.0 EXTERNAL CHANGES
1. No existing commands or actions have been changed.
2. If one of the files to be appended is missing, MAKLIB will
continue processing after displaying the ?MKLNPC error
message. This message has been changed from a warning to a
fatal error.
3. The following error messages have been changed to make them
more readable and meaningful.
OLD: ?MKLTMN Too many module names
NEW: ?MKLTMN Too many module names .. stopped at [MODULE]
OLD: ?MKLBDA Bad .DATE argument
NEW: ?MKLBDA Bad .DATE argument for edit: [EDIT]
OLD: %MKLNPC No program code was found for module
NEW: ?MKLNPC No program code was found for module in
edit [EDIT]
3.0 KNOWN BUGS AND DEFICIENCIES
None.
MKL2B.DOC Page 3
4.0 INSTALLATION INSTRUCTIONS
The following is for informational purposes only. The feature test
switch FTBPT has been added. All of the code to facilitate binary
patching is under this conditional, which is distributed as "ON"
(non-zero) in the field-image version. Since the code for the BPT
comprises about 80% of MAKLIB, turning this switch off if the BPT is
not needed can save some memory space.
Manual loading of SCAN, WILD and HELPER is no longer necessary as the
.REQUEST and .REQUIRE pseudo-ops have been added to facilitate
automatic requests for these routines.
5.0 INTERNAL CHANGES
The following is for informational purposes only. Much addition and
re-organization of the program was done to enable the addition of the
BPT. the register allocation and much of the I/O has been re-written.
In addition, a small loader and a large MACRO assembler have been
added to allow binary patching. Also, a module has been added to
allow MAKLIB to do internal tests of its own routines. This is a
debugging feature, and is not present in the field-image version.
EDIT SPR COMMENT
70 22997 Allow standard SCAN/WILD switches (i.e. SINCE,
BEFORE, ETC.) TO WORK.
71 27130 Fix indexing of block that is Exactly 200
(octal) words long.
72 24665 Have switch processing continue if one file not
found.
73 12886 Get right file name in NIO error message.
MKL2B.DOC Page 4
74 (NONE) Fix "ILL MEM REF" caused
by looking at an invalid polish pointer.
75 (NONE) Give an error message if the user tries to
remove an edit that has no code associated with
it.
76 (NONE) Give correct device in LOOKUP error message in
SWTDIS.
77 (NONE) Increase the number of modules that can be
specified on one command line from 20 to 100.
100 (NONE) Specify in the error message "Too many module
.." how far modules are being accepted by
clarifying the message "Too many module..
stopped at [module].
101 (NONE) Add edit number to the error message ?MKLBDA.
102 (NONE) Give Error Return If INSERT or ALTER pseudo-op
is used on the module with no code associated
with it.
103 (NONE) Display an error ?MKLIAL with correct EDIT
number.
104 30005 Print correct creation date on switches points
and list.
[End of MKL2B.DOC]
[MKL2A.DOC is appended as an integral part of MKL2B.DOC]
MKL2A.DOC Page 5
MKL2A.DOC -- Changes from V2(14) to V2A(63)
July 1978
1.0 SUMMARY
Version 2A is a maintenance release of MAKLIB and contains bug fixes
and minor enhancements.
MAKLIB should be compiled with MACRO V53A or later. The latest
distributed copies of MACTEN.UNV, UUOSYM.UNV, SCNMAC.UNV, HELPER.REL,
SCAN.REL, and WILD.REL should be used. In addition, to correctly load
programs containing MAKLIB binary fixes, a version of LINK with edit
454 must be used.
2.0 EXTERNAL CHANGES
None.
3.0 KNOWN BUGS AND DEFICIENCIES
The following restriction should be noted when creating FIX files for
use with the FIX command switch: Unconditional branch instructions
(JRST, JUMPA) should not be used as the reference line (code to match)
of a .INSERT pseudo-op with KEYWORD:AFTER. Attempts to do this will
result in patches which are unreachable.
4.0 INSTALLATION INSTRUCTIONS
Installation instructions follow in section 4 of MKL2.DOC which is
appended.
5.0 INTERNAL CHANGES
None.
[End of MKL2A.DOC]
[MKL2.DOC is appended as an integral part of MKL2A.DOC]
MKL2.DOC Page 6
MAKLIB.DOC -- Changes from V1(6) to V2(14)
JANUARY 1976
1.0 SUMMARY
The main reason for the release of MAKLIB V.2 is the addition of the
Binary Patching Tool. (BPT) The BPT was included to allow some level
of support for products distributed in relocatable binary format
rather than source level.
MAKLIB should be compiled with MACRO V50 or later. The latest
distributed copies of MACTEN.UNV, UUOSYM.UNV, SCNMAC.UNV, HELPER.REL
and WILD.REL should be used. (See MAKLIB.CTL). The version of SCAN
that MAKLIB uses is SCN7A, although any SCAN V7 is usable as long as
the appropriate changes are made to the MAKLIB source. In addition to
this, to correctly load programs containing MAKLIB binary fixes, a
version of LINK with edit 454 must be used.
2.0 EXTERNAL CHANGES
No existing commands or actions were changed. For a description of
the use of the BPT, refer to MAKLIB.HLP or MAKLIB.MAN. A more full
implementation of system-standard error messages is also part of this
release.
3.0 KNOWN BUGS AND DEFICIENCIES
The main use of the BPT will be for installation of DEC supplied
patches to products for which the sources are not available. The BPT
will work with REL files produced by MACRO V50 and BLISS10. The BPT
may not work with any code produced by a compiler using polish fixups
or internal fixups.
4.0 INSTALLATION INSTRUCTIONS
The feature test switch FTBPT has been added. All of the code to
facilitate binary patching is under this conditional, which is
distributed as "on" (non-zero) in the field-image version. Since the
code for the BPT comprises about 80% of MAKLIB, turning this switch
off if the BPT is not needed can save some memory space.
Manual loading of SCAN, WILD and HELPER is no longer necessary as the
.REQUEST and .REQUIRE pseudo-ops have been added to facilitate
automatic requests for these routines.
MKL2.DOC Page 7
5.0 INTERNAL CHANGES
Much addition and re-organization of the program was done to enable
the addition of the BPT. The register allocation and much of the IO
has been re-written. In addition, a small loader and a large MACRO
assembler have been added to allow binary patching. Also, a module
has been added to allow MAKLIB to do internal tests of its own
routines. This is a debugging feature, and is not present in the
field-image version.
[End of MKL2.DOC]
[MKL1.DOC is appended as an integral part of MKL2.DOC]
MKL1.DOC Page 8
MAKLIB.DOC -- V1(6)
July 1975
1.0 SUMMARY
MAKLIB is intended as an eventual replacement for FUDGE2.
This version has been tested under 5.07 and 6.01 as well as 6.02
monitors. It uses SCAN Version 7 and WILD Version 7.
MAKLIB.HLP describes the various commands to MAKLIB and their
functions. See FUDGE2 documentation in the Software Notebooks for a
description of indexing. MAKLIB is described in the SYSTEM COMMANDS
section of the Software Notebooks. See the SCAN documentation in the
Software Notebooks for information about command scanning.
2.0 EXTERNAL CHANGES
2.1 Differences from FUDGE2-2D
MAKLIB does not delete local symbols when indexing the library.
Command strings are ended by carriage return line feed.
3.0 KNOWN BUGS AND DEFICIENCIES
None.
4.0 INSTALLATION INSTRUCTIONS
Must be loaded with SCAN and WILD. See MAKLIB.CTL for details on
installation.
5.0 INTERNAL CHANGES
MAKLIB has been updated to recognize LINK block types 1000 to 1777 and
to handle ASCII text blocks.
Edit #
01 All switches except INDEX and INSERT are recognizable as one
letter abbreviations.
02 Issue correct error message for protection violation.
MKL1.DOC Page 9
03 Issue error messages for switches on output and for more than
one switch given with a stand-alone switch(INDEX,NOLOCAL).
04 Do not replace specified extension with .LST on LIST and
POINTS, but do fill it in as default.
05 Error messages for modules out of order made more specific.
06 Version number fixed.
6.0 SUGGESTIONS
None.
[End of MKL1.DOC]