1.1 --- a/docs/lplc.1 Fri Mar 03 13:41:13 2017 +0100
1.2 +++ b/docs/lplc.1 Fri Mar 03 13:44:32 2017 +0100
1.3 @@ -78,6 +78,22 @@
1.4 Show invocations where a callable may be involved that cannot accept
1.5 the arguments provided
1.6 .PP
1.7 +Control over program organisation can be exercised using the following options
1.8 +with each requiring an input filename providing a particular form of
1.9 +information:
1.10 +.TP
1.11 +.B \-\-attr\-codes
1.12 +Attribute codes identifying named object attributes
1.13 +.TP
1.14 +.B \-\-attr\-locations
1.15 +Attribute locations in objects
1.16 +.TP
1.17 +.B \-\-param\-codes
1.18 +Parameter codes identifying named parameters
1.19 +.TP
1.20 +.B \-\-param\-locations
1.21 +Parameter locations in signatures
1.22 +.PP
1.23 The following informational options can be specified to produce output instead
1.24 of compiling a program:
1.25 .PP
1.26 @@ -98,6 +114,28 @@
1.27 compiled. Otherwise, where structures or signatures change in a way that is
1.28 incompatible with already-compiled code, the entire program will be generated
1.29 and compiled again.
1.30 +.PP
1.31 +The
1.32 +.BR \-r " and " \-\-reset
1.33 +options force inspection and compilation to occur again but will still attempt
1.34 +to preserve structure and signature information. Meanwhile, the
1.35 +.BR \-R " and " \-\-reset\-all
1.36 +options remove all traces of previous program information, requiring that all
1.37 +such information be generated again.
1.38 +.SH PROGRAM CONFIGURATION
1.39 +Use of the
1.40 +.BR \-\-attr\-codes " and " \-\-param\-codes
1.41 +options is intended to allow common catalogues of identifying codes to be
1.42 +maintained. Similarly, use of the
1.43 +.BR \-\-attr\-locations " and " \-\-param\-locations
1.44 +options is intended to allow common representations to be maintained.
1.45 +.PP
1.46 +Beyond incremental compilation, these features would allow already-compiled
1.47 +programs and libraries to exchange information in a compatible way, although
1.48 +this is not yet supported in any significant way. However, the
1.49 +.B \-\-attr\-locations
1.50 +option can be useful in directing the attribute allocation process and
1.51 +potentially making program representations more efficient.
1.52 .SH EXAMPLES
1.53 Compile the main program in
1.54 .BR hello.py ,