Differences

This shows you the differences between two versions of the page.

--- en:docs:tk:tools:mkmsgf [2024/01/19 15:48] – prokushev
+++ en:docs:tk:tools:mkmsgf [2024/09/05 01:46] (current) – [Syntax] prokushev
@@ Line 9: / Line 9: @@
 <diagram>
-|-|v|-|-|-|v|v|-|-|-|v|MKMSGF|v|-|-|-|v|v|-|-|-|v|infile|v|-|-|-|v|v|-|-|-|v|outfile|-@2|
+|-|v|-|-|-|v|v|-|-|-|v|MKMSGF|-@2|
-| |`|drive|'|`|path|'| | | |`|drive|'|`|path|'|  | | |`|drive|'|`|path|'|
+| |`|drive|'|`|path|'|
-|-@2|v|-|-|-|v|(|
+|-@2|v|-|-|-|v|v|-|-|-|v|infile|-@2|
-|   |)|/?|(|
+| |`|drive|'|`|path|'|  | |
-|   |!| | | |!|
-|   |)|/V|(|
+|-@2|v|-|-|-|v|v|-|-|-|v|outfile|-@2|
-|   |!| | | |!|
+| |`|drive|'|`|path|'|
-|   |)|/D <DBCS range or country>|(|
-|   |!| | | |!|
+|   |,|-|-|-|-|-|.| |
-|   |)|/P <code page>|(|
+|-@2|^@1f|v|-|-|-|v|^|(|
-|   |!| | | |!|
+| | |)|/?|(|
-|   |)|/L <language id,sub id>|(|
+| | |!| | | |!|
-|   |!| | | |!|
+| | |)|/V|(|
-|   |)|/I <path>|(|
+| | |!| | | |!|
-|   |!| | | |!|
+| | |)|/Q|(|
-|   |)|/A|(|
+| | |!| | | |!|
-|   |!| | | |!|
+| | |)|/D <DBCS range or country>|(|
-|   |`|/C|'|
+| | |!| | | |!|
+| | |)|/P codepage|(|
+| | |!| | | |!|
+| | |)|/L <language id,sub id>|(|
+| | |!| | | |!|
+| | |)|/I path|(|
+| | |!| | | |!|
+| | |)|/A|(|
+| | |!| | | |!|
+| | |`|/C|'|
 </diagram>
-MKMSGF infile[.ext] outfile[.ext] [/?] [/V] [/D <DBCS range or country>] [/P <code page>] [/L <language id,sub id>]
 ===== Arguments =====
@@ Line 82: / Line 91: @@
         RMS     23      1       Rhaeto-Romanic          Switzerland
         ROM     24      1       Romanian                Romania
-        RUS     25      1       Russian                 U.S.S.R.
+        RUS     25      1       Russian                 Russian Federation
         SHL     26      1       Croato-Serbian (Lat     Yugoslavia
         SHC     26      2       Serbo-Croatian (Cyr     Yugoslavia
@@ Line 94: / Line 103: @@
         SLO     34      1       Slovene                 Slovenia
-For a complete list of code pages and country codes, see the code page table under COUNTRYCODE in the online book Control Program Programming Guide and Reference.
+For a complete list of code pages and country codes, see the code page table under [[https://komh.github.io/os2books/os2tk45/cp2/061_L2_COUNTRYCODE.html|COUNTRYCODE]] in the online book Control Program Programming Guide and Reference.
+===== Output File =====
-Output File
 The output file contains the indexed message file that DosGetMessage will use. The output-file name can be any valid OS/2 file name, optionally preceded by a drive letter and a path. The output file cannot have the same name as the input file.
@@ Line 104: / Line 113: @@
     The infile file should have a .TXT extension.
-    The outfile file should have a .MSG extension.
+    The outfile file can have a .MSG or .INC extension.
 Help-message file names begin with the component identifier, followed by H.MSG. For example, the help file associated with the component identifier DOS would be DOSH.MSG.
-Options
+===== Options =====
 Text-based messages in different code pages can be created using MKMSGF to display errors, help information, prompt, or provide general information to the application user.
@@ Line 122: / Line 131: @@
     Infile is the ASCII-text source file.
+    Outfile is the binary output message file or MASM include file.
+    @controlfile is the message definition file.
-Example:
+===== Options Summary =====
-  MSG
-  MSG0001I: (mm%4dd%4yy) %2%4%1%4%3
-  MSG0002I: (dd%4mm%4yy) %1%4%2%4%3
-  MSG0003I: Current date is: %0
-%0 is a special argument that displays a prompt for user input.
-%1 - %9 are the arguments the user can use to insert text in a message.
-    Outfile is the binary output message file.
-    @controlfile is the message definition file.
-Options Summary
   Type 	Meaning
   /P 	Code-page ID for the input message file.
@@ Line 143: / Line 142: @@
   /V 	Verbose display of message file control variables as the message file is being created.
   /? 	Help display of command syntax for MKMSGF.
+  /A    Produce MASM include file using INC file as include file for message constants
+  /C    Produce MASM include file using H file as include file for message constants
+  /I    Include paths
 Note: Any combination of /P, /D, /L, and /V switches can be used for either the command line or @controlfile execution method.
@@ Line 190: / Line 192: @@
 A valid language family with invalid or undefined language version id will cause a default value of 1 to be set for language version.
-/A /C /I Options
-I saw these and documented them as existing years ago, but never really looked at them in depth. I made some notes on a separate page: The A, C, and I Options.
 /E
-See the The Extended Structure page for more information. This tacks on what I call a fake extended header at the end of the file and updates the header offset.
+Produce fake extended header. This tacks on what I call a fake extended header at the end of the file and updates the header offset.
-Control Files
+===== Control File =====
 The control file (@controlfile) is used to create multiple-code-page message files. The at sign (@) is not part of the file name, but rather, a delimiter required before a control-file name.
@@ Line 216: / Line 217: @@
 Input Message File Example
-Following is an example of an input message file:
-  ; This is a sample of an input
-  ; message file for component MAB
-  ; starting with three comment lines.
-  MAB
-  MAB0100E: File not found
-  MAB0101?:
-  MAB0102H: Usage: del [drive:][path] filename
-  MAB0103?:
-  MAB0104I: %1 files copied
-  MAB0105W: Warning! All data will be destroyed!
-  MAB0106?:
-  MAB0107?:
-  MAB0108P: Do you wish to apply these patches (Y or N)? %0
-  MAB0109E: Divide overflow
 ====== Notes ======