*** empty log message ***
[platform/upstream/rpm.git] / NEWS
1 ** This file is hopelessly out of date! **
2
3 Not yet implemented in 2.0:
4
5 . --where and --search
6
7 New in RPM 2.0 (or previously undocumented):
8
9 *** Install
10
11 --replacepkgs   - will install a package even if it's already in the database
12 --replacefiles  - will install a package even if the files it contains conflict
13                   with others
14 --force         - same as "--replacepkgs --replacefiles"
15
16 *** Uninstall
17
18 *** Upgrade
19
20 *** Query
21
22 *** Verify
23
24 Verification output is much more readable.  Notes config files, etc.
25
26 *** PGP Signatures
27
28 RPM now supports optional PGP signatures embedded in RPM packages.
29 Only 1024 bit keys are supported, and the signature "covers" the
30 header and archive sections of the package.  The "lead", which 
31 makes up the first 96 bytes of every package is not covered by
32 the signature.  This should not be cause for alarm as the lead
33 is only used by file(1), and by RPM to determine the package type
34 (either source or binary) and architecture.
35
36 The rpm(1) man page has some details on using PGP signatures.
37
38 *** Spec file (RPM building)
39
40 . Summary: ...
41   A one (short) line description of the package.  This field
42   takes over what Description used to do, but is limited to
43   a single line.  For an interim period, if the Summary is
44   not defined the description will be used instead.
45
46 . Description: ...
47   An optional mulit-line description of the package.
48
49 . Packager: ...
50   Name and email address of the person who "maintains" the RPM
51
52 . URL: ...
53   A place to put a URL for more info on the package (http://...)
54
55 . Serial: ...
56   This number should be monotonically increasing with each new
57   release of the package.  If present, it will be used by RPM
58   to define an ordering.  If not present RPM tries to determine
59   the ordering from the Version field.
60
61 . %package -n foo
62   Builds "subpackage" with name foo-Version-Release
63
64 . %ifarch <arch>+
65   %ifnarch <arch>+
66   %else
67   %endif
68   also: %ifos <os>+
69         %ifnos <os>+
70
71 . Exclude: <arch>+
72   Exclusive: <arch>+
73
74 . %clean
75   Executed after all packaging is finished
76
77 . %changelog
78
79 . %verify can be used to control which aspects of the file are verified
80
81 . %attr can be used to specify mode, user and group of files
82
83 . %files -f <file>
84   Takes file list from <file>, which is relative to the build dir.