Skip to content

Commit

Permalink
add options.gml template file for optencod utility options source file
Browse files Browse the repository at this point in the history
update optencod utility gml comments
jmalak committed Jan 23, 2024

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature.
1 parent 44ea59d commit 89c40ad
Showing 29 changed files with 894 additions and 557 deletions.
91 changes: 47 additions & 44 deletions bld/as/h/options.gml
Original file line number Diff line number Diff line change
@@ -27,64 +27,67 @@
:cmt.*
:cmt.* Description: RISC assembler command line options.
:cmt.*
:cmt.* UTF-8 encoding, ¥
:cmt.*
:cmt.*****************************************************************************
:cmt.
:cmt. Source file uses UTF-8 encoding, ¥
:cmt.
:cmt. Definition of command line options to use by optencod utility to generate
:cmt. appropriate command line parser.
:cmt.
:cmt. GML Macros used:
:cmt.
:cmt. :chain. <option> <option> ... options that start with <option>
:cmt. can be chained together i.e.,
:cmt. -oa -ox -ot => -oaxt
:cmt. :target. <targ1> <targ2> ... valid for these targets
:cmt. :ntarget. <targ1> <targ2> ... not valid for these targets
:cmt. :usagechain. <option> <usage text> group of options that start with <option>
:cmt. are chained together in usage
:cmt. :usagegroup. <num> <usage text> group of options that have group <num>
:cmt. are chained together in usage
:cmt. :title. <text> English title usage text
:cmt. :jtitle. <text> Japanese title usage text
:cmt. :titleu. <text> English title usage text for QNX resource file
:cmt. :jtitleu. <text> Japanese title usage text for QNX resource file
:cmt. can be chained together i.e.,
:cmt. -oa -ox -ot => -oaxt
:cmt. :target. <targ1> <targ2> ... valid for these targets (default is 'any')
:cmt. :ntarget. <targ1> <targ2> ... not valid for these targets
:cmt. :usagechain. <option> <usage text> group of options that start with <option>
:cmt. are chained together in usage
:cmt. :usagegroup. <num> <usage text> group of options that have group <num>
:cmt. are chained together in usage
:cmt. :title. <text> English title usage text
:cmt. :jtitle. <text> Japanese title usage text
:cmt. :titleu. <text> English title usage text for QNX resource file
:cmt. :jtitleu. <text> Japanese title usage text for QNX resource file
:cmt.
:cmt. :option. <option> <synonym> ... define an option
:cmt. :immediate. <fn> [<usage argid>] <fn> is called when option parsed
:cmt. :code. <source-code> <source-code> is executed when option parsed
:cmt. :enumerate. <name> [<option>] option is one value in <name> enumeration
:cmt. :number. [<fn>] [<default>] [<usage argid>] =<num> allowed; call <fn> to check
:cmt. :id. [<fn>] [<usage argid>] =<id> req'd; call <fn> to check
:cmt. :char. [<fn>] [<usage argid>] =<char> req'd; call <fn> to check
:cmt. :file. [<usage argid>] =<file> req'd
:cmt. :path. [<usage argid>] =<path> req'd
:cmt. :special. <fn> [<usage argid>] call <fn> to parse option
:cmt. :usage. <text> English usage text
:cmt. :jusage. <text> Japanese usage text
:cmt. :option. <option> <synonym> ... define an option
:cmt. :immediate. <fn> [<usage argid>] <fn> is called when option parsed
:cmt. :code. <source-code> <source-code> is executed when option parsed
:cmt. :enumerate. <name> [<option>] option is one value in <name> enumeration
:cmt. :number. [<fn>] [<default>] [<usage argid>] =<num> allowed; call <fn> to check
:cmt. :id. [<fn>] [<usage argid>] =<id> req'd; call <fn> to check
:cmt. :char. [<fn>] [<usage argid>] =<char> req'd; call <fn> to check
:cmt. :file. [<usage argid>] =<file> req'd
:cmt. :path. [<usage argid>] =<path> req'd
:cmt. :special. <fn> [<usage argid>] call <fn> to parse option
:cmt. :usage. <text> English usage text
:cmt. :jusage. <text> Japanese usage text
:cmt.
:cmt. :optional. value is optional
:cmt. :internal. option is undocumented
:cmt. :prefix. prefix of a :special. option
:cmt. :nochain. option isn't chained with other options
:cmt. :timestamp. kludge to record "when" an option
:cmt. is set so that dependencies
:cmt. between options can be simulated
:cmt. :negate. negate option value
:cmt. :group. <num> group <num> to which option is included
:cmt. :optional. value is optional
:cmt. :internal. option is undocumented
:cmt. :prefix. prefix of a :special. option
:cmt. :nochain. option isn't chained with other options
:cmt. :timestamp. kludge to record "when" an option
:cmt. is set so that dependencies
:cmt. between options can be simulated
:cmt. :negate. negate option value
:cmt. :group. <num> [<chain>] group <num> to which option is included
:cmt. optionaly <chain> can be specified
:cmt.
:cmt. Global macros
:cmt.
:cmt. :noequal. args can't have option '='
:cmt. :argequal. <char> args use <char> instead of '='
:cmt. :noequal. args can't have option '='
:cmt. :argequal. <char> args use <char> instead of '='
:cmt.
:cmt. where <targ>:
:cmt. default - any, dbg
:cmt. architecture - i86, 386, x64, axp, ppc, mps, sparc
:cmt. host OS - bsd, dos, linux, nt, os2, osx, qnx, haiku, rdos, win
:cmt. extra - targ1, targ2
:cmt. default - any, dbg, unused
:cmt. architecture - i86, 386, x64, axp, ppc, mps, sparc
:cmt. host OS - bsd, dos, linux, nov, nt, os2, osx, pls, qnx, rsi, haiku, rdos, win
:cmt. extra - targ1, targ2
:cmt.
:cmt. Translations are required for the :jtitle. and :jusage. tags
:cmt. if there is no text associated with the tag.
:cmt.
:cmt. Translations are required for the :jtitle. and :jusage. tags
:cmt. if there is no text associated with the tag.


