Add packaging/epson-laser-printer-escpage.changes file
[platform/upstream/epson-laser-printer-escpage.git] / README
1 Epson Laser Printer Driver (ESC/Page) Manual\r
2 \r
3 Copyright (C) Seiko Epson Corporation 2005-2012.\r
4 \r
5 Contents\r
6 1  License Agreement\r
7 2  Revision History\r
8 3  Product Description\r
9 4  Installation and CUPS setting\r
10     4.1  Installing\r
11     4.2  Settings after installation\r
12 5  Printing\r
13     5.1  Items to be set\r
14     5.2  Details of setting items\r
15     5.3  How to Set\r
16     5.4  How to Print\r
17 6  How to build in non-LSB distribution\r
18     6.1  For Redhat based distributions\r
19     6.2  For Debian based distributions\r
20     6.3  Other distributions\r
21 \r
22 -------------------------------------------------------------------------------\r
23 1  License Agreement\r
24 -------------------------------------------------------------------------------\r
25 This software is covered by the GNU General Public License (GPL). \r
26 Refer to the file "COPYING" for more information about the GPL.\r
27 \r
28 -------------------------------------------------------------------------------\r
29 2  Revision History\r
30 -------------------------------------------------------------------------------\r
31 See ./NEWS.\r
32 \r
33 \r
34 -------------------------------------------------------------------------------\r
35 3  Product Description\r
36 -------------------------------------------------------------------------------\r
37 This software is a filter program used with the Common UNIX Printing\r
38 System (CUPS) on the Linux platform.\r
39 The software offers high quality printing with Seiko Epson Laser printers.\r
40 \r
41 This software is based on LSB 3.2. It can be used in distribution supporting LSB 3.2 later.\r
42 If it is used in non-LSB distribution, you can use it by building from the source code.\r
43 \r
44 -------------------------------------------------------------------------------\r
45 4  Installation and CUPS Setting\r
46 -------------------------------------------------------------------------------\r
47 4.1  Installation\r
48            Choose the appropriate command for your distribution from the list below\r
49            and execute it with root privileges.\r
50            Note: The following package name differs depending on the version\r
51            you are using.\r
52            For Redhat based distributions:\r
53            -----------------\r
54            # rpm -i epson-laser-printer-escpage-1.0.1-1lsb3.2.i486.rpm\r
55            -----------------\r
56            For Debian based distributions:\r
57            -----------------\r
58            # dpkg -i epson-laser-printer-escpage_1.0.1-1lsb3.2_i386.deb\r
59            -----------------\r
60 \r
61        Regarding the building the source code, refer to "6  How to build in non-LSB distribution".\r
62 \r
63 4.2  Settings after installation\r
64    CUPS must be set to enable use of this software.\r
65    Before printing, be sure to carry out the following steps.\r
66 \r
67         4.2.1  Restart CUPS\r
68              Restart CUPS, to enable the installed filter.\r
69              Execute the following command with root privileges.\r
70 \r
71              Example: With Red Hat Linux\r
72              -----------------\r
73              # /etc/init.d/cups restart\r
74              -----------------\r
75              With Debian GNU/Linux\r
76              -----------------\r
77              # /etc/init.d/cupsys restart\r
78              -----------------\r
79 \r
80         4.2.2  Add a printer\r
81 \r
82           Using commands\r
83              Execute the following command with root privileges.\r
84              -----------------\r
85              # lpadmin -p [PRINTER_NAME] -v [DEVICE_URI] -P [PPD_FILE] -E\r
86              -----------------\r
87 \r
88              Options: -p      Specifies the setting name of the printer\r
89                                 -E      Enables the printer\r
90                                 -v      Specifies the driver and connection\r
91                                 -P      Specifies the setting file (PPD file)\r
92 \r
93              Example: With the AL-M2010 printer \r
94              -----------------\r
95              # lpadmin -p al-m2010 -v usb:/EPSON/AL-M2010 -P /opt/epson-laser-printer-escpage/ppds/Epson/Epson-AL-M2010-epson-laser-printer-en.ppd.gz -E\r
96              -----------------\r
97 \r
98              For details of lpadmin, see lpadmin(8).\r
99 \r
100 \r
101           Using a browser\r
102              CUPS is provided with a CGI for settings so that you can set your printer\r
103              using a browser. To add a printer, follow the steps below.\r
104                Note: The following menu items might differ depending on the CUPS\r
105                      version and the environment used.\r
106 \r
107              (1) Turn on the printer, and please be connected to the PC with a USB cable.\r
108              (2) Connect to CUPS Server (Port: 631) with the browser\r
109                  Example: When CUPS is on localhost, access the following URL.\r
110                      -----------------\r
111                      http://localhost:631/\r
112                      -----------------\r
113              (3) Select "Add Printer"\r
114              (4) Enter a printer setting name in "Name", and select "Continue"\r
115                   (Other items are not mandatory)\r
116              (5) In "Device", USB, and select "Continue"\r
117                  Example: With the EP-901A printer, "Model" is displayed as follows.\r
118                      -----------------\r
119                      "AL-M2010 USB #1(AL-M2010)"\r
120                      -----------------\r
121              (6) In "Model", set "EPSON AL-M2010 Printer Driver for Linux", and\r
122                  select "Add Printer"\r
123                  Example: With the AL-M2010 printer, "Model" is displayed as follows.\r
124                      -----------------\r
125                      "EPSON AL-M2010, EPSON AL-M2010 Printer Driver for Linux (en,en,ja,nl,fr,de,it,pt,es,ko,zh_CN,zh_TW)"\r
126                      -----------------\r
127              (6') Instead of steps (6), specify the PPD file directly from "Browse"\r
128                   Example: With the AL-M2010 printer, you would specify the following file.\r
129                       -----------------\r
130                       /opt/epson-laser-printer-escpage/ppds/Epson/Epson-AL-M2010-epson-laser-printer-en.ppd.gz\r
131                       -----------------\r
132 \r
133 This completes adding a printer for this software.\r
134 \r
135 \r
136 -------------------------------------------------------------------------------\r
137 5  Printing\r
138 -------------------------------------------------------------------------------\r
139 5.1  Items to be set\r
140    The following items can be set with this software.\r
141 \r
142   * Paper size\r
143         Select the paper size for your document.\r
144 \r
145    * Print quality\r
146         Select the media type and its print quality for your printing.\r
147 \r
148 \r
149 5.2  Details of setting items\r
150    Followings is a list of setting options available for this software.\r
151 \r
152    * The meaning of the list items\r
153      - Keyword          Text string used when specifying an option\r
154      - Browser display  Text string displayed in the browser window for CUPS settings\r
155      - Explanation      An explanation of the setting\r
156 \r
157    Paper size\r
158       Setting name for optional settings: PageSize or media\r
159       Setting name in the browser: MediaSize\r
160 \r
161       Note: When adding multiple settings in the media option, put paper size\r
162             at the beginning. For the media options, see the CUPS documentation.\r
163 \r
164    Print quality\r
165       Setting name for optional settings: Quality\r
166       Setting name in the browser: Quality\r
167 \r
168 \r
169 5.3  How to set\r
170 \r
171    There are three methods for print settings.\r
172 \r
173    * Using commands\r
174         Use lpoptions. For details of the command, see lpoptions(1).\r
175 \r
176         Example: For the registered printer name al-m2010\r
177             To specify page size = A4, quality = PLAIN_NORMAL\r
178         -----------------\r
179         $ lpoptions -p al-m2010 -o media=A4 -o quality=PLAIN_NORMAL\r
180         -----------------\r
181 \r
182    * Use a browser\r
183         Select "Configure Printer" from the printer window to display\r
184         the setting window.\r
185 \r
186    * Specify options when printing\r
187         As with lpoptions, set options with -o. For details of the commands,\r
188         see lpr(1) and lp(1).\r
189 \r
190 5.4  How to Print\r
191 \r
192    To print, as with the existing LPR, execute the lpr or lp commands.\r
193    The formats that can be printed are as follows.\r
194 \r
195    * Postscript\r
196    * PDF\r
197    * Text\r
198    * Various image files\r
199 \r
200    Example:\r
201       When printing with the defaults\r
202       -----------------\r
203       $ lpr -P PRINTER_NAME <file>\r
204       $ lp -d PRINTER_NAME <file>\r
205       -----------------\r
206 \r
207       With printer_name = al-m2010, media = Legal\r
208       -----------------\r
209       $ lpr -P al-m2010 -o media=Letter <file>\r
210       $ lp -d al-m2010 -o media=Letter <file>\r
211       -----------------\r
212 \r
213 The method of printing depends on the implementation of CUPS.\r
214 For more details, see the CUPS documentation.\r
215 \r
216 -------------------------------------------------------------------------------\r
217 6  How to build in non-LSB distribution\r
218 -------------------------------------------------------------------------------\r
219 6.1  For Redhat based distributions\r
220         6.1.1  Uncompress the src.rpm file\r
221            $ rpm2cpio epson-laser-printer-escpage-1.0.1-1lsb3.2.src.rpm | cpio -id\r
222            $ tar zxvf epson-laser-printer-escpage-1.0.1-1lsb3.2.tar.gz\r
223 \r
224         6.1.2  Configure and Create source tarball\r
225            $ cd epson-laser-printer-escpage-1.2.0\r
226            $ ./autoreconf -fi && ./configure --prefix=/usr && make dist\r
227 \r
228         6.1.3  Create the directory for RPM packages\r
229            $ mkdir -p ~/rpmbuild/SOURCES\r
230            $ mkdir -p ~/rpmbuild/SPECS\r
231            $ mkdir -p ~/rpmbuild/BUILD\r
232            $ mkdir -p ~/rpmbuild/RPMS\r
233            $ mkdir -p ~/rpmbuild/SRPMS\r
234            \r
235            You can specifiy the another directory in ~/.rpmmacros\r
236            \r
237         6.1.4  Copy the source tarball and the spec file to the directory\r
238            $ cp epson-laser-printer-escpage-1.0.1.tar.gz ~/rpmbuild/SOURCES/.\r
239            $ cp epson-laser-printer-escpage.spec ~/rpmbuild/SPECS\r
240 \r
241         6.1.5  Create RPM package\r
242            $ cd ~/rpmbuild/SPECS\r
243            $ rpmbuild -ba --clean epson-laser-printer-escpage.spec\r
244 \r
245 \r
246 6.2  For Debian based distributions\r
247         6.2.1  Uncompress the src.rpm file\r
248            $ rpm2cpio epson-laser-printer-escpage-1.0.1-1lsb3.2.src.rpm | cpio -id\r
249            $ tar zxvf epson-laser-printer-escpage-1.0.1-1lsb3.2.tar.gz\r
250 \r
251         6.2.2  Configure\r
252            $ cd epson-laser-printer-escpage-1.0.1\r
253            $ ./autoreconf -fi && ./configure --prefix=/usr\r
254 \r
255         6.2.3  Create DEB package\r
256            $ make\r
257            $ debuild -us -uc -b\r
258 \r
259 6.3  For other distributions\r
260         6.3.1  Uncompress the src.rpm file\r
261            $ rpm2cpio epson-inkjet-printer-escpage-1.0.1-1lsb3.2.src.rpm | cpio -id\r
262            $ tar zxvf epson-inkjet-printer-escpage-1.0.1-1lsb3.2.tar.gz\r
263 \r
264         6.3.2  Configure\r
265            $ cd epson-laser-printer-escpage-1.0.1\r
266            $ ./autoreconf -fi && ./configure --prefix=/usr\r
267 \r
268         The location of CUPS filter and ppd files are decided automatically,\r
269         but you can specify with the follwing configure options.\r
270         \r
271         * "--with-cupsfilterdir"    The location of CUPS filter\r
272                                     ex) /usr/lib/cups/filter\r
273                                     \r
274         * "--with-cupsppddir"       The location of PPD files\r
275                                     ex) /usr/share/ppd/epson-laser-escpage-raster\r
276 \r
277         6.3.3  Make and Install\r
278            $ cd epson-laser-printer-escpage-1.0.1\r
279            $ make \r
280            $ sudo make install\r
281 \r
282 \r
283 ***End of file\r