README
1 #
2 # CDDL HEADER START
3 #
4 # The contents of this file are subject to the terms of the
5 # Common Development and Distribution License (the "License").
6 # You may not use this file except in compliance with the License.
7 #
8 # You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 # or http://www.opensolaris.org/os/licensing.
10 # See the License for the specific language governing permissions
11 # and limitations under the License.
12 #
13 # When distributing Covered Code, include this CDDL HEADER in each
14 # file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 # If applicable, add the following below this CDDL HEADER, with the
16 # fields enclosed by brackets "[]" replaced with your own identifying
17 # information: Portions Copyright [yyyy] [name of copyright owner]
18 #
19 # CDDL HEADER END
20 #
21 #
22 # Copyright 2008 Sun Microsystems, Inc. All rights reserved.
23 # Use is subject to license terms.
24 #
25 #ident "@(#)README 1.1 08/09/03 SMI"
26
27 The printmgr(1M) uses a cache of the foomatic PPD files. This
28 cache is built here, rather than on install, for performance
29 reasons.
30
31 Two files are created by the cache target:
32
33 1. ppdunsupported : this is the list of PPD files
34 that are not supported by Sun. The reason for the
35 lack of support is that Solaris does not deliver
36 the printer drivers required by the PPD files.
37 These files are delivered, but are not part of the
38 printmgr database and will not show up in the printmgr
39 menus. The "ppdunsupported" file is not delivered to
40 the customer.
41
42 2. SUNWfoomatic.cache : this is the cache file used
43 by the printmgr. It uses the above file, ppdunsupported,
44 to create the PPD cache. This file is installed and
45 delivered to the customer.
46
47 HOWTO build:
48 0. Pull down a new version of foomatic-filters-ppd.
49
50 1. Check licenses on all the PPD files. Any files with
51 copyrights that do not have a valid license are put in
52 the "nolicense" file and not delivered. The Makefile
53 adds it to the unsupported list. Be sure that the
54 files in "nolicencse" are not in the prototype_com file in
55 pkgdefs/SUNWfppd.
56
57 2. Modify the Makefile.sfw and other files with
58 the new version (VER).
59
60 3. make -f Makefile.sfw install
61
62 4. Check in SUNWfoomatic.cache
63
64 note: the file ppdsupported is created for convenience only.
65 Currently, it is not used.
66