:chain. o v

22 changes: 13 additions & 9 deletions bld/bdiff/gml/optionsi.gml
Original file line number Diff line number Diff line change
@@ -27,17 +27,19 @@
:cmt.*
:cmt.* Description: BDIFF utility command line options.
:cmt.*
:cmt.* UTF-8 encoding, ¥
:cmt.*
:cmt.*****************************************************************************
:cmt.
:cmt. Source file uses UTF-8 encoding, ¥
:cmt.
:cmt. Definition of command line options to use by optencod utility to generate
:cmt. appropriate command line parser.
:cmt.
:cmt. GML Macros used:
:cmt.
:cmt. :chain. <option> <option> ... options that start with <option>
:cmt. can be chained together i.e.,
:cmt. -oa -ox -ot => -oaxt
:cmt. :target. <targ1> <targ2> ... valid for these targets
:cmt. :target. <targ1> <targ2> ... valid for these targets (default is 'any')
:cmt. :ntarget. <targ1> <targ2> ... not valid for these targets
:cmt. :usagechain. <option> <usage text> group of options that start with <option>
:cmt. are chained together in usage
@@ -69,21 +71,23 @@
:cmt. is set so that dependencies
:cmt. between options can be simulated
:cmt. :negate. negate option value
:cmt. :group. <num> group <num> to which option is included
:cmt. :group. <num> [<chain>] group <num> to which option is included
:cmt. optionaly <chain> can be specified
:cmt.
:cmt. Global macros
:cmt.
:cmt. :noequal. args can't have option '='
:cmt. :argequal. <char> args use <char> instead of '='
:cmt.
:cmt. where <targ>:
:cmt. default - any, dbg
:cmt. architecture - i86, 386, x64, axp, ppc, mps, sparc
:cmt. host OS - bsd, dos, linux, nt, os2, osx, qnx, haiku, rdos, win
:cmt. extra - targ1, targ2
:cmt. default - any, dbg, unused
:cmt. architecture - i86, 386, x64, axp, ppc, mps, sparc
:cmt. host OS - bsd, dos, linux, nov, nt, os2, osx, pls, qnx, rsi, haiku, rdos, win
:cmt. extra - targ1, targ2
:cmt.
:cmt. Translations are required for the :jtitle. and :jusage. tags
:cmt. Translations are required for the :jtitle. and :jusage. tags
:cmt. if there is no text associated with the tag.
:cmt.


