Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 75 lines (73 sloc) 1.976 kb
22f2b38 @keenerd community
authored
1 .\" man 7 groff_mdoc Best resource ever
eb8f09f @keenerd Merge cron-pacmatic and release.
authored
2 .Dd February 18, 2012
22f2b38 @keenerd community
authored
3 .Dt PACMATIC \&1 "Pacmatic Manual"
4 .Os " "
5 .Sh NAME
6 .Nm pacmatic
24eee39 @keenerd fix dexgeh's LANG bug
authored
7 .Nd PACMATIC performs a bunch of mundane tasks that you must do before every invocation of Pacman. If you ever once forget any, you'll probably break your installation. So let's have the computer remind us. However,
8 .Nm
9 will not think for you. It can not protect your system. It merely collects and presents information so that you can make an informed choice.
22f2b38 @keenerd community
authored
10 .Sh SYNOPSIS
11 .Nm pacmatic -[the same options as pacman] [the same arguments as pacman]
eb8f09f @keenerd Merge cron-pacmatic and release.
authored
12 .Nm pacmatic --as-lib
22f2b38 @keenerd community
authored
13 .Sh DESCRIPTION
14 .Nm
15 wraps pacman. All arguments and options are passed directly through to pacman. What
16 .Nm
17 adds to pacman is several pre and post operation checks. Features include reading the archlinux.org news, avoiding -Sy, dealing with pacnew files, reading a mailing list, free space, and logging pacman's exit status.
18 .Pp
19 .Nm
20 can be configured by setting environment variables. Run
21 .Nm
22 without any arguments or options to see the variables and values.
23 .Pp
eb8f09f @keenerd Merge cron-pacmatic and release.
authored
24 To source
25 .Nm
26 in your own script, use the
27 .Nm \--as-lib
28 flag.
29 .Pp
22f2b38 @keenerd community
authored
30 .
31 .Sh ENV VARS
eb8f09f @keenerd Merge cron-pacmatic and release.
authored
32 These are optional.
22f2b38 @keenerd community
authored
33 .Pp
34 .Bl -tag -width ".." -compact
35 .It Cm warn_time
36 Seconds between -Sy and -Su
37 .Pp
38 .It Cm rss_feed
39 The new feed to check before updates.
40 .Pp
41 .It Cm log_file
42 Where the RSS news history is cached.
43 .Pp
44 .It Cm pacdiff_program
45 The utility used for merging diffs.
46 .Pp
47 .It Cm pacman_program
48 Command to launch pacman.
49 .Pp
50 .It Cm mail_list
51 A URL to a flat textfile. (Interpreted to generate year-month.)
52 .Pp
53 .It Cm pacman_log
54 The log file to inspect.
55 .Pp
eb8f09f @keenerd Merge cron-pacmatic and release.
authored
56 .Sh WRAPPERS
57 In case you want even higher levels of automation, there is a
58 .Nm cron-pacmatic
59 script. This script can be run periodically and will email you a summary of
60 .Nm
61 output.
62 .Pp
22f2b38 @keenerd community
authored
63 .Sh AUTHORS
64 .An -nosplit
65 .Pp
66 .Nm
67 was written by
68 .An Kyle Keen Aq keenerd@gmail.com
69 with bits of code from
8317b9b @keenerd fix attribution
authored
70 .An Christophe-Marie Duquesne,
22f2b38 @keenerd community
authored
71 .An Falconindy
72 and
73 .An Brisbin.
74
Something went wrong with that request. Please try again.