1 02/12/85  format_line_nnl, flnnl
 2 
 3 Syntax as a command:  flnnl control_string {args}
 4 
 5 
 6 Syntax as an active function:  [flnnl control_string {args}]
 7 
 8 
 9 Function: is the command/active function interface to the ioa_$nnl
10 subroutine.  When used as a command, the formatted string is printed
11 without a trailing newline.
12 
13 
14 Arguments:
15 control_string
16    is an ioa_ control string used to format the return value of the
17    active function.
18 args
19    are character strings substituted in the formatted return value
20    according to the control string.
21 
22 
23 Notes: The following ioa_ control codes are allowed (see the ioa_
24 subroutine).  The control string is output exactly as is except that
25 certain constructs beginning with a caret (^) are expanded, which may
26 involve argument substitution or interpretation.  Unimplemented
27 constructs are output as is, but avoid them to allow for future
28 extensions.
29 
30 
31  CONTROL           ACCEPTABLE ARGUMENTS
32  ^a   ^Na          any character string
33  ^d   ^Nd          a character representation of a number, including
34                    optional exponent (315.44 or .2789e+2 or 1101b)
35  ^i   ^Ni          same as ^d
36  ^f   ^Nf          same as ^d
37  ^.Df ^N.Df        same as ^d
38  ^e   ^Ne          same as ^d
39  ^o   ^No          same as ^d
40  ^[...^            "true", "false", or an integer character string
41  ...^]             any number of any character string
42  ^(...^) or
43  ^N(...^)          an integer character string.
44  ^s  ^Ns
45 
46 
47 In addition, you can use any of the following carriage movement
48 controls:
49       ^N/      ^N|      ^N-
50       ^Nx      ^N^      ^R
51       ^B       ^t       ^Nt
52       ^N.Dt    ^/       ^|
53       ^-       ^x       ^^
54 
55 where N is an integer count or a "v".  When you give "v", an integer
56 character string from the args is used for count.
57 
58 If you don't give optional arguments, the value returned depends on the
59 ioa_ control string that you specified.