:noequal.
23 changes: 13 additions & 10 deletions bld/bdiff/gml/optionsp.gml
Original file line number Diff line number Diff line change
@@ -27,17 +27,19 @@
:cmt.*
:cmt.* Description: BPATCH utility command line options.
:cmt.*
:cmt.* UTF-8 encoding, ¥
:cmt.*
:cmt.*****************************************************************************
:cmt.
:cmt. Source file uses UTF-8 encoding, ¥
:cmt.
:cmt. Definition of command line options to use by optencod utility to generate
:cmt. appropriate command line parser.
:cmt.
:cmt. GML Macros used:
:cmt.
:cmt. :chain. <option> <option> ... options that start with <option>
:cmt. can be chained together i.e.,
:cmt. -oa -ox -ot => -oaxt
:cmt. :target. <targ1> <targ2> ... valid for these targets
:cmt. :target. <targ1> <targ2> ... valid for these targets (default is 'any')
:cmt. :ntarget. <targ1> <targ2> ... not valid for these targets
:cmt. :usagechain. <option> <usage text> group of options that start with <option>
:cmt. are chained together in usage
@@ -69,22 +71,23 @@
:cmt. is set so that dependencies
:cmt. between options can be simulated
:cmt. :negate. negate option value
:cmt. :group. <num> group <num> to which option is included
:cmt. :group. <num> [<chain>] group <num> to which option is included
:cmt. optionaly <chain> can be specified
:cmt.
:cmt. Global macros
:cmt.
:cmt. :noequal. args can't have option '='
:cmt. :argequal. <char> args use <char> instead of '='
:cmt.
:cmt. where <targ>:
:cmt. default - any, dbg
:cmt. architecture - i86, 386, x64, axp, ppc, mps, sparc
:cmt. host OS - bsd, dos, linux, nt, os2, osx, qnx, haiku, rdos, win
:cmt. extra - targ1, targ2
:cmt. default - any, dbg, unused
:cmt. architecture - i86, 386, x64, axp, ppc, mps, sparc
:cmt. host OS - bsd, dos, linux, nov, nt, os2, osx, pls, qnx, rsi, haiku, rdos, win
:cmt. extra - targ1, targ2
:cmt.
:cmt. Translations are required for the :jtitle. and :jusage. tags
:cmt. Translations are required for the :jtitle. and :jusage. tags
:cmt. if there is no text associated with the tag.

:cmt.

:title. Usage: bpatch {-p} {-q} {-b} <file>
:jtitle. 使用方法: bpatch {-p} {-q} {-b} <file>
23 changes: 13 additions & 10 deletions bld/bdiff/gml/optionsu.gml
Original file line number Diff line number Diff line change
@@ -27,17 +27,19 @@
:cmt.*
:cmt.* Description: BDUMP utility command line options.
:cmt.*
:cmt.* UTF-8 encoding, ¥
:cmt.*
:cmt.*****************************************************************************
:cmt.
:cmt. Source file uses UTF-8 encoding, ¥
:cmt.
:cmt. Definition of command line options to use by optencod utility to generate
:cmt. appropriate command line parser.
:cmt.
:cmt. GML Macros used:
:cmt.
:cmt. :chain. <option> <option> ... options that start with <option>
:cmt. can be chained together i.e.,
:cmt. -oa -ox -ot => -oaxt
:cmt. :target. <targ1> <targ2> ... valid for these targets
:cmt. :target. <targ1> <targ2> ... valid for these targets (default is 'any')
:cmt. :ntarget. <targ1> <targ2> ... not valid for these targets
:cmt. :usagechain. <option> <usage text> group of options that start with <option>
:cmt. are chained together in usage
@@ -69,22 +71,23 @@
:cmt. is set so that dependencies
:cmt. between options can be simulated
:cmt. :negate. negate option value
:cmt. :group. <num> group <num> to which option is included
:cmt. :group. <num> [<chain>] group <num> to which option is included
:cmt. optionaly <chain> can be specified
:cmt.
:cmt. Global macros
:cmt.
:cmt. :noequal. args can't have option '='
:cmt. :argequal. <char> args use <char> instead of '='
:cmt.
:cmt. where <targ>:
:cmt. default - any, dbg
:cmt. architecture - i86, 386, x64, axp, ppc, mps, sparc
:cmt. host OS - bsd, dos, linux, nt, os2, osx, qnx, haiku, rdos, win
:cmt. extra - targ1, targ2
:cmt. default - any, dbg, unused
:cmt. architecture - i86, 386, x64, axp, ppc, mps, sparc
:cmt. host OS - bsd, dos, linux, nov, nt, os2, osx, pls, qnx, rsi, haiku, rdos, win
:cmt. extra - targ1, targ2
:cmt.
:cmt. Translations are required for the :jtitle. and :jusage. tags
:cmt. Translations are required for the :jtitle. and :jusage. tags
:cmt. if there is no text associated with the tag.

:cmt.

