1 :Info: library_desc_compiler: ldc:
 2 2019-11-04  library_descriptor_compiler, ldc
 3 
 4 Syntax:  ldc DESC_NAME {-control_arg}
 5 
 6 
 7 Function:  compiles a library description to produce a library
 8 descriptor data segment.
 9 
10 Refer to "Library Description Language" in the Multics Library
11 Maintenance (AN80) manual for a discussion of the syntax and semantics
12 of the library description language.
13 
14 
15 Arguments:
16 DESC_NAME
17    is the relative pathname of the segment containing the library
18    description to be compiled.  This pathname need not end with the
19    ld suffix.  The archive component pathname convention is allowed.
20 
21 
22 Control arguments:
23 -brief, -bf
24    indicates that the brief form of error messages is to be used for
25    all errors diagnosed during the compilation.  (See "Notes" below.)
26 -long, -lg
27    indicates that the long form of error messages is to be used for all
28    errors diagnosed during the compilation.  (See "Notes" below.)
29 -trace {on|off}
30    a value of on enables tracing of each language rule, as it matches
31    items in the library description segment.  off is the default.
32 -list, -ls
33    produces an ALM listing describing contents of the library
34    descriptor: DESC_NAME.list.  If problems are found when using the
35    descriptor, this listing segment might help in isolating such
36    problems.  However, it is usually not needed.
37 
38 
39 Notes: If the segment being compiled is called DESC_NAME.ld, then the
40 compilation generates a segment called DESC_NAME.alm in the working
41 directory.  This segment is automatically assembled by the alm command
42 to produce the library descriptor data segment.
43 
44 If neither -brief nor -long is used, then the long form of error
45 messages is used for the first occurrence of an error, and the brief
46 form is used for subsequent occurrences of that error.
47 
48 
49 :Internal: history_comment.gi:  2019-08-13  history_comment
50 
51 /****^  HISTORY COMMENTS:
52   1) change(2019-11-04,GDixon), approve(2020-01-04,MCR10069.1),
53      audit(2020-01-04,Swenson), install(2020-01-20,MR12.6g-0034):
54      Document change to accept archive component input pathnames, and to
55      support the -trace {on|off} and -list control arguments.
56                                                    END HISTORY COMMENTS */