summaryrefslogtreecommitdiffstats
path: root/README
blob: 82796f6aac441cbfd0282d7ed63261dff29fa96f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
@ (At Sign)
-----------

@ waits and exits at a specified time.  It can be used to delay shell
commands, e.g.:

    @ 18:00; printf '\a'
    @ '19 January 2038 03:14:07'; halt
    @ 9:00am mon; printf '\a'

@ is similar to the standard sleep utility except that it accepts a time
and optional date instead of a delay duration.  @ is distinct from the
at daemon package by Jose M Calhariz in that @ is not a daemon that runs
jobs in the background; instead it delays subsequent commands in a list,
allowing such commands to remain connected to a controlling terminal for
user interaction.

Date/Time Formats
-----------------

@ currently supports 4341 date/time formats, any one of which may be
specified on the command line in one or more arguments.  The date may be
omitted or specified before or after the time.

See the `FORMATS` file for a list of supported formats.  All spaces
shown are optional.

Development
-----------

@ is maintained in a Git repository.  Browse:

    http://git.pehjota.net/atsign/atsign.git/

Clone:

    git://git.pehjota.net/atsign/atsign.git

Patches may be e-mailed to the author, P. J. McDermott <pj@pehjota.net>.

Copyright
---------

Copyright (C) 2021  P. J. McDermott

Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.  This file is offered as-is,
without any warranty.