1 :Info: add_pnotice:  1985-02-20  add_pnotice
 2 
 3 Syntax as a command:  add_pnotice path {-control_arg}
 4 
 5 
 6 Function: protects  source  code  programs  by  adding,  at the
 7 beginning of a program,  a software protection notice (copyright,
 8 public domain,  or trade secret  notice) in a box  delimited as a
 9 comment.  Multiple protection notices are supported.  Archives of
10 source code  programs can be  protected using this  command.  The
11 archive  pathname  convention  is  supported.   If  a  particular
12 language or  suffix is not  supported, an appropriate  message is
13 printed.
14 
15 
16 Arguments:
17 path
18    is the name of a source  code program, or an archive of source
19    programs.  An archive component pathname  may be given to name
20    a  single archive  component.  The language  suffix or archive
21    suffix must be included.
22 
23 
24 Control arguments:
25 -name STR, -nm STR
26    where STR  specifies the name of  a protection notice template
27    to be added.  "See Notes below".
28 -default_copyright, -dc
29    specifies that  the notice to  be added to the  segment is the
30    default  copyright  notice.   Normally,  this  is  a Honeywell
31    copyright but  your site may change  the default.  See "Notes"
32    below.
33 -default_trade_secret, -dts
34    specifies that  the notice to  be added to the  segment is the
35    default  trade secret  notice.  Normally, this  is a Honeywell
36    trade secret notice but your site may change the default.  See
37    "Notes" below.
38 
39 
40 -brief, -bf
41    suppresses printing  of both the  source program name  and the
42    name of the pnotice that was added.
43 -long, -lg
44    specifies  that both  the name of  the source  program and the
45    name of  the pnotice are  printed when a  protection notice is
46    added.  This is the default.
47 
48 
49 Notes:
50 If control arguments are not  specified and there are no existing
51 pnotices  in  the  program, an  error  message is  issued  and no
52 changes are made to the program.  If copyright pnotices are found
53 in  the  program and  the -nm  or -default_copyright  argument is
54 used, the  ten-year-rule is applied  to the named  pnotice.  That
55 is, if the notice is more than  nine years old, a new copy of the
56 notice  is added  with the  current year.   If copyright pnotices
57 exist and neither the -default_copyright  nor the -nm argument is
58 used, the  ten-year-rule is applied to  the most recent copyright
59 pnotice.
60 
61 
62 A list of available copyright  and trade secret protection notice
63 template  names  can  be  obtained  with  the  list_pnotice_names
64 command.  The -name argument can be  used to specify any of these
65 templates.
66 
67 A given program may contain several copyright notices, or several
68 trade  secret  notices  or  a public  domain  notice,  but cannot
69 contain a mixture of pnotice types.
70 
71 To  list  the  pnotice  segments in  a  source  program,  use the
72 display_pnotice command.
73 
74 For further  information on the software  protection facility see
75 the Multics Library Maintenance PLM Manual (Order No.  AN80).
76 
77 
78 :hcom:
79 
80 
81 
82 /****^  HISTORY COMMENTS:
83   1) change(2020-12-13,GDixon), approve(2021-02-22,MCR10088),
84      audit(2021-05-27,Swenson), install(2021-05-27,MR12.6g-0056):
85       A) Change "Syntax:" to "Syntax as a command:" in command info seg
86          last changed after 1984.
87                                                    END HISTORY COMMENTS */
88 
89 
90