:title. Usage: bdump {-p} {-q} {-b} <file>
:jtitle. 使用方法: bdump {-p} {-q} {-b} <file>
23 changes: 13 additions & 10 deletions bld/cc/gml/options.gml
Original file line number Diff line number Diff line change
@@ -27,17 +27,19 @@
:cmt.*
:cmt.* Description: C compiler command line options.
:cmt.*
:cmt.* UTF-8 encoding, ¥
:cmt.*
:cmt.*****************************************************************************
:cmt.
:cmt. Source file uses UTF-8 encoding, ¥
:cmt.
:cmt. Definition of command line options to use by optencod utility to generate
:cmt. appropriate command line parser.
:cmt.
:cmt. GML Macros used:
:cmt.
:cmt. :chain. <option> <option> ... options that start with <option>
:cmt. can be chained together i.e.,
:cmt. -oa -ox -ot => -oaxt
:cmt. :target. <targ1> <targ2> ... valid for these targets
:cmt. :target. <targ1> <targ2> ... valid for these targets (default is 'any')
:cmt. :ntarget. <targ1> <targ2> ... not valid for these targets
:cmt. :usagechain. <option> <usage text> group of options that start with <option>
:cmt. are chained together in usage
@@ -69,22 +71,23 @@
:cmt. is set so that dependencies
:cmt. between options can be simulated
:cmt. :negate. negate option value
:cmt. :group. <num> group <num> to which option is included
:cmt. :group. <num> [<chain>] group <num> to which option is included
:cmt. optionaly <chain> can be specified
:cmt.
:cmt. Global macros
:cmt.
:cmt. :noequal. args can't have option '='
:cmt. :argequal. <char> args use <char> instead of '='
:cmt.
:cmt. where <targ>:
:cmt. default - any, dbg
:cmt. architecture - i86, 386, x64, axp, ppc, mps, sparc
:cmt. host OS - bsd, dos, linux, nt, os2, osx, qnx, haiku, rdos, win
:cmt. extra - targ1, targ2
:cmt. default - any, dbg, unused
:cmt. architecture - i86, 386, x64, axp, ppc, mps, sparc
:cmt. host OS - bsd, dos, linux, nov, nt, os2, osx, pls, qnx, rsi, haiku, rdos, win
:cmt. extra - targ1, targ2
:cmt.
:cmt. Translations are required for the :jtitle. and :jusage. tags
:cmt. Translations are required for the :jtitle. and :jusage. tags
:cmt. if there is no text associated with the tag.

:cmt.

:title. Usage: wccaxp [options] file [options]
:jtitle. 使用方法: wccaxp [options] file [options]
17 changes: 10 additions & 7 deletions bld/f77/gml/wfxopts.gml → bld/f77/gml/options.gml
Original file line number Diff line number Diff line change
@@ -27,17 +27,19 @@
:cmt.*
:cmt.* Description: WFC and WFL compilers command line options.
:cmt.*
:cmt.* UTF-8 encoding, ¥
:cmt.*
:cmt.*****************************************************************************
:cmt.
:cmt. Source file uses UTF-8 encoding, ¥
:cmt.
:cmt. Definition of command line options to use by optencod utility to generate
:cmt. appropriate command line parser.
:cmt.
:cmt. GML Macros used:
:cmt.
:cmt. :chain. <option> <option> ... options that start with <option>
:cmt. can be chained together i.e.,
:cmt. -oa -ox -ot => -oaxt
:cmt. :target. <targ1> <targ2> ... valid for these targets
:cmt. :target. <targ1> <targ2> ... valid for these targets (default is 'any')
:cmt. :ntarget. <targ1> <targ2> ... not valid for these targets
:cmt. :usagechain. <option> <usage text> group of options that start with <option>
:cmt. are chained together in usage
@@ -69,22 +71,23 @@
:cmt. is set so that dependencies
:cmt. between options can be simulated
:cmt. :negate. negate option value
:cmt. :group. <num> group <num> to which option is included
:cmt. :group. <num> [<chain>] group <num> to which option is included
:cmt. optionaly <chain> can be specified
:cmt.
:cmt. Global macros
:cmt.
:cmt. :noequal. args can't have option '='
:cmt. :argequal. <char> args use <char> instead of '='
:cmt.
:cmt. where <targ>:
:cmt. default - any, dbg
:cmt. default - any, dbg, unused
:cmt. architecture - i86, 386, x64, axp, ppc, mps, sparc
:cmt. host OS - bsd, dos, linux, nt, os2, osx, qnx, haiku, rdos, win
:cmt. host OS - bsd, dos, linux, nov, nt, os2, osx, pls, qnx, rsi, haiku, rdos, win
:cmt. extra - targ1, targ2
:cmt.
:cmt. Translations are required for the :jtitle. and :jusage. tags
:cmt. if there is no text associated with the tag.

:cmt.

:title. Usage: wfc [options] <file-spec> [options]
:jtitle. 使用方法: wfc [options] <file-spec> [options]
2 changes: 1 addition & 1 deletion bld/f77/wfc/master.mif
Original file line number Diff line number Diff line change
@@ -131,6 +131,6 @@ optencod_targets = $(target_cpu) $(host_os)
optencod_targets += dbg
!endif

usage.gh $(exetarg_$(host_os)_res) : $(f77_dir)/gml/wfxopts.gml $(__MAKEFILES__)
usage.gh $(exetarg_$(host_os)_res) : $(f77_dir)/gml/options.gml $(__MAKEFILES__)
@%make echo_optencod
$(noecho)*optencod -q -rc=MSG_USAGE_BASE -utf8 $(optencod_opt_$(host_os)) $[@ . . $@ . $(optencod_targets)
Loading

0 comments on commit 89c40ad

Please sign in to comment.