Initial import of the CDE 2.1.30 sources from the Open Group.
This commit is contained in:
Peter Howkins
368
cde/doc/C/guides/man/man1_dt/cm_delet.sgm
Normal file
368
cde/doc/C/guides/man/man1_dt/cm_delet.sgm
Normal file
@@ -0,0 +1,368 @@
|
||||
<!-- $XConsortium: cm_delet.sgm /main/10 1996/09/08 19:50:22 rws $ -->
|
||||
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
|
||||
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
|
||||
<!-- (c) Copyright 1995 International Business Machines Corp. -->
|
||||
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
|
||||
<!-- (c) Copyright 1995 Novell, Inc. -->
|
||||
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
|
||||
<!-- (c) Copyright 1995 Hitachi. -->
|
||||
|
||||
<![ %CDE.C.CDE; [<RefEntry Id="CDEMX.XCSA.MAN2.rsml.1">]]>
|
||||
<![ %CDE.C.XO; [<RefEntry Id="XCSA.MAN2.rsml.1">]]>
|
||||
<RefMeta>
|
||||
<RefEntryTitle>dtcm_delete</RefEntryTitle>
|
||||
<ManVolNum>user cmd</ManVolNum>
|
||||
</RefMeta>
|
||||
<RefNameDiv>
|
||||
<RefName><Command>dtcm_delete</Command></RefName>
|
||||
<RefPurpose>delete appointments from the calendar database
|
||||
</RefPurpose>
|
||||
</RefNameDiv>
|
||||
<!-- CDE Common Source Format, Version 1.0.0-->
|
||||
<!-- (c) Copyright 1993, 1994, 1995 Hewlett-Packard Company-->
|
||||
<!-- (c) Copyright 1993, 1994, 1995 International Business Machines Corp.-->
|
||||
<!-- (c) Copyright 1993, 1994, 1995 Sun Microsystems, Inc.-->
|
||||
<!-- (c) Copyright 1993, 1994, 1995 Novell, Inc.-->
|
||||
<RefSynopsisDiv>
|
||||
<CmdSynopsis>
|
||||
<Command>dtcm_delete</Command>
|
||||
<Arg Choice="opt">−c <Replaceable>calendar</Replaceable></Arg>
|
||||
<Arg Choice="opt">−d <Replaceable>date</Replaceable></Arg>
|
||||
<Arg Choice="opt">−v <Replaceable>view</Replaceable></Arg>
|
||||
</CmdSynopsis>
|
||||
</RefSynopsisDiv>
|
||||
<RefSect1>
|
||||
<Title>DESCRIPTION</Title>
|
||||
<Para>The
|
||||
<Command>dtcm_delete</Command> utility is non-GUI interface to the &str-XZ; calendar and appointment services,
|
||||
used to delete appointments from the calendar
|
||||
<![ %CDE.C.CDE; [database via the RPC daemon
|
||||
&cdeman.rpc.cmsd;. ]]><![ %CDE.C.XO; [database.
|
||||
]]>Appointments are deleted one at a time.
|
||||
Each of the components of an
|
||||
appointment is specified using one of the command-line options.
|
||||
The current list of appointments for the specified date
|
||||
(see the
|
||||
<Literal>−d</Literal> and
|
||||
<Literal>−v</Literal> options) is displayed,
|
||||
numbered sequentially starting with 1.
|
||||
The user is prompted for the number to delete.
|
||||
Once an appointment
|
||||
is deleted, the list of remaining appointments is redisplayed.
|
||||
At this point
|
||||
the user can specify another number, or just
|
||||
<KeySym>carriage-return</KeySym> to quit.
|
||||
</Para>
|
||||
</RefSect1>
|
||||
<RefSect1>
|
||||
<Title>OPTIONS</Title>
|
||||
<![ %CDE.C.XO; [
|
||||
<Para>The
|
||||
<Command>dtcm_delete</Command> utility supports the &str-Zu;.
|
||||
</Para>
|
||||
]]>
|
||||
<Para>The following options are available:
|
||||
</Para>
|
||||
<VariableList>
|
||||
<VarListEntry>
|
||||
<Term><Literal>−c </Literal><Emphasis>calendar</Emphasis></Term>
|
||||
<ListItem>
|
||||
<Para>Specify the name of the target calendar.
|
||||
Calendar names
|
||||
<![ %CDE.C.XO; [are implementation-dependent, but
|
||||
]]>typically take the form
|
||||
<Emphasis>user</Emphasis>@ <Emphasis>hostname</Emphasis>, where
|
||||
<Emphasis>user</Emphasis> is a user's login name and
|
||||
<Emphasis>hostname</Emphasis> is the host machine name.
|
||||
<![ %CDE.C.CDE; [An example is
|
||||
<Literal>felix@cat</Literal>. ]]>If no target calendar is specified,
|
||||
the calendar defaults to
|
||||
the current user at the current host machine.
|
||||
</Para>
|
||||
</ListItem>
|
||||
</VarListEntry>
|
||||
<VarListEntry>
|
||||
<Term><Literal>−d </Literal><Emphasis>date</Emphasis></Term>
|
||||
<ListItem>
|
||||
<Para>Specify the date for the appointment(s) to be deleted.
|
||||
The
|
||||
<Emphasis>date</Emphasis> is specified using the form
|
||||
<Symbol Role="Variable">mm</Symbol>/ <Emphasis>dd</Emphasis>/ <Emphasis>yy</Emphasis>, where
|
||||
<Symbol Role="Variable">mm</Symbol>, <Emphasis>dd</Emphasis> and
|
||||
<Emphasis>yy</Emphasis> are the two-digit month, day and year modulo 100, respectively.
|
||||
<![ %CDE.C.CDE; [Certain other references such as
|
||||
``today,'' ``Tuesday,'' ``tomorrow,'' etc.
|
||||
are correctly calculated.
|
||||
]]>If no date is specified,
|
||||
<Emphasis>date</Emphasis> defaults to today's date.
|
||||
</Para>
|
||||
</ListItem>
|
||||
</VarListEntry>
|
||||
<VarListEntry>
|
||||
<Term><Literal>−v </Literal><Emphasis>view</Emphasis></Term>
|
||||
<ListItem>
|
||||
<Para>Specify the view span of appointments to display.
|
||||
The
|
||||
<Emphasis>view</Emphasis> option-argument can be:
|
||||
</Para>
|
||||
<VariableList>
|
||||
<VarListEntry>
|
||||
<Term><Literal>day</Literal></Term>
|
||||
<ListItem>
|
||||
<Para>Display all appointments for the given date (see
|
||||
<Literal>−d</Literal> option).
|
||||
</Para>
|
||||
</ListItem>
|
||||
</VarListEntry>
|
||||
<VarListEntry>
|
||||
<Term><Literal>week</Literal></Term>
|
||||
<ListItem>
|
||||
<Para>Display the full week that contains the given date,
|
||||
starting with Sunday.
|
||||
</Para>
|
||||
</ListItem>
|
||||
</VarListEntry>
|
||||
<VarListEntry>
|
||||
<Term><Literal>month</Literal></Term>
|
||||
<ListItem>
|
||||
<Para>Display the entire month that contains the given date.
|
||||
</Para>
|
||||
</ListItem>
|
||||
</VarListEntry>
|
||||
</VariableList>
|
||||
</ListItem>
|
||||
</VarListEntry>
|
||||
</VariableList>
|
||||
</RefSect1>
|
||||
<RefSect1>
|
||||
<Title>OPERANDS</Title>
|
||||
<Para>None.
|
||||
</Para>
|
||||
</RefSect1>
|
||||
<RefSect1>
|
||||
<Title>STDIN</Title>
|
||||
<Para>The standard input is used to receive user
|
||||
replies to the list of appointments to be deleted.
|
||||
</Para>
|
||||
</RefSect1>
|
||||
<RefSect1>
|
||||
<Title>INPUT FILES</Title>
|
||||
<Para>None.
|
||||
</Para>
|
||||
</RefSect1>
|
||||
<RefSect1>
|
||||
<Title>ENVIRONMENT VARIABLES</Title>
|
||||
<Para>The following environment variables affect the execution of
|
||||
<Command>dtcm_delete</Command>:</Para>
|
||||
<VariableList>
|
||||
<VarListEntry>
|
||||
<Term><SystemItem Class="EnvironVar">LANG</SystemItem></Term>
|
||||
<ListItem>
|
||||
<Para>Provide a default value for the internationalization variables
|
||||
that are unset or null.
|
||||
If
|
||||
<SystemItem Class="EnvironVar">LANG</SystemItem> is unset or null, the corresponding value from the
|
||||
implementation-specific default locale will be used.
|
||||
If any of the internationalization variables contains an invalid setting, the
|
||||
utility behaves as if none of the variables had been defined.
|
||||
</Para>
|
||||
</ListItem>
|
||||
</VarListEntry>
|
||||
<VarListEntry>
|
||||
<Term><Emphasis>LC_ALL</Emphasis></Term>
|
||||
<ListItem>
|
||||
<Para>If set to a non-empty string value,
|
||||
override the values of all the other internationalization variables.
|
||||
</Para>
|
||||
</ListItem>
|
||||
</VarListEntry>
|
||||
<VarListEntry>
|
||||
<Term><Emphasis>LC_MESSAGES</Emphasis></Term>
|
||||
<ListItem>
|
||||
<Para>Determine the locale that is used to affect
|
||||
the format and contents of diagnostic
|
||||
messages written to standard error
|
||||
and informative messages written to standard output.
|
||||
</Para>
|
||||
</ListItem>
|
||||
</VarListEntry>
|
||||
<VarListEntry>
|
||||
<Term><SystemItem Class="EnvironVar">NLSPATH</SystemItem></Term>
|
||||
<ListItem>
|
||||
<Para>Determine the location of message catalogues
|
||||
for the processing of
|
||||
<Emphasis>LC_MESSAGES</Emphasis>.</Para>
|
||||
</ListItem>
|
||||
</VarListEntry>
|
||||
</VariableList>
|
||||
</RefSect1>
|
||||
<RefSect1>
|
||||
<Title>RESOURCES</Title>
|
||||
<Para>None.
|
||||
</Para>
|
||||
</RefSect1>
|
||||
<RefSect1>
|
||||
<Title>ASYNCHRONOUS EVENTS</Title>
|
||||
<![ %CDE.C.XO; [
|
||||
<Para>Default.
|
||||
</Para>
|
||||
]]>
|
||||
<![ %CDE.C.CDE; [
|
||||
<Para>The
|
||||
<Command>dtcm_delete</Command> utility takes the standard action for all signals.
|
||||
</Para>
|
||||
]]>
|
||||
</RefSect1>
|
||||
<RefSect1>
|
||||
<Title>STDOUT</Title>
|
||||
<Para>The standard output contains the list of appointments to be
|
||||
<![ %CDE.C.CDE; [deleted.
|
||||
]]><![ %CDE.C.XO; [deleted, in an unspecified format.
|
||||
]]></Para>
|
||||
</RefSect1>
|
||||
<RefSect1>
|
||||
<Title>STDERR</Title>
|
||||
<Para>Used only for diagnostic messages.
|
||||
</Para>
|
||||
</RefSect1>
|
||||
<RefSect1>
|
||||
<Title>OUTPUT FILES</Title>
|
||||
<Para>None.
|
||||
</Para>
|
||||
</RefSect1>
|
||||
<RefSect1>
|
||||
<Title>EXTENDED DESCRIPTION</Title>
|
||||
<Para>None.
|
||||
</Para>
|
||||
</RefSect1>
|
||||
<RefSect1>
|
||||
<Title>EXIT STATUS</Title>
|
||||
<Para>The following exit values are returned:
|
||||
</Para>
|
||||
<VariableList>
|
||||
<VarListEntry>
|
||||
<Term>0</Term>
|
||||
<ListItem>
|
||||
<Para>Successful completion.
|
||||
</Para>
|
||||
</ListItem>
|
||||
</VarListEntry>
|
||||
<VarListEntry>
|
||||
<Term>>0</Term>
|
||||
<ListItem>
|
||||
<Para>An error occurred.
|
||||
</Para>
|
||||
</ListItem>
|
||||
</VarListEntry>
|
||||
</VariableList>
|
||||
</RefSect1>
|
||||
<RefSect1>
|
||||
<Title>CONSEQUENCES OF ERRORS</Title>
|
||||
<Para>Default.
|
||||
</Para></RefSect1>
|
||||
<![ %CDE.C.CDE; [<RefSect1>
|
||||
<Title>FILES</Title>
|
||||
<Para><Filename>/usr/spool/calendar/callog.username</Filename>,
|
||||
<Filename>/usr/dt/bin/rpc.cmsd</Filename></Para>
|
||||
</RefSect1>]]>
|
||||
<RefSect1>
|
||||
<Title>APPLICATION USAGE</Title>
|
||||
<Para>None.
|
||||
</Para>
|
||||
</RefSect1>
|
||||
<RefSect1>
|
||||
<Title>EXAMPLES</Title>
|
||||
<![ %CDE.C.XO; [
|
||||
<Para>None.
|
||||
</Para>
|
||||
]]>
|
||||
<![ %CDE.C.CDE; [
|
||||
<Para>The simplest form of
|
||||
<Command>dtcm_delete</Command> has no arguments:
|
||||
</Para>
|
||||
<InformalExample Remap="indent">
|
||||
<ProgramListing>dtcm_delete
|
||||
Appointments for Tuesday September 25, 1990:
|
||||
1) Appointment
|
||||
2) 10:30am-10:45am Morning Tea
|
||||
3) 2:00pm-3:00pm Staff meeting
|
||||
4) 4:30pm-5:30pm Phone home
|
||||
Item to delete (number)? 2
|
||||
Appointments for Tuesday September 25, 1990:
|
||||
1) Appointment
|
||||
2) 2:00pm-3:00pm Staff meeting
|
||||
3) 4:30pm-5:30pm Phone home
|
||||
Item to delete (number)?
|
||||
</ProgramListing>
|
||||
</InformalExample>
|
||||
<Para>To delete at a specific date:
|
||||
</Para>
|
||||
<InformalExample Remap="indent">
|
||||
<ProgramListing>dtcm_delete −d 09/26/90
|
||||
Appointments for Wednesday September 26, 1990:
|
||||
1) 11:00am-12:00pm Appointment
|
||||
2) 11:30am-12:30pm Group Lunch
|
||||
3) 4:00pm-5:00pm Tech Interview
|
||||
Item to delete (number)? 1
|
||||
Appointments for Wednesday September 26, 1990:
|
||||
1) 11:30am-12:30pm Group Lunch
|
||||
2) 4:00pm-5:00pm Tech Interview
|
||||
Item to delete (number)?
|
||||
</ProgramListing>
|
||||
</InformalExample>
|
||||
<Para>To delete from a specific target calendar:
|
||||
</Para>
|
||||
<InformalExample Remap="indent">
|
||||
<ProgramListing>dtcm_delete −c felix@cat
|
||||
Appointments for Tuesday September 25, 1990:
|
||||
1) Appointment
|
||||
2) 10:15am-10:30am Coffee
|
||||
3) 11:15am-11:30am Doughnuts
|
||||
4) 2:00pm-2:15pm Coffee
|
||||
5) 3:30pm-3:45pm Snack
|
||||
6) 4:30pm-4:45pm Coffee
|
||||
Item to delete (number)? 5
|
||||
Appointments for Tuesday September 25, 1990:
|
||||
1) Appointment
|
||||
2) 10:15am-10:30am Coffee
|
||||
3) 11:15am-11:30am Doughnuts
|
||||
4) 2:00pm-2:15pm Coffee
|
||||
5) 4:30pm-4:45pm Coffee
|
||||
Item to delete (number)?
|
||||
</ProgramListing>
|
||||
</InformalExample>
|
||||
<Para>To delete multiple appointments:
|
||||
</Para>
|
||||
<InformalExample Remap="indent">
|
||||
<ProgramListing>dtcm_delete
|
||||
Appointments for Tuesday September 25, 1990:
|
||||
1) Appointment
|
||||
2) 10:15am-10:30am Coffee
|
||||
3) 11:15am-11:30am Doughnuts
|
||||
4) 2:00pm-2:15pm Coffee
|
||||
5) 3:30pm-3:45pm Snack
|
||||
6) 4:30pm-4:45pm Coffee
|
||||
Item to delete (number)? 5
|
||||
Appointments for Tuesday September 25, 1990:
|
||||
1) Appointment
|
||||
2) 10:15am-10:30am Coffee
|
||||
3) 11:15am-11:30am Doughnuts
|
||||
4) 2:00pm-2:15pm Coffee
|
||||
5) 4:30pm-4:45pm Coffee
|
||||
Item to delete (number)? 3
|
||||
Appointments for Tuesday September 25, 1990:
|
||||
1) Appointment
|
||||
2) 10:15am-10:30am Coffee
|
||||
3) 2:00pm-2:15pm Coffee
|
||||
4) 4:30pm-4:45pm Coffee
|
||||
Item to delete (number)?
|
||||
</ProgramListing>
|
||||
</InformalExample>
|
||||
]]>
|
||||
</RefSect1>
|
||||
<RefSect1>
|
||||
<Title>SEE ALSO</Title>
|
||||
<Para><![ %CDE.C.CDE; [&cdeman.rpc.cmsd;, &cdeman.dtcm;, ]]>&cdeman.dtcm.insert;, &cdeman.dtcm.lookup;.</Para>
|
||||
</RefSect1>
|
||||
</RefEntry>
|
||||
<!--fickle 1.12 mancsf-to-docbook 1.2 08/07/95 23:40:24-->
|
||||
Reference in New Issue
Block a user