@DATABASE 0066
@(C) "Copyright © Cloanto Italia srl"
@REM Part of The Kara Collection CD-ROM, by Cloanto ®
@FONT topaz.font 8
@WIDTH 74

@NODE Main "Personal Fonts Maker - H. PDM Program Messages"
@TOC O0O0/Main

@{B}H.         PDM Program Messages@{UB}

   This appendix lists (in alphabetical order) and explains the most
important messages of the Printer Driver Modifier, like the listing of the
Personal Fonts Maker messages, in appendix @{"G" LINK 0062/Main 1}. A more complete
description can be found in the referenced sections.


@{B}Content overflow in character...@{UB}   (D1B)
@{B}Content overflow in command...@{UB}   (D1C)

   The program has detected that the control sequence associated with the
specified character or commmand is too long to fit in the space reserved
for that character or command by the driver. This can only happen in the
"Fixed Locations" encoding mode. The error condition is detected when a
driver is saved or the definitions are checked. As described in section
@{"10.4" LINK 0014/Main 160} ("Save Definitions") it is always better to modify an original
printer driver, rather than one which has already been modified. Sections
@{"9.4.2" LINK 0010/Main 313} ("The Editing Gadget"), @{"10.2" LINK 0014/Main 34} ("Save Driver"), @{"10.6" LINK 0014/Main 220} ("Check
Definitions") and @{"11.5" LINK 0050/Main 161} ("Encoding Mode").


@{B}Definition overflow@{UB}   (D41)

   While loading a printer driver, the Printer Driver Modifier has
encountered a control sequence which is too large to be displayed and
edited in the program's string gadgets. Sections @{"1.9.6" LINK 0056/Main 519} ("String Gadgets")
and @{"10.1" LINK 0014/Main 10} ("Load Driver").


@{B}Error during file I/O@{UB}   (D20)

   During a load or save operation the Amiga operating system has issued
an error code. The Printer Driver Modifier cannot complete the operation.
Section @{"14.1" LINK 0051/Main 10} ("Problems with Disks").


@{B}Global character table overflow...@{UB}   (D3B)
@{B}Global command table overflow...@{UB}   (D3A)

   In the "Floating Locations" encoding mode (section @{"11.5.2" LINK 0050/Main 219}) the Printer
Driver Modifier stores the printer control codes one immediately after the
other. Whenever a control sequence is made shorter than the original
sequence stored in the printer driver, more memory becomes available for
the other codes. Two blocks of memory are used: one for the control
sequences associated with characters, and the other for printer commands.
The size of the blocks depends on the printer driver, and cannot be
increased by the Printer Driver Modifier. If too many control sequences
are made larger, but not enough other sequences are made shorter to create
room for the new codes, this error message is displayed. The message
indicates where the error has occurred (in the character or the command
section), and how many bytes in that section overflow (i.e. the bytes
which are in excess). Some bytes can be saved by disabling the "Strings on
Word Boundary" option (section @{"11.5.3" LINK 0050/Main 239}). As described in section @{"10.4" LINK 0014/Main 160}
("Save Definitions") additional space can be gained by editing an original
printer driver, rather than one which has already been modified. The error
condition is detected when a driver is saved or the definitions are
checked. Sections @{"9.4.2" LINK 0010/Main 313} ("The Editing Gadget"), @{"10.2" LINK 0014/Main 34} ("Save Driver"),
@{"10.6" LINK 0014/Main 220} ("Check Definitions") and @{"11.5" LINK 0050/Main 161} ("Encoding Mode").


@{B}Illegal code in character...@{UB}   (D27)

   A NOAV or DLAY code has been encountered in a control sequence
associated with a character. These codes can only be used in the control
sequences associated with printer commands (not characters). After this
error message is displayed, the cursor in the editing gadget appears over
the position where the error was detected. Section @{"9.4.2" LINK 0010/Main 313} ("The Editing
Gadget").


@{B}Illegal parameter in line...@{UB}   (D22)

   Reading a parameter file (section @{"10.3" LINK 0014/Main 57}, "Load Definitions"), the
parameter following a CHAR or COMM keyword falls outside the valid range.
The CHAR keyword accepts a parameter in the range from 160 to 255, while
the value following the COMM keyword must be in the range 0-75. These
codes are the same which are used in the "Number" gadget (section
@{"9.4.1" LINK 0010/Main 288}).


@{B}Illegal value in command...@{UB}   (D28)

   As explained in section @{"9.4.2" LINK 0010/Main 313} ("The Editing Gadget"), printer drivers
store the codes DLAY, NUL and NOAV internally, using the values 253, 254
and 255 (decimal). This means that the values from 253 to 255 are
reserved, and cannot be used in a control sequence associated with a
printer command. If one of the reserved codes is found in a control
sequence associated with a command, this error message is displayed. The
Printer Driver Modifier automatically searches for these codes when a
driver is saved or the definitions are checked. After this error message
is displayed, the exact position where one of these reserved codes was
found is highlighted by the cursor in the editing gadget. Sections @{"10.2" LINK 0014/Main 34}
("Save Driver"), @{"10.6" LINK 0014/Main 220} ("Check Definitions") and @{"11.5" LINK 0050/Main 161} ("Encoding Mode").


@{B}Internal name mismatch - Please confirm@{UB}   (D23)

   Printer drivers have an internal name, in addition to the file name.
The driver for the NEC Pinwriter printers, for example, is called
"Nec_Pinwriter". This name is used both as an internal name and to name
the file containing that printer's driver data. If, when loading a driver
(section @{"10.1" LINK 0014/Main 10}), the Printer Driver Modifier detects that the driver's
internal name is different from the file name which has been selected
through the file requester (section @{"3.23" LINK 0008/Main 822}) it displays this warning
message, asking the user to confirm the load operation. The message itself
does not imply an error. It simply informs the user that the driver which
has been selected may not contain the data the user really wanted to load.
If modified versions of the drivers are always saved with other names than
the original name, this message may be a useful help in distinguishing
original drivers from modified versions. As explained in section @{"10.4" LINK 0014/Main 160}
("Save Definitions") it is preferable to modify an original printer
driver, rather than one which has already been modified.


@{B}No errors were found@{UB}   (D2C)

   After a "Check Definitions" command (section @{"10.6" LINK 0014/Main 220}), the Printer Driver
Modifier has checked all control sequences, without finding any errors.


@{B}Printer device will be removed as soon as possible@{UB}   (D34)

   The "Flush Printer Device" function (section @{"10.8" LINK 0014/Main 273}) has been selected,
but the printer driver is currently being used, and cannot be removed from
the system's RAM. As soon as the program currently using the driver does
not need the driver any more, the memory occupied by the driver will be
freed.


@{B}Syntax error in character...@{UB}   (D29)
@{B}Syntax error in command...@{UB}   (D2A)

   The control sequence associated with the specified character or
commmand contains an error. The error may have been caused by a
non-existing code (e.g. "DELY" written instead of "DLAY"), an open
parentheses ('(') not immediately followed by a number (decimal,
hexadecimal or octal), or a missing close parentheses (')') after the
numerical constant, a backslash ('\\') followed by character whose ASCII
code is out of the range 33 to 126. FFDL constant codes and the NOAV and
DLAY codes must be written in upper case. The error is detected when a
driver is saved or the definitions are checked. The program automatically
positions the cursor of the editing gadget where the error was found.
Sections @{"2.7.1" LINK 0055/Main 1118} ("FFDL Constants"), @{"10.2" LINK 0014/Main 34} ("Save Driver"), @{"10.6" LINK 0014/Main 220} ("Check
Definitions") and @{"11.5" LINK 0050/Main 161} ("Encoding Mode") and appendix @{"B" LINK 0004/Main 1} ("Hexadecimal,
Decimal, Octal, Binary and ASCII Codes Table").


@{B}Syntax error in line...@{UB}   (D21)

  An error has been encountered during the loading of a file containing
control sequence definitions. Most likely, in the specified line the
initial keyword was other than CHAR or COMM, or the keyword was not
followed by a number and an equal sign. Sections @{"2.6" LINK 0055/Main 564} ("Program and Font
Parameters") and @{"10.3" LINK 0014/Main 57} ("Load Definitions").


@{B}The current definitions will be lost@{UB}   (D1D)

   The current set of control sequences has been modified since it was
last loaded or saved. The changes to the sequences would be lost if the
program proceeded as requested (e.g. loading a new driver or definition
file, or terminating the program). This warning message gives the user the
opportunity to abort the selected function to save the definitions. This
can be done either by saving the entire driver, or saving the control
sequences to a definition file. Sections @{"10.1" LINK 0014/Main 10} ("Load Driver"), @{"10.3" LINK 0014/Main 57}
("Load Definitions"), @{"10.4" LINK 0014/Main 160} ("Save Definitions"), @{"10.5" LINK 0014/Main 188} ("Clear
Definitions") and @{"10.10" LINK 0014/Main 313} ("Quit").


@{B}The driver cannot be modified@{UB}   (D26)

   A "Load Driver" command has been issued (section @{"10.1" LINK 0014/Main 10}), but the
technique implemented by the Printer Driver Modifier to modify the
driver's control sequences cannot be applied to that driver. This may
happen, for example, if the user tries to modify a driver which has
already been modified by clearing all definitions (or the first ones).


@{B}The file cannot be opened@{UB}   (D1E)

   The file specified in the file requester (section @{"3.23" LINK 0008/Main 822}) cannot be
opened. A wrong path or file name may have been specified. The program
cannot write to a file if another program is accessing the same file. It
is also possible that a software protection is preventing the operating
system from accessing the file. The Workbench "Information" (or "Info") or
the Shell/CLI "Protect" command can be used to modify the access status of
the file.


@{B}The file does not contain the required data@{UB}   (D1F)

   The program has tried to load the data contained in a file, but
discovered that the file did not contain the expected data. For example, a
file other than a printer driver (or a printer driver of an Amiga
operating system version previous to 1.2) may have been specified for the
"Load Driver" function (section @{"10.1" LINK 0014/Main 10}), or the parameter file selected for
the "Load Definitions" operation did not begin with the "PDM DEFS" header.
Sections @{"3.23" LINK 0008/Main 822} ("The File Requester"), @{"10.1" LINK 0014/Main 10} ("Load Driver") and @{"10.3" LINK 0014/Main 57}
("Load Definitions").


@{B}The printer device has been removed@{UB}   (D33)

   The printer driver has been successfully removed from RAM using the
"Flush Printer Device" function (section @{"10.8" LINK 0014/Main 273}). The printer driver can
stay in RAM even after a program has finished using it (often occupying
precious memory). The operating system should be able to detect a
memory-shortage condition and free the memory occupied by the driver, but
it may sometimes be necessary to remove the driver sooner. A printer
driver may also be flushed if it has been modified with the Printer Driver
Modifier, so that the Amiga operating system is forced to load the updated
version the next time the driver is needed. The driver is also removed
automatically by the "Save Driver" function (section @{"10.2" LINK 0014/Main 34}).


@{B}The printer device is not in RAM@{UB}   (D32)

   The "Flush Printer Device" function (section @{"10.8" LINK 0014/Main 273}) has been selected,
but the driver has not been found in the system's RAM. This may be caused
by the fact that the driver has not yet been used, or the operating system
(or a previous "Flush Printer Device" command) has already removed it.


@{B}There is not enough memory@{UB}   (D25)

   There is not enough memory to perform the operation requested. It may
be useful to close as many Workbench windows as possible and terminate
other programs. If the Personal Fonts Maker is running, the "Free Font
Memory" function (section @{"4.2" LINK 2149/Main 35}) can be used on one of the two font
environments, and the "Free Character Set" function (section @{"4.7" LINK 2149/Main 358}) on the
other font.

@ENDNODE