enscript.info - enscript - GNU Enscript
(HTM) git clone git://thinkerwim.org/enscript.git
(DIR) Log
(DIR) Files
(DIR) Refs
(DIR) README
(DIR) LICENSE
---
enscript.info (37987B)
---
1 This is enscript.info, produced by makeinfo version 7.0.2 from
2 enscript.texi.
3
4 INFO-DIR-SECTION Utilities
5 START-INFO-DIR-ENTRY
6 * Enscript: (enscript). GNU Enscript
7 END-INFO-DIR-ENTRY
8
9 This file documents GNU enscript 1.6.6
10
11 Copyright (C) 1995, 1998, 1999, 2007, 2009 Free Software Foundation,
12 Inc.
13
14 Permission is granted to copy, distribute and/or modify this document
15 under the terms of the GNU Free Documentation License, Version 1.3 or
16 any later version published by the Free Software Foundation; with no
17 Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
18 copy of the license is included in the section entitled “GNU Free
19 Documentation License”.
20
21
22 File: enscript.info, Node: Top, Next: Introduction, Prev: (dir), Up: (dir)
23
24 GNU enscript
25 ************
26
27 This file documents the GNU enscript program. This edition documents
28 version 1.6.6.
29
30 * Menu:
31
32 * Introduction::
33 * Invoking Enscript::
34 * Basic Printing::
35 * Advanced Usage::
36 * Configuration Files::
37 * Customization::
38 * The states Program::
39 * Writing New Highlighting Definitions::
40 * Index::
41 * Documentation License::
42
43
44 File: enscript.info, Node: Introduction, Next: Invoking Enscript, Prev: Top, Up: Top
45
46 1 Introduction
47 **************
48
49 • overall
50 • design
51
52
53 File: enscript.info, Node: Invoking Enscript, Next: Basic Printing, Prev: Introduction, Up: Top
54
55 2 Invoking Enscript
56 *******************
57
58
59 File: enscript.info, Node: Basic Printing, Next: Advanced Usage, Prev: Invoking Enscript, Up: Top
60
61 3 Basic Printing
62 ****************
63
64 * Menu:
65
66 * Input Encodings::
67 * Selecting Fonts::
68 * Page Headers::
69 * Page Handling::
70 * Highlighting::
71
72
73 File: enscript.info, Node: Input Encodings, Next: Selecting Fonts, Prev: Basic Printing, Up: Basic Printing
74
75 3.1 Input Encodings
76 ===================
77
78
79 File: enscript.info, Node: Selecting Fonts, Next: Page Headers, Prev: Input Encodings, Up: Basic Printing
80
81 3.2 Selecting Fonts
82 ===================
83
84
85 File: enscript.info, Node: Page Headers, Next: Page Handling, Prev: Selecting Fonts, Up: Basic Printing
86
87 3.3 Page Headers
88 ================
89
90
91 File: enscript.info, Node: Page Handling, Next: Highlighting, Prev: Page Headers, Up: Basic Printing
92
93 3.4 Page Handling
94 =================
95
96 * Menu:
97
98 * Page Orientation::
99 * N-up Printing::
100 * Fitting Text to Page::
101
102
103 File: enscript.info, Node: Page Orientation, Next: N-up Printing, Prev: Page Handling, Up: Page Handling
104
105 3.4.1 Page Orientation
106 ----------------------
107
108
109 File: enscript.info, Node: N-up Printing, Next: Fitting Text to Page, Prev: Page Orientation, Up: Page Handling
110
111 3.4.2 N-up Printing
112 -------------------
113
114
115 File: enscript.info, Node: Fitting Text to Page, Prev: N-up Printing, Up: Page Handling
116
117 3.4.3 Fitting Text to Page
118 --------------------------
119
120
121 File: enscript.info, Node: Highlighting, Prev: Page Handling, Up: Basic Printing
122
123 3.5 Highlighting
124 ================
125
126 * Menu:
127
128 * Different Output Languages::
129
130
131 File: enscript.info, Node: Different Output Languages, Prev: Highlighting, Up: Highlighting
132
133 3.5.1 Different Output Languages
134 --------------------------------
135
136
137 File: enscript.info, Node: Advanced Usage, Next: Configuration Files, Prev: Basic Printing, Up: Top
138
139 4 Advanced Usage
140 ****************
141
142 * Menu:
143
144 * Selecting Pages::
145 * Escape Sequences::
146 * Input Filters::
147 * Slice Printing::
148 * PostScript Printer Controlling::
149 * Pass-Through Mode::
150
151
152 File: enscript.info, Node: Selecting Pages, Next: Escape Sequences, Prev: Advanced Usage, Up: Advanced Usage
153
154 4.1 Selecting Pages
155 ===================
156
157
158 File: enscript.info, Node: Escape Sequences, Next: Input Filters, Prev: Selecting Pages, Up: Advanced Usage
159
160 4.2 Escape Sequences
161 ====================
162
163
164 File: enscript.info, Node: Input Filters, Next: Slice Printing, Prev: Escape Sequences, Up: Advanced Usage
165
166 4.3 Input Filters
167 =================
168
169
170 File: enscript.info, Node: Slice Printing, Next: PostScript Printer Controlling, Prev: Input Filters, Up: Advanced Usage
171
172 4.4 Slice Printing
173 ==================
174
175
176 File: enscript.info, Node: PostScript Printer Controlling, Next: Pass-Through Mode, Prev: Slice Printing, Up: Advanced Usage
177
178 4.5 PostScript Printer Controlling
179 ==================================
180
181
182 File: enscript.info, Node: Pass-Through Mode, Prev: PostScript Printer Controlling, Up: Advanced Usage
183
184 4.6 Pass-Through Mode
185 =====================
186
187
188 File: enscript.info, Node: Configuration Files, Next: Customization, Prev: Advanced Usage, Up: Top
189
190 5 Configuration Files
191 *********************
192
193
194 File: enscript.info, Node: Customization, Next: The states Program, Prev: Configuration Files, Up: Top
195
196 6 Customization
197 ***************
198
199 * Menu:
200
201 * Output Media::
202 * User-Defined Fancy Headers::
203
204
205 File: enscript.info, Node: Output Media, Next: User-Defined Fancy Headers, Prev: Customization, Up: Customization
206
207 6.1 Output Media
208 ================
209
210
211 File: enscript.info, Node: User-Defined Fancy Headers, Prev: Output Media, Up: Customization
212
213 6.2 User-Defined Fancy Headers
214 ==============================
215
216
217 File: enscript.info, Node: The states Program, Next: Writing New Highlighting Definitions, Prev: Customization, Up: Top
218
219 7 The ‘states’ Program
220 **********************
221
222
223 File: enscript.info, Node: Writing New Highlighting Definitions, Next: Index, Prev: The states Program, Up: Top
224
225 8 Writing New Highlighting Definitions
226 **************************************
227
228 The highlighting works in three separate phases. First, the
229 “highlighing rules” process the input stream and parse it into logical
230 components. The components are called “faces”. A face presents one
231 logical component of the input language, for example, a keyword, a
232 comment, etc.. The enscript’s highlighting model defines the following
233 faces:
234
235 bold
236 italic
237 bold_italic
238 Hard-coded faces for the bold, italic, and bold-italice text types.
239 These faces define the exact presentation of the face font, so the
240 style files have very little power in customizing their outlook.
241 These faces should be avoided as much as possible.
242
243 comment
244 A comment, normally in a programming language.
245
246 function_name
247 A function name. The function names are normally recognized from
248 function definitions, not from an use of the function.
249
250 variable_name
251 A variable name. The variable names are normally recognized from
252 function, type, and variable definitions.
253
254 keyword
255 A reserved keyword. Normally, all occurrences of the keywords are
256 recognized.
257
258 reference
259 A reference to another location in a file or to another file or
260 resource. For example, in the C-language, the goto targets are
261 references.
262
263 string
264 A string literal.
265
266 builtin
267 A builtin function or property. Normally, all occurrences of the
268 builtins are recognized.
269
270 type
271 A type specifier. The types are normally recognized from function,
272 type, and variable definitions.
273
274 As the second step, the “output style” specifies how the faces are
275 presented in the generated output. Each face has the following
276 properties:
277
278 fontname
279 The PostScript font name of the the font that is used for the face.
280 This property is used only for the PostScript outputs.
281
282 boldp
283 A boolean flag which tells whether the face should be printed in
284 bold font. This property is used for all output languages except
285 for the PostScript which uses the fontname property.
286
287 italicp
288 A boolean flag which tells whether the face shuold be printed with
289 italic font. This property is used for all output languages except
290 for the PostScript which uses the fontname property.
291
292 fg_color
293 The foreground color of the face.
294
295 bg_color
296 The background color of the face. This property is not implemented
297 on all output languages.
298
299 Finally, the “output language” describes how the faces and other text
300 are presented in the output language. The output language defines a set
301 of functions which are called to generate the output.
302
303 * Menu:
304
305 * Highlighting Rules::
306 * Styles::
307 * Output Languages::
308
309
310 File: enscript.info, Node: Highlighting Rules, Next: Styles, Prev: Writing New Highlighting Definitions, Up: Writing New Highlighting Definitions
311
312 8.1 Highlighting Rules
313 ======================
314
315
316 File: enscript.info, Node: Styles, Next: Output Languages, Prev: Highlighting Rules, Up: Writing New Highlighting Definitions
317
318 8.2 Styles
319 ==========
320
321
322 File: enscript.info, Node: Output Languages, Prev: Styles, Up: Writing New Highlighting Definitions
323
324 8.3 Output Languages
325 ====================
326
327 -- Function: map_color (r, g, b)
328
329 -- Function: language_print (string)
330
331 -- Function: language_symbol (symbol)
332
333 -- Function: header ()
334
335 -- Function: trailer ()
336
337 -- Function: face_on (face)
338
339 -- Function: face_off (face)
340
341 -- Variable: LANGUAGE_SPECIALS
342
343 The following example creates a new output language ‘simple_html’
344 that creates simple HTML outputs. The output language is defined in a
345 file called ‘lang_simple_html.st’. The file must define a state called
346 ‘lang_simple_html’. The file can be located in any directory that is in
347 the load path of the states program.
348
349 The output language definitions are defined in the ‘BEGIN’ block of
350 the ‘lang_simple_html’ state. Please, note that the ‘BEGIN’ block is
351 ended with a ‘return’-statement. This statement will return the control
352 to the calling state that is the start state of the enscript highlight
353 program. If the ‘return’-statement was omitted, the states would start
354 processing the input with the ‘lang_simple_html’ state which is
355 obviously a wrong choice.
356
357 state lang_simple_html
358 {
359 BEGIN {
360 sub map_color (r, g, b)
361 {
362 return sprintf ("#%02X%02X%02X", r, g, b);
363 }
364
365 sub language_print (str)
366 {
367 str = regsuball (str, /\&/, "&");
368 str = regsuball (str, /</, "<");
369 str = regsuball (str, />/, ">");
370 str = regsuball (str, /\"/, """);
371 print (str);
372 }
373
374 sub language_symbol (symbol)
375 {
376 return false;
377 }
378
379 sub header ()
380 {
381 print ("<html>\n<head>\n<title>Simple HTML Output</title>\n");
382 print ("</head>\n<body>\n");
383 }
384
385 sub trailer ()
386 {
387 print ("</body>\n</html>\n");
388 }
389
390 sub fase_on (face)
391 {
392 if (face(boldp])
393 print ("<B>");
394 if (face(italicp])
395 print ("<I>");
396 if (face[fg_color])
397 print ("<FONT COLOR=\", face[fg_color], "\">");
398 }
399
400 sub face_off (face)
401 {
402 if (face[fg_color])
403 print ("</FONT>");
404 if (face[italicp])
405 print ("</I>");
406 if (face[boldp])
407 print ("</B>");
408 }
409
410 LANGUAGE_SPECIALS = /[<>\&\"]/;
411
412 return;
413 }
414 }
415
416
417 File: enscript.info, Node: Index, Next: Documentation License, Prev: Writing New Highlighting Definitions, Up: Top
418
419 Index
420 *****
421
422 423 * Menu:
424
425 * face_off: Output Languages. (line 18)
426 * face_on: Output Languages. (line 16)
427 * header: Output Languages. (line 12)
428 * language_print: Output Languages. (line 8)
429 * LANGUAGE_SPECIALS: Output Languages. (line 20)
430 * language_symbol: Output Languages. (line 10)
431 * map_color: Output Languages. (line 6)
432 * trailer: Output Languages. (line 14)
433
434
435 File: enscript.info, Node: Documentation License, Prev: Index, Up: Top
436
437 Appendix A Documentation License
438 ********************************
439
440 Version 1.3, 3 November 2008
441
442 Copyright © 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc.
443 <http://fsf.org/>
444
445 Everyone is permitted to copy and distribute verbatim copies
446 of this license document, but changing it is not allowed.
447
448 0. PREAMBLE
449
450 The purpose of this License is to make a manual, textbook, or other
451 functional and useful document “free” in the sense of freedom: to
452 assure everyone the effective freedom to copy and redistribute it,
453 with or without modifying it, either commercially or
454 noncommercially. Secondarily, this License preserves for the
455 author and publisher a way to get credit for their work, while not
456 being considered responsible for modifications made by others.
457
458 This License is a kind of “copyleft”, which means that derivative
459 works of the document must themselves be free in the same sense.
460 It complements the GNU General Public License, which is a copyleft
461 license designed for free software.
462
463 We have designed this License in order to use it for manuals for
464 free software, because free software needs free documentation: a
465 free program should come with manuals providing the same freedoms
466 that the software does. But this License is not limited to
467 software manuals; it can be used for any textual work, regardless
468 of subject matter or whether it is published as a printed book. We
469 recommend this License principally for works whose purpose is
470 instruction or reference.
471
472 1. APPLICABILITY AND DEFINITIONS
473
474 This License applies to any manual or other work, in any medium,
475 that contains a notice placed by the copyright holder saying it can
476 be distributed under the terms of this License. Such a notice
477 grants a world-wide, royalty-free license, unlimited in duration,
478 to use that work under the conditions stated herein. The
479 “Document”, below, refers to any such manual or work. Any member
480 of the public is a licensee, and is addressed as “you”. You accept
481 the license if you copy, modify or distribute the work in a way
482 requiring permission under copyright law.
483
484 A “Modified Version” of the Document means any work containing the
485 Document or a portion of it, either copied verbatim, or with
486 modifications and/or translated into another language.
487
488 A “Secondary Section” is a named appendix or a front-matter section
489 of the Document that deals exclusively with the relationship of the
490 publishers or authors of the Document to the Document’s overall
491 subject (or to related matters) and contains nothing that could
492 fall directly within that overall subject. (Thus, if the Document
493 is in part a textbook of mathematics, a Secondary Section may not
494 explain any mathematics.) The relationship could be a matter of
495 historical connection with the subject or with related matters, or
496 of legal, commercial, philosophical, ethical or political position
497 regarding them.
498
499 The “Invariant Sections” are certain Secondary Sections whose
500 titles are designated, as being those of Invariant Sections, in the
501 notice that says that the Document is released under this License.
502 If a section does not fit the above definition of Secondary then it
503 is not allowed to be designated as Invariant. The Document may
504 contain zero Invariant Sections. If the Document does not identify
505 any Invariant Sections then there are none.
506
507 The “Cover Texts” are certain short passages of text that are
508 listed, as Front-Cover Texts or Back-Cover Texts, in the notice
509 that says that the Document is released under this License. A
510 Front-Cover Text may be at most 5 words, and a Back-Cover Text may
511 be at most 25 words.
512
513 A “Transparent” copy of the Document means a machine-readable copy,
514 represented in a format whose specification is available to the
515 general public, that is suitable for revising the document
516 straightforwardly with generic text editors or (for images composed
517 of pixels) generic paint programs or (for drawings) some widely
518 available drawing editor, and that is suitable for input to text
519 formatters or for automatic translation to a variety of formats
520 suitable for input to text formatters. A copy made in an otherwise
521 Transparent file format whose markup, or absence of markup, has
522 been arranged to thwart or discourage subsequent modification by
523 readers is not Transparent. An image format is not Transparent if
524 used for any substantial amount of text. A copy that is not
525 “Transparent” is called “Opaque”.
526
527 Examples of suitable formats for Transparent copies include plain
528 ASCII without markup, Texinfo input format, LaTeX input format,
529 SGML or XML using a publicly available DTD, and standard-conforming
530 simple HTML, PostScript or PDF designed for human modification.
531 Examples of transparent image formats include PNG, XCF and JPG.
532 Opaque formats include proprietary formats that can be read and
533 edited only by proprietary word processors, SGML or XML for which
534 the DTD and/or processing tools are not generally available, and
535 the machine-generated HTML, PostScript or PDF produced by some word
536 processors for output purposes only.
537
538 The “Title Page” means, for a printed book, the title page itself,
539 plus such following pages as are needed to hold, legibly, the
540 material this License requires to appear in the title page. For
541 works in formats which do not have any title page as such, “Title
542 Page” means the text near the most prominent appearance of the
543 work’s title, preceding the beginning of the body of the text.
544
545 The “publisher” means any person or entity that distributes copies
546 of the Document to the public.
547
548 A section “Entitled XYZ” means a named subunit of the Document
549 whose title either is precisely XYZ or contains XYZ in parentheses
550 following text that translates XYZ in another language. (Here XYZ
551 stands for a specific section name mentioned below, such as
552 “Acknowledgements”, “Dedications”, “Endorsements”, or “History”.)
553 To “Preserve the Title” of such a section when you modify the
554 Document means that it remains a section “Entitled XYZ” according
555 to this definition.
556
557 The Document may include Warranty Disclaimers next to the notice
558 which states that this License applies to the Document. These
559 Warranty Disclaimers are considered to be included by reference in
560 this License, but only as regards disclaiming warranties: any other
561 implication that these Warranty Disclaimers may have is void and
562 has no effect on the meaning of this License.
563
564 2. VERBATIM COPYING
565
566 You may copy and distribute the Document in any medium, either
567 commercially or noncommercially, provided that this License, the
568 copyright notices, and the license notice saying this License
569 applies to the Document are reproduced in all copies, and that you
570 add no other conditions whatsoever to those of this License. You
571 may not use technical measures to obstruct or control the reading
572 or further copying of the copies you make or distribute. However,
573 you may accept compensation in exchange for copies. If you
574 distribute a large enough number of copies you must also follow the
575 conditions in section 3.
576
577 You may also lend copies, under the same conditions stated above,
578 and you may publicly display copies.
579
580 3. COPYING IN QUANTITY
581
582 If you publish printed copies (or copies in media that commonly
583 have printed covers) of the Document, numbering more than 100, and
584 the Document’s license notice requires Cover Texts, you must
585 enclose the copies in covers that carry, clearly and legibly, all
586 these Cover Texts: Front-Cover Texts on the front cover, and
587 Back-Cover Texts on the back cover. Both covers must also clearly
588 and legibly identify you as the publisher of these copies. The
589 front cover must present the full title with all words of the title
590 equally prominent and visible. You may add other material on the
591 covers in addition. Copying with changes limited to the covers, as
592 long as they preserve the title of the Document and satisfy these
593 conditions, can be treated as verbatim copying in other respects.
594
595 If the required texts for either cover are too voluminous to fit
596 legibly, you should put the first ones listed (as many as fit
597 reasonably) on the actual cover, and continue the rest onto
598 adjacent pages.
599
600 If you publish or distribute Opaque copies of the Document
601 numbering more than 100, you must either include a machine-readable
602 Transparent copy along with each Opaque copy, or state in or with
603 each Opaque copy a computer-network location from which the general
604 network-using public has access to download using public-standard
605 network protocols a complete Transparent copy of the Document, free
606 of added material. If you use the latter option, you must take
607 reasonably prudent steps, when you begin distribution of Opaque
608 copies in quantity, to ensure that this Transparent copy will
609 remain thus accessible at the stated location until at least one
610 year after the last time you distribute an Opaque copy (directly or
611 through your agents or retailers) of that edition to the public.
612
613 It is requested, but not required, that you contact the authors of
614 the Document well before redistributing any large number of copies,
615 to give them a chance to provide you with an updated version of the
616 Document.
617
618 4. MODIFICATIONS
619
620 You may copy and distribute a Modified Version of the Document
621 under the conditions of sections 2 and 3 above, provided that you
622 release the Modified Version under precisely this License, with the
623 Modified Version filling the role of the Document, thus licensing
624 distribution and modification of the Modified Version to whoever
625 possesses a copy of it. In addition, you must do these things in
626 the Modified Version:
627
628 A. Use in the Title Page (and on the covers, if any) a title
629 distinct from that of the Document, and from those of previous
630 versions (which should, if there were any, be listed in the
631 History section of the Document). You may use the same title
632 as a previous version if the original publisher of that
633 version gives permission.
634
635 B. List on the Title Page, as authors, one or more persons or
636 entities responsible for authorship of the modifications in
637 the Modified Version, together with at least five of the
638 principal authors of the Document (all of its principal
639 authors, if it has fewer than five), unless they release you
640 from this requirement.
641
642 C. State on the Title page the name of the publisher of the
643 Modified Version, as the publisher.
644
645 D. Preserve all the copyright notices of the Document.
646
647 E. Add an appropriate copyright notice for your modifications
648 adjacent to the other copyright notices.
649
650 F. Include, immediately after the copyright notices, a license
651 notice giving the public permission to use the Modified
652 Version under the terms of this License, in the form shown in
653 the Addendum below.
654
655 G. Preserve in that license notice the full lists of Invariant
656 Sections and required Cover Texts given in the Document’s
657 license notice.
658
659 H. Include an unaltered copy of this License.
660
661 I. Preserve the section Entitled “History”, Preserve its Title,
662 and add to it an item stating at least the title, year, new
663 authors, and publisher of the Modified Version as given on the
664 Title Page. If there is no section Entitled “History” in the
665 Document, create one stating the title, year, authors, and
666 publisher of the Document as given on its Title Page, then add
667 an item describing the Modified Version as stated in the
668 previous sentence.
669
670 J. Preserve the network location, if any, given in the Document
671 for public access to a Transparent copy of the Document, and
672 likewise the network locations given in the Document for
673 previous versions it was based on. These may be placed in the
674 “History” section. You may omit a network location for a work
675 that was published at least four years before the Document
676 itself, or if the original publisher of the version it refers
677 to gives permission.
678
679 K. For any section Entitled “Acknowledgements” or “Dedications”,
680 Preserve the Title of the section, and preserve in the section
681 all the substance and tone of each of the contributor
682 acknowledgements and/or dedications given therein.
683
684 L. Preserve all the Invariant Sections of the Document, unaltered
685 in their text and in their titles. Section numbers or the
686 equivalent are not considered part of the section titles.
687
688 M. Delete any section Entitled “Endorsements”. Such a section
689 may not be included in the Modified Version.
690
691 N. Do not retitle any existing section to be Entitled
692 “Endorsements” or to conflict in title with any Invariant
693 Section.
694
695 O. Preserve any Warranty Disclaimers.
696
697 If the Modified Version includes new front-matter sections or
698 appendices that qualify as Secondary Sections and contain no
699 material copied from the Document, you may at your option designate
700 some or all of these sections as invariant. To do this, add their
701 titles to the list of Invariant Sections in the Modified Version’s
702 license notice. These titles must be distinct from any other
703 section titles.
704
705 You may add a section Entitled “Endorsements”, provided it contains
706 nothing but endorsements of your Modified Version by various
707 parties—for example, statements of peer review or that the text has
708 been approved by an organization as the authoritative definition of
709 a standard.
710
711 You may add a passage of up to five words as a Front-Cover Text,
712 and a passage of up to 25 words as a Back-Cover Text, to the end of
713 the list of Cover Texts in the Modified Version. Only one passage
714 of Front-Cover Text and one of Back-Cover Text may be added by (or
715 through arrangements made by) any one entity. If the Document
716 already includes a cover text for the same cover, previously added
717 by you or by arrangement made by the same entity you are acting on
718 behalf of, you may not add another; but you may replace the old
719 one, on explicit permission from the previous publisher that added
720 the old one.
721
722 The author(s) and publisher(s) of the Document do not by this
723 License give permission to use their names for publicity for or to
724 assert or imply endorsement of any Modified Version.
725
726 5. COMBINING DOCUMENTS
727
728 You may combine the Document with other documents released under
729 this License, under the terms defined in section 4 above for
730 modified versions, provided that you include in the combination all
731 of the Invariant Sections of all of the original documents,
732 unmodified, and list them all as Invariant Sections of your
733 combined work in its license notice, and that you preserve all
734 their Warranty Disclaimers.
735
736 The combined work need only contain one copy of this License, and
737 multiple identical Invariant Sections may be replaced with a single
738 copy. If there are multiple Invariant Sections with the same name
739 but different contents, make the title of each such section unique
740 by adding at the end of it, in parentheses, the name of the
741 original author or publisher of that section if known, or else a
742 unique number. Make the same adjustment to the section titles in
743 the list of Invariant Sections in the license notice of the
744 combined work.
745
746 In the combination, you must combine any sections Entitled
747 “History” in the various original documents, forming one section
748 Entitled “History”; likewise combine any sections Entitled
749 “Acknowledgements”, and any sections Entitled “Dedications”. You
750 must delete all sections Entitled “Endorsements.”
751
752 6. COLLECTIONS OF DOCUMENTS
753
754 You may make a collection consisting of the Document and other
755 documents released under this License, and replace the individual
756 copies of this License in the various documents with a single copy
757 that is included in the collection, provided that you follow the
758 rules of this License for verbatim copying of each of the documents
759 in all other respects.
760
761 You may extract a single document from such a collection, and
762 distribute it individually under this License, provided you insert
763 a copy of this License into the extracted document, and follow this
764 License in all other respects regarding verbatim copying of that
765 document.
766
767 7. AGGREGATION WITH INDEPENDENT WORKS
768
769 A compilation of the Document or its derivatives with other
770 separate and independent documents or works, in or on a volume of a
771 storage or distribution medium, is called an “aggregate” if the
772 copyright resulting from the compilation is not used to limit the
773 legal rights of the compilation’s users beyond what the individual
774 works permit. When the Document is included in an aggregate, this
775 License does not apply to the other works in the aggregate which
776 are not themselves derivative works of the Document.
777
778 If the Cover Text requirement of section 3 is applicable to these
779 copies of the Document, then if the Document is less than one half
780 of the entire aggregate, the Document’s Cover Texts may be placed
781 on covers that bracket the Document within the aggregate, or the
782 electronic equivalent of covers if the Document is in electronic
783 form. Otherwise they must appear on printed covers that bracket
784 the whole aggregate.
785
786 8. TRANSLATION
787
788 Translation is considered a kind of modification, so you may
789 distribute translations of the Document under the terms of section
790 4. Replacing Invariant Sections with translations requires special
791 permission from their copyright holders, but you may include
792 translations of some or all Invariant Sections in addition to the
793 original versions of these Invariant Sections. You may include a
794 translation of this License, and all the license notices in the
795 Document, and any Warranty Disclaimers, provided that you also
796 include the original English version of this License and the
797 original versions of those notices and disclaimers. In case of a
798 disagreement between the translation and the original version of
799 this License or a notice or disclaimer, the original version will
800 prevail.
801
802 If a section in the Document is Entitled “Acknowledgements”,
803 “Dedications”, or “History”, the requirement (section 4) to
804 Preserve its Title (section 1) will typically require changing the
805 actual title.
806
807 9. TERMINATION
808
809 You may not copy, modify, sublicense, or distribute the Document
810 except as expressly provided under this License. Any attempt
811 otherwise to copy, modify, sublicense, or distribute it is void,
812 and will automatically terminate your rights under this License.
813
814 However, if you cease all violation of this License, then your
815 license from a particular copyright holder is reinstated (a)
816 provisionally, unless and until the copyright holder explicitly and
817 finally terminates your license, and (b) permanently, if the
818 copyright holder fails to notify you of the violation by some
819 reasonable means prior to 60 days after the cessation.
820
821 Moreover, your license from a particular copyright holder is
822 reinstated permanently if the copyright holder notifies you of the
823 violation by some reasonable means, this is the first time you have
824 received notice of violation of this License (for any work) from
825 that copyright holder, and you cure the violation prior to 30 days
826 after your receipt of the notice.
827
828 Termination of your rights under this section does not terminate
829 the licenses of parties who have received copies or rights from you
830 under this License. If your rights have been terminated and not
831 permanently reinstated, receipt of a copy of some or all of the
832 same material does not give you any rights to use it.
833
834 10. FUTURE REVISIONS OF THIS LICENSE
835
836 The Free Software Foundation may publish new, revised versions of
837 the GNU Free Documentation License from time to time. Such new
838 versions will be similar in spirit to the present version, but may
839 differ in detail to address new problems or concerns. See
840 <http://www.gnu.org/copyleft/>.
841
842 Each version of the License is given a distinguishing version
843 number. If the Document specifies that a particular numbered
844 version of this License “or any later version” applies to it, you
845 have the option of following the terms and conditions either of
846 that specified version or of any later version that has been
847 published (not as a draft) by the Free Software Foundation. If the
848 Document does not specify a version number of this License, you may
849 choose any version ever published (not as a draft) by the Free
850 Software Foundation. If the Document specifies that a proxy can
851 decide which future versions of this License can be used, that
852 proxy’s public statement of acceptance of a version permanently
853 authorizes you to choose that version for the Document.
854
855 11. RELICENSING
856
857 “Massive Multiauthor Collaboration Site” (or “MMC Site”) means any
858 World Wide Web server that publishes copyrightable works and also
859 provides prominent facilities for anybody to edit those works. A
860 public wiki that anybody can edit is an example of such a server.
861 A “Massive Multiauthor Collaboration” (or “MMC”) contained in the
862 site means any set of copyrightable works thus published on the MMC
863 site.
864
865 “CC-BY-SA” means the Creative Commons Attribution-Share Alike 3.0
866 license published by Creative Commons Corporation, a not-for-profit
867 corporation with a principal place of business in San Francisco,
868 California, as well as future copyleft versions of that license
869 published by that same organization.
870
871 “Incorporate” means to publish or republish a Document, in whole or
872 in part, as part of another Document.
873
874 An MMC is “eligible for relicensing” if it is licensed under this
875 License, and if all works that were first published under this
876 License somewhere other than this MMC, and subsequently
877 incorporated in whole or in part into the MMC, (1) had no cover
878 texts or invariant sections, and (2) were thus incorporated prior
879 to November 1, 2008.
880
881 The operator of an MMC Site may republish an MMC contained in the
882 site under CC-BY-SA on the same site at any time before August 1,
883 2009, provided the MMC is eligible for relicensing.
884
885 ADDENDUM: How to use this License for your documents
886 ====================================================
887
888 To use this License in a document you have written, include a copy of
889 the License in the document and put the following copyright and license
890 notices just after the title page:
891
892 Copyright (C) YEAR YOUR NAME.
893 Permission is granted to copy, distribute and/or modify this document
894 under the terms of the GNU Free Documentation License, Version 1.3
895 or any later version published by the Free Software Foundation;
896 with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
897 Texts. A copy of the license is included in the section entitled ``GNU
898 Free Documentation License''.
899
900 If you have Invariant Sections, Front-Cover Texts and Back-Cover
901 Texts, replace the “with...Texts.” line with this:
902
903 with the Invariant Sections being LIST THEIR TITLES, with
904 the Front-Cover Texts being LIST, and with the Back-Cover Texts
905 being LIST.
906
907 If you have Invariant Sections without Cover Texts, or some other
908 combination of the three, merge those two alternatives to suit the
909 situation.
910
911 If your document contains nontrivial examples of program code, we
912 recommend releasing these examples in parallel under your choice of free
913 software license, such as the GNU General Public License, to permit
914 their use in free software.
915
916
917
918 Tag Table:
919 Node: Top684
920 Node: Introduction1108
921 Node: Invoking Enscript1261
922 Node: Basic Printing1405
923 Node: Input Encodings1647
924 Node: Selecting Fonts1803
925 Node: Page Headers1957
926 Node: Page Handling2103
927 Node: Page Orientation2322
928 Node: N-up Printing2481
929 Node: Fitting Text to Page2641
930 Node: Highlighting2790
931 Node: Different Output Languages2953
932 Node: Advanced Usage3118
933 Node: Selecting Pages3405
934 Node: Escape Sequences3562
935 Node: Input Filters3720
936 Node: Slice Printing3871
937 Node: PostScript Printer Controlling4038
938 Node: Pass-Through Mode4241
939 Node: Configuration Files4395
940 Node: Customization4546
941 Node: Output Media4747
942 Node: User-Defined Fancy Headers4903
943 Node: The states Program5065
944 Node: Writing New Highlighting Definitions5243
945 Node: Highlighting Rules8100
946 Node: Styles8300
947 Node: Output Languages8456
948 Node: Index11003
949 Node: Documentation License11744
950
951 End Tag Table
952
953
954 Local Variables:
955 coding: utf-8
956 End: