1 02/06/85  check_info_segs, cis
 2 
 3 Syntax as a command:  cis {-control_args}
 4 
 5 
 6 Syntax as an active function:  [cis {-control_args}]
 7 
 8 
 9 Function: prints a list of info segments modified since a given time.
10 
11 
12 Control arguments:
13 -absolute_pathname, -absp
14    prints or returns absolute pathnames of segments rather than
15    entrynames.
16 -brief, -bf
17    does not print either the "No change" message or, if used with
18    -call, the names of changed info segs.  Don't use -brief with the
19    active function.
20 -call cmdline
21    calls the command processor with "cmdline path" for each changed
22    segment; path is the absolute pathname of a changed segment.  If
23    cmdline contains blanks, it must be enclosed in quotes.  Don't use
24    -call with the active function.
25 
26 
27 -date DT, -dt DT
28    uses the date DT instead of the date in your default value segment.
29    The date in the value segment is not updated.
30    (See time_strings.gi.)
31 -long, -lg
32    prints the date-time-entry-modified as well as the segment name.
33    Don't use -long with the active function.
34 -no_update, -nud
35    does not update the date in your value segment.
36 -pathname star_path, -pn star_path
37    checks all segments that match star_path, which is a pathname with a
38    star name in the entryname portion.  You can supply more than one
39    -pathname.  If you give none, the directories in the "info_segments"
40    ("info_segs", "info") search list are used; **.info is used as the
41    entryname.
42 
43 
44 -time_checked, -tmck
45    prints the date-time that is stored in your default value segment
46    indicating from when checking of modified info segments occurs if
47    -date is not given.  This control argument is incompatible with all
48    others when used with the active function.  It does not update the
49    time in your value segment when it is the only control argument.
50 
51 
52 Notes: The first time you invoke cis, it sets the date in your default
53 value segment.  The value segment is created if one does not exist and
54 is normally
55    >udd>Project_id>Person_id>Person_id.value
56 but can be changed by the value_set_path command.
57 
58 For links that match the star names, the date-time-entry-modified of
59 the link's target is checked rather than that of the link itself.
60 
61 Zero-length info segments are not reported as being modified.
62 
63 The cis active function returns entrynames of selected info segments
64 separated by spaces.  If you give -absolute_pathname, it returns full
65 pathnames of info segments separated by spaces.
66 
67 
68 Since the cis active function also sets the date in your
69 default value segment, a command line using [cis] sets this date before
70 processing any of the returned info seg names.  As a result, segments
71 can be unintentionally skipped and not seen a second time if a command
72 line containing [cis] is interrupted.