1 :Info: mbuild_type: mbt:  2019-08-09  mbuild_type, mbt
  2 
  3 Syntax as a command:
  4    mbt OPERATION {NAME} {-control_args}
  5 
  6 
  7 Syntax as an active function:
  8   [mbt OPERATION NAME {-control_args}]
  9 
 10 
 11 Function: displays information about: segment types installed in the
 12 Multics Libraries; and build paradigms, the procedures and policies for
 13 building and installing a given type of segment.
 14 
 15 
 16 Arguments:
 17 OPERATION
 18    selects the operation to be performed.  See "List of operations"
 19    below.
 20 NAME
 21    selects information to be displayed.
 22 
 23 
 24 List of operations:
 25    For details about each operation, type: help mbt.OPERATION
 26 paradigm, pdm
 27    displays information about a build paradigm; or summarizes known
 28    paradigms used in the Multics Libraries.
 29 seg_type, seg
 30    summarizes known segment types found in the Multics Libraries; or
 31    displays information about building and installing a given segment.
 32 
 33 
 34 Control arguments:
 35 -control_args
 36    control function performed by each OPERATION.  For details, type:
 37      help mbt.OPERATION
 38 
 39 
 40 :Info: mbt.paradigm: mbt.pdm:  2019-08-09  mbt paradigm operation
 41 
 42 Syntax as a command:  mbt pdm {PARADIGM_NAME} {-control_args}
 43 
 44 
 45 Syntax as an active function:
 46   [mbt pdm PARADIGM_NAME {-control_args}]
 47 
 48 
 49 Function: displays information about build paradigms, the procedures
 50 and policies for building a given type of segment, and installing it
 51 into the Multics Libraries.
 52 
 53 
 54 If invoked without args, displays a 3-line description of the known
 55 build paradigms including: name, purpose and example segments using
 56 that paradigm.
 57 
 58 If invoked with a paradigm_name and no control_args, displays a longer
 59 description of that paradigm.
 60 
 61 As an active function, specific information about a given paradigm is
 62 returned.
 63 
 64 
 65 Arguments:
 66 paradigm, pdm
 67    the operation being performed.
 68 PARADIGM_NAME
 69    names a paradigm to be displayed.  This is optional when invoked as
 70    a command, but required when used as an active function.
 71 
 72 
 73 Control arguments:
 74 -all, -a
 75    displays all information for the paradigm.
 76 -name, -nm
 77    displays the paradigm name.
 78 -purpose
 79    displays the purpose of the paradigm.
 80 -example
 81    displays an example segment that is built or installed using the
 82    paradigm.
 83 -steps
 84    displays steps performed as part of this build paradigm.
 85 
 86 
 87 :Info: mbt.seg_type: mbt.seg:  2019-06-10  mbt seg_type operation
 88 
 89 Syntax as a command:  mbt seg {SEG_NAME} {-control_args}
 90                       mbt seg -for_paradigm paradigm_name
 91 
 92 
 93 Syntax as an active function:  [mbt seg SEG_NAME {-control_args}]
 94 
 95 
 96 Function:  displays information about the different types of segments
 97 installed in the Multics Libraries.
 98 
 99 If invoked without args, summarizes known segment types installed in
100 the Multics Libraries.  This includes a starname selecting a group of
101 segments, and characteristics of segments in the group.
102 
103 If invoked with a seg_name and no control_args, displays full
104 information about building and/or installing that segment.
105 
106 As an active function, returns selected information about build a given
107 segment.
108 
109 
110 Arguments:
111 seg_type, seg
112    the operation being performed.
113 SEG_NAME
114    names a segment whose build/install information is displayed.  This
115    argument is optional when invoked as a command, but required when
116    used as an active function.
117 
118 
119 Control arguments:
120 -for_paradigm paradigm_name, -fpdm paradigm_name
121    selects all segment types built using the given paradigm.  This
122    control argument may not be used as an active function.
123 -all, -a
124    displays all information for the build type.
125 -name, -nm
126    displays a starname that matches segments in the build type.
127 -description, -desc
128    displays a title for segments matching the starname.
129 -type, -tp
130    displays the <seg-type> value given by mbuild in its
131    Seg(<seg-type) structures for segments having the build type..
132 -library, -lb
133    displays library in which this type of file is installed.
134 
135 
136 -compiler
137    displays compiler command name used in building the segment.
138 -option, -op
139    displays default compiler option(s) used in building the segment.
140 -isuffix, -isfx
141    displays suffix of any intermediate files generated by the compiler.
142    For example, the reductions compiler: generates a .pl1 file; invokes
143    pl1 to compile this file; and leaves the .pl1 file in working
144    directory as a debugging aid.
145 -osuffix, -osfx
146    displays suffix (if any) of object segment generated by the
147    compiler.
148 
149 
150 -paradigm, -pdm
151    displays name of the paradigm used in building the segment.
152 -steps
153    displays steps performed as part of this build paradigm.
154 
155 
156 :hcom:
157 /****^  HISTORY COMMENTS:
158   1) change(2019-08-17,GDixon), approve(2019-10-24,MCR10069),
159      audit(2020-01-20,Swenson), install(2020-01-20,MR12.6g-0035):
160      Initial documentation for mbuild_type command.  For details, see:
161        MTB-1003  mbuild Subsystem
162   2) change(2020-05-28,GDixon), approve(2021-02-22,MCR10088),
163      audit(2021-05-27,Swenson), install(2021-05-27,MR12.6g-0056):
164      Change formatting to use new Operations Format style supported by the
165      verify_info command.
166                                                    END HISTORY COMMENTS */