Browse Source

Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdegraphics@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19
toma 9 years ago
commit
47d455dd55
100 changed files with 12284 additions and 0 deletions
  1. 3
    0
      AUTHORS
  2. 347
    0
      COPYING
  3. 397
    0
      COPYING-DOCS
  4. 17
    0
      ChangeLog
  5. 176
    0
      INSTALL
  6. 16
    0
      Mainpage.dox
  7. 22
    0
      Makefile.am.in
  8. 16
    0
      Makefile.cvs
  9. 97
    0
      README
  10. 17
    0
      configure.in.in
  11. 5
    0
      doc/Makefile.am
  12. 4
    0
      doc/kamera/Makefile.am
  13. 78
    0
      doc/kamera/index.docbook
  14. 4
    0
      doc/kcoloredit/Makefile.am
  15. 468
    0
      doc/kcoloredit/index.docbook
  16. BIN
      doc/kdvi/KDVI-features.dvi
  17. 480
    0
      doc/kdvi/KDVI-features.tex
  18. 4
    0
      doc/kdvi/Makefile.am
  19. 3351
    0
      doc/kdvi/aboutkde.ps
  20. 1072
    0
      doc/kdvi/index.docbook
  21. 102
    0
      doc/kdvi/kdvi-search.el
  22. BIN
      doc/kdvi/optionrequester1.png
  23. BIN
      doc/kdvi/optionrequester2.png
  24. 184
    0
      doc/kdvi/srcltx.sty
  25. 146
    0
      doc/kdvi/srctex.sty
  26. 4
    0
      doc/kgamma/Makefile.am
  27. 234
    0
      doc/kgamma/index.docbook
  28. 4
    0
      doc/kghostview/Makefile.am
  29. 755
    0
      doc/kghostview/index.docbook
  30. 4
    0
      doc/kiconedit/Makefile.am
  31. 1083
    0
      doc/kiconedit/index.docbook
  32. BIN
      doc/kiconedit/kiconedit-configuration.png
  33. 2
    0
      doc/kolourpaint/Makefile.am
  34. BIN
      doc/kolourpaint/brush_shapes.png
  35. BIN
      doc/kolourpaint/color_box.png
  36. BIN
      doc/kolourpaint/eraser_shapes.png
  37. BIN
      doc/kolourpaint/fcc_std_text.png
  38. BIN
      doc/kolourpaint/fcc_trans_text.png
  39. BIN
      doc/kolourpaint/fill_color_similarity.png
  40. BIN
      doc/kolourpaint/fill_style.png
  41. BIN
      doc/kolourpaint/image_balance.png
  42. BIN
      doc/kolourpaint/image_emboss.png
  43. BIN
      doc/kolourpaint/image_flatten.png
  44. BIN
      doc/kolourpaint/image_flip.png
  45. BIN
      doc/kolourpaint/image_invert.png
  46. BIN
      doc/kolourpaint/image_reduce_colors.png
  47. BIN
      doc/kolourpaint/image_resize_scale.png
  48. BIN
      doc/kolourpaint/image_rotate.png
  49. BIN
      doc/kolourpaint/image_skew.png
  50. BIN
      doc/kolourpaint/image_soften_sharpen.png
  51. 1501
    0
      doc/kolourpaint/index.docbook
  52. BIN
      doc/kolourpaint/kolourpaint-main.png
  53. BIN
      doc/kolourpaint/line_width.png
  54. BIN
      doc/kolourpaint/lines_30_45_deg.png
  55. BIN
      doc/kolourpaint/lines_30_deg.png
  56. BIN
      doc/kolourpaint/lines_45_deg.png
  57. BIN
      doc/kolourpaint/rotate_image_30.png
  58. BIN
      doc/kolourpaint/rotate_selection_30.png
  59. BIN
      doc/kolourpaint/selections_opaque_transparent.png
  60. BIN
      doc/kolourpaint/spraycan_patterns.png
  61. BIN
      doc/kolourpaint/text_zoom_grid.png
  62. BIN
      doc/kolourpaint/tool_brush.png
  63. BIN
      doc/kolourpaint/tool_color_picker.png
  64. BIN
      doc/kolourpaint/tool_color_washer.png
  65. BIN
      doc/kolourpaint/tool_curve.png
  66. BIN
      doc/kolourpaint/tool_ellipse.png
  67. BIN
      doc/kolourpaint/tool_elliptical_selection.png
  68. BIN
      doc/kolourpaint/tool_eraser.png
  69. BIN
      doc/kolourpaint/tool_flood_fill.png
  70. BIN
      doc/kolourpaint/tool_free_form_selection.png
  71. BIN
      doc/kolourpaint/tool_line.png
  72. BIN
      doc/kolourpaint/tool_pen.png
  73. BIN
      doc/kolourpaint/tool_polygon.png
  74. BIN
      doc/kolourpaint/tool_polyline.png
  75. BIN
      doc/kolourpaint/tool_polystar.png
  76. BIN
      doc/kolourpaint/tool_rect_selection.png
  77. BIN
      doc/kolourpaint/tool_rectangle.png
  78. BIN
      doc/kolourpaint/tool_rectangles.png
  79. BIN
      doc/kolourpaint/tool_rounded_rectangle.png
  80. BIN
      doc/kolourpaint/tool_selections.png
  81. BIN
      doc/kolourpaint/tool_spraycan.png
  82. BIN
      doc/kolourpaint/tool_text.png
  83. BIN
      doc/kolourpaint/view_thumbnails.png
  84. 4
    0
      doc/kooka/Makefile.am
  85. 747
    0
      doc/kooka/index.docbook
  86. BIN
      doc/kooka/kooka_gocr.png
  87. BIN
      doc/kooka/kooka_gocr_result.png
  88. BIN
      doc/kooka/kooka_mainctrl.png
  89. BIN
      doc/kooka/ocr-select.png
  90. BIN
      doc/kooka/shortcut0.png
  91. BIN
      doc/kooka/shortcut1.png
  92. BIN
      doc/kooka/toolbar.png
  93. BIN
      doc/kooka/toolbar1.png
  94. BIN
      doc/kooka/toolbar2.png
  95. 4
    0
      doc/kpdf/Makefile.am
  96. BIN
      doc/kpdf/configure.png
  97. 932
    0
      doc/kpdf/index.docbook
  98. 4
    0
      doc/kpovmodeler/Makefile.am
  99. BIN
      doc/kpovmodeler/cameraview.png
  100. 0
    0
      doc/kpovmodeler/controlpoints.png

+ 3
- 0
AUTHORS View File

@@ -0,0 +1,3 @@
1
+
2
+Look in the subdirs to get info about the authors.
3
+

+ 347
- 0
COPYING View File

@@ -0,0 +1,347 @@
1
+NOTE! The GPL below is copyrighted by the Free Software Foundation, but
2
+the instance of code that it refers to (the kde programs) are copyrighted
3
+by the authors who actually wrote it.
4
+
5
+---------------------------------------------------------------------------
6
+			
7
+		    GNU GENERAL PUBLIC LICENSE
8
+		       Version 2, June 1991
9
+
10
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc.
11
+               51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
12
+ Everyone is permitted to copy and distribute verbatim copies
13
+ of this license document, but changing it is not allowed.
14
+
15
+			    Preamble
16
+
17
+  The licenses for most software are designed to take away your
18
+freedom to share and change it.  By contrast, the GNU General Public
19
+License is intended to guarantee your freedom to share and change free
20
+software--to make sure the software is free for all its users.  This
21
+General Public License applies to most of the Free Software
22
+Foundation's software and to any other program whose authors commit to
23
+using it.  (Some other Free Software Foundation software is covered by
24
+the GNU Library General Public License instead.)  You can apply it to
25
+your programs, too.
26
+
27
+  When we speak of free software, we are referring to freedom, not
28
+price.  Our General Public Licenses are designed to make sure that you
29
+have the freedom to distribute copies of free software (and charge for
30
+this service if you wish), that you receive source code or can get it
31
+if you want it, that you can change the software or use pieces of it
32
+in new free programs; and that you know you can do these things.
33
+
34
+  To protect your rights, we need to make restrictions that forbid
35
+anyone to deny you these rights or to ask you to surrender the rights.
36
+These restrictions translate to certain responsibilities for you if you
37
+distribute copies of the software, or if you modify it.
38
+
39
+  For example, if you distribute copies of such a program, whether
40
+gratis or for a fee, you must give the recipients all the rights that
41
+you have.  You must make sure that they, too, receive or can get the
42
+source code.  And you must show them these terms so they know their
43
+rights.
44
+
45
+  We protect your rights with two steps: (1) copyright the software, and
46
+(2) offer you this license which gives you legal permission to copy,
47
+distribute and/or modify the software.
48
+
49
+  Also, for each author's protection and ours, we want to make certain
50
+that everyone understands that there is no warranty for this free
51
+software.  If the software is modified by someone else and passed on, we
52
+want its recipients to know that what they have is not the original, so
53
+that any problems introduced by others will not reflect on the original
54
+authors' reputations.
55
+
56
+  Finally, any free program is threatened constantly by software
57
+patents.  We wish to avoid the danger that redistributors of a free
58
+program will individually obtain patent licenses, in effect making the
59
+program proprietary.  To prevent this, we have made it clear that any
60
+patent must be licensed for everyone's free use or not licensed at all.
61
+
62
+  The precise terms and conditions for copying, distribution and
63
+modification follow.
64
+
65
+		    GNU GENERAL PUBLIC LICENSE
66
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
67
+
68
+  0. This License applies to any program or other work which contains
69
+a notice placed by the copyright holder saying it may be distributed
70
+under the terms of this General Public License.  The "Program", below,
71
+refers to any such program or work, and a "work based on the Program"
72
+means either the Program or any derivative work under copyright law:
73
+that is to say, a work containing the Program or a portion of it,
74
+either verbatim or with modifications and/or translated into another
75
+language.  (Hereinafter, translation is included without limitation in
76
+the term "modification".)  Each licensee is addressed as "you".
77
+
78
+Activities other than copying, distribution and modification are not
79
+covered by this License; they are outside its scope.  The act of
80
+running the Program is not restricted, and the output from the Program
81
+is covered only if its contents constitute a work based on the
82
+Program (independent of having been made by running the Program).
83
+Whether that is true depends on what the Program does.
84
+
85
+  1. You may copy and distribute verbatim copies of the Program's
86
+source code as you receive it, in any medium, provided that you
87
+conspicuously and appropriately publish on each copy an appropriate
88
+copyright notice and disclaimer of warranty; keep intact all the
89
+notices that refer to this License and to the absence of any warranty;
90
+and give any other recipients of the Program a copy of this License
91
+along with the Program.
92
+
93
+You may charge a fee for the physical act of transferring a copy, and
94
+you may at your option offer warranty protection in exchange for a fee.
95
+
96
+  2. You may modify your copy or copies of the Program or any portion
97
+of it, thus forming a work based on the Program, and copy and
98
+distribute such modifications or work under the terms of Section 1
99
+above, provided that you also meet all of these conditions:
100
+
101
+    a) You must cause the modified files to carry prominent notices
102
+    stating that you changed the files and the date of any change.
103
+
104
+    b) You must cause any work that you distribute or publish, that in
105
+    whole or in part contains or is derived from the Program or any
106
+    part thereof, to be licensed as a whole at no charge to all third
107
+    parties under the terms of this License.
108
+
109
+    c) If the modified program normally reads commands interactively
110
+    when run, you must cause it, when started running for such
111
+    interactive use in the most ordinary way, to print or display an
112
+    announcement including an appropriate copyright notice and a
113
+    notice that there is no warranty (or else, saying that you provide
114
+    a warranty) and that users may redistribute the program under
115
+    these conditions, and telling the user how to view a copy of this
116
+    License.  (Exception: if the Program itself is interactive but
117
+    does not normally print such an announcement, your work based on
118
+    the Program is not required to print an announcement.)
119
+
120
+These requirements apply to the modified work as a whole.  If
121
+identifiable sections of that work are not derived from the Program,
122
+and can be reasonably considered independent and separate works in
123
+themselves, then this License, and its terms, do not apply to those
124
+sections when you distribute them as separate works.  But when you
125
+distribute the same sections as part of a whole which is a work based
126
+on the Program, the distribution of the whole must be on the terms of
127
+this License, whose permissions for other licensees extend to the
128
+entire whole, and thus to each and every part regardless of who wrote it.
129
+
130
+Thus, it is not the intent of this section to claim rights or contest
131
+your rights to work written entirely by you; rather, the intent is to
132
+exercise the right to control the distribution of derivative or
133
+collective works based on the Program.
134
+
135
+In addition, mere aggregation of another work not based on the Program
136
+with the Program (or with a work based on the Program) on a volume of
137
+a storage or distribution medium does not bring the other work under
138
+the scope of this License.
139
+
140
+  3. You may copy and distribute the Program (or a work based on it,
141
+under Section 2) in object code or executable form under the terms of
142
+Sections 1 and 2 above provided that you also do one of the following:
143
+
144
+    a) Accompany it with the complete corresponding machine-readable
145
+    source code, which must be distributed under the terms of Sections
146
+    1 and 2 above on a medium customarily used for software interchange; or,
147
+
148
+    b) Accompany it with a written offer, valid for at least three
149
+    years, to give any third party, for a charge no more than your
150
+    cost of physically performing source distribution, a complete
151
+    machine-readable copy of the corresponding source code, to be
152
+    distributed under the terms of Sections 1 and 2 above on a medium
153
+    customarily used for software interchange; or,
154
+
155
+    c) Accompany it with the information you received as to the offer
156
+    to distribute corresponding source code.  (This alternative is
157
+    allowed only for noncommercial distribution and only if you
158
+    received the program in object code or executable form with such
159
+    an offer, in accord with Subsection b above.)
160
+
161
+The source code for a work means the preferred form of the work for
162
+making modifications to it.  For an executable work, complete source
163
+code means all the source code for all modules it contains, plus any
164
+associated interface definition files, plus the scripts used to
165
+control compilation and installation of the executable.  However, as a
166
+special exception, the source code distributed need not include
167
+anything that is normally distributed (in either source or binary
168
+form) with the major components (compiler, kernel, and so on) of the
169
+operating system on which the executable runs, unless that component
170
+itself accompanies the executable.
171
+
172
+If distribution of executable or object code is made by offering
173
+access to copy from a designated place, then offering equivalent
174
+access to copy the source code from the same place counts as
175
+distribution of the source code, even though third parties are not
176
+compelled to copy the source along with the object code.
177
+
178
+  4. You may not copy, modify, sublicense, or distribute the Program
179
+except as expressly provided under this License.  Any attempt
180
+otherwise to copy, modify, sublicense or distribute the Program is
181
+void, and will automatically terminate your rights under this License.
182
+However, parties who have received copies, or rights, from you under
183
+this License will not have their licenses terminated so long as such
184
+parties remain in full compliance.
185
+
186
+  5. You are not required to accept this License, since you have not
187
+signed it.  However, nothing else grants you permission to modify or
188
+distribute the Program or its derivative works.  These actions are
189
+prohibited by law if you do not accept this License.  Therefore, by
190
+modifying or distributing the Program (or any work based on the
191
+Program), you indicate your acceptance of this License to do so, and
192
+all its terms and conditions for copying, distributing or modifying
193
+the Program or works based on it.
194
+
195
+  6. Each time you redistribute the Program (or any work based on the
196
+Program), the recipient automatically receives a license from the
197
+original licensor to copy, distribute or modify the Program subject to
198
+these terms and conditions.  You may not impose any further
199
+restrictions on the recipients' exercise of the rights granted herein.
200
+You are not responsible for enforcing compliance by third parties to
201
+this License.
202
+
203
+  7. If, as a consequence of a court judgment or allegation of patent
204
+infringement or for any other reason (not limited to patent issues),
205
+conditions are imposed on you (whether by court order, agreement or
206
+otherwise) that contradict the conditions of this License, they do not
207
+excuse you from the conditions of this License.  If you cannot
208
+distribute so as to satisfy simultaneously your obligations under this
209
+License and any other pertinent obligations, then as a consequence you
210
+may not distribute the Program at all.  For example, if a patent
211
+license would not permit royalty-free redistribution of the Program by
212
+all those who receive copies directly or indirectly through you, then
213
+the only way you could satisfy both it and this License would be to
214
+refrain entirely from distribution of the Program.
215
+
216
+If any portion of this section is held invalid or unenforceable under
217
+any particular circumstance, the balance of the section is intended to
218
+apply and the section as a whole is intended to apply in other
219
+circumstances.
220
+
221
+It is not the purpose of this section to induce you to infringe any
222
+patents or other property right claims or to contest validity of any
223
+such claims; this section has the sole purpose of protecting the
224
+integrity of the free software distribution system, which is
225
+implemented by public license practices.  Many people have made
226
+generous contributions to the wide range of software distributed
227
+through that system in reliance on consistent application of that
228
+system; it is up to the author/donor to decide if he or she is willing
229
+to distribute software through any other system and a licensee cannot
230
+impose that choice.
231
+
232
+This section is intended to make thoroughly clear what is believed to
233
+be a consequence of the rest of this License.
234
+
235
+  8. If the distribution and/or use of the Program is restricted in
236
+certain countries either by patents or by copyrighted interfaces, the
237
+original copyright holder who places the Program under this License
238
+may add an explicit geographical distribution limitation excluding
239
+those countries, so that distribution is permitted only in or among
240
+countries not thus excluded.  In such case, this License incorporates
241
+the limitation as if written in the body of this License.
242
+
243
+  9. The Free Software Foundation may publish revised and/or new versions
244
+of the General Public License from time to time.  Such new versions will
245
+be similar in spirit to the present version, but may differ in detail to
246
+address new problems or concerns.
247
+
248
+Each version is given a distinguishing version number.  If the Program
249
+specifies a version number of this License which applies to it and "any
250
+later version", you have the option of following the terms and conditions
251
+either of that version or of any later version published by the Free
252
+Software Foundation.  If the Program does not specify a version number of
253
+this License, you may choose any version ever published by the Free Software
254
+Foundation.
255
+
256
+  10. If you wish to incorporate parts of the Program into other free
257
+programs whose distribution conditions are different, write to the author
258
+to ask for permission.  For software which is copyrighted by the Free
259
+Software Foundation, write to the Free Software Foundation; we sometimes
260
+make exceptions for this.  Our decision will be guided by the two goals
261
+of preserving the free status of all derivatives of our free software and
262
+of promoting the sharing and reuse of software generally.
263
+
264
+			    NO WARRANTY
265
+
266
+  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
267
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
268
+OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
269
+PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
270
+OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
271
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
272
+TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
273
+PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
274
+REPAIR OR CORRECTION.
275
+
276
+  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
277
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
278
+REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
279
+INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
280
+OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
281
+TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
282
+YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
283
+PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
284
+POSSIBILITY OF SUCH DAMAGES.
285
+
286
+		     END OF TERMS AND CONDITIONS
287
+
288
+
289
+	    How to Apply These Terms to Your New Programs
290
+
291
+  If you develop a new program, and you want it to be of the greatest
292
+possible use to the public, the best way to achieve this is to make it
293
+free software which everyone can redistribute and change under these terms.
294
+
295
+  To do so, attach the following notices to the program.  It is safest
296
+to attach them to the start of each source file to most effectively
297
+convey the exclusion of warranty; and each file should have at least
298
+the "copyright" line and a pointer to where the full notice is found.
299
+
300
+    <one line to give the program's name and a brief idea of what it does.>
301
+    Copyright (C) 19yy  <name of author>
302
+
303
+    This program is free software; you can redistribute it and/or modify
304
+    it under the terms of the GNU General Public License as published by
305
+    the Free Software Foundation; either version 2 of the License, or
306
+    (at your option) any later version.
307
+
308
+    This program is distributed in the hope that it will be useful,
309
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
310
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
311
+    GNU General Public License for more details.
312
+
313
+    You should have received a copy of the GNU General Public License
314
+    along with this program; if not, write to the Free Software
315
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
316
+
317
+
318
+Also add information on how to contact you by electronic and paper mail.
319
+
320
+If the program is interactive, make it output a short notice like this
321
+when it starts in an interactive mode:
322
+
323
+    Gnomovision version 69, Copyright (C) 19yy name of author
324
+    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
325
+    This is free software, and you are welcome to redistribute it
326
+    under certain conditions; type `show c' for details.
327
+
328
+The hypothetical commands `show w' and `show c' should show the appropriate
329
+parts of the General Public License.  Of course, the commands you use may
330
+be called something other than `show w' and `show c'; they could even be
331
+mouse-clicks or menu items--whatever suits your program.
332
+
333
+You should also get your employer (if you work as a programmer) or your
334
+school, if any, to sign a "copyright disclaimer" for the program, if
335
+necessary.  Here is a sample; alter the names:
336
+
337
+  Yoyodyne, Inc., hereby disclaims all copyright interest in the program
338
+  `Gnomovision' (which makes passes at compilers) written by James Hacker.
339
+
340
+  <signature of Ty Coon>, 1 April 1989
341
+  Ty Coon, President of Vice
342
+
343
+This General Public License does not permit incorporating your program into
344
+proprietary programs.  If your program is a subroutine library, you may
345
+consider it more useful to permit linking proprietary applications with the
346
+library.  If this is what you want to do, use the GNU Library General
347
+Public License instead of this License.

+ 397
- 0
COPYING-DOCS View File

@@ -0,0 +1,397 @@
1
+		GNU Free Documentation License
2
+		  Version 1.2, November 2002
3
+
4
+
5
+ Copyright (C) 2000,2001,2002  Free Software Foundation, Inc.
6
+     51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
7
+ Everyone is permitted to copy and distribute verbatim copies
8
+ of this license document, but changing it is not allowed.
9
+
10
+
11
+0. PREAMBLE
12
+
13
+The purpose of this License is to make a manual, textbook, or other
14
+functional and useful document "free" in the sense of freedom: to
15
+assure everyone the effective freedom to copy and redistribute it,
16
+with or without modifying it, either commercially or noncommercially.
17
+Secondarily, this License preserves for the author and publisher a way
18
+to get credit for their work, while not being considered responsible
19
+for modifications made by others.
20
+
21
+This License is a kind of "copyleft", which means that derivative
22
+works of the document must themselves be free in the same sense.  It
23
+complements the GNU General Public License, which is a copyleft
24
+license designed for free software.
25
+
26
+We have designed this License in order to use it for manuals for free
27
+software, because free software needs free documentation: a free
28
+program should come with manuals providing the same freedoms that the
29
+software does.  But this License is not limited to software manuals;
30
+it can be used for any textual work, regardless of subject matter or
31
+whether it is published as a printed book.  We recommend this License
32
+principally for works whose purpose is instruction or reference.
33
+
34
+
35
+1. APPLICABILITY AND DEFINITIONS
36
+
37
+This License applies to any manual or other work, in any medium, that
38
+contains a notice placed by the copyright holder saying it can be
39
+distributed under the terms of this License.  Such a notice grants a
40
+world-wide, royalty-free license, unlimited in duration, to use that
41
+work under the conditions stated herein.  The "Document", below,
42
+refers to any such manual or work.  Any member of the public is a
43
+licensee, and is addressed as "you".  You accept the license if you
44
+copy, modify or distribute the work in a way requiring permission
45
+under copyright law.
46
+
47
+A "Modified Version" of the Document means any work containing the
48
+Document or a portion of it, either copied verbatim, or with
49
+modifications and/or translated into another language.
50
+
51
+A "Secondary Section" is a named appendix or a front-matter section of
52
+the Document that deals exclusively with the relationship of the
53
+publishers or authors of the Document to the Document's overall subject
54
+(or to related matters) and contains nothing that could fall directly
55
+within that overall subject.  (Thus, if the Document is in part a
56
+textbook of mathematics, a Secondary Section may not explain any
57
+mathematics.)  The relationship could be a matter of historical
58
+connection with the subject or with related matters, or of legal,
59
+commercial, philosophical, ethical or political position regarding
60
+them.
61
+
62
+The "Invariant Sections" are certain Secondary Sections whose titles
63
+are designated, as being those of Invariant Sections, in the notice
64
+that says that the Document is released under this License.  If a
65
+section does not fit the above definition of Secondary then it is not
66
+allowed to be designated as Invariant.  The Document may contain zero
67
+Invariant Sections.  If the Document does not identify any Invariant
68
+Sections then there are none.
69
+
70
+The "Cover Texts" are certain short passages of text that are listed,
71
+as Front-Cover Texts or Back-Cover Texts, in the notice that says that
72
+the Document is released under this License.  A Front-Cover Text may
73
+be at most 5 words, and a Back-Cover Text may be at most 25 words.
74
+
75
+A "Transparent" copy of the Document means a machine-readable copy,
76
+represented in a format whose specification is available to the
77
+general public, that is suitable for revising the document
78
+straightforwardly with generic text editors or (for images composed of
79
+pixels) generic paint programs or (for drawings) some widely available
80
+drawing editor, and that is suitable for input to text formatters or
81
+for automatic translation to a variety of formats suitable for input
82
+to text formatters.  A copy made in an otherwise Transparent file
83
+format whose markup, or absence of markup, has been arranged to thwart
84
+or discourage subsequent modification by readers is not Transparent.
85
+An image format is not Transparent if used for any substantial amount
86
+of text.  A copy that is not "Transparent" is called "Opaque".
87
+
88
+Examples of suitable formats for Transparent copies include plain
89
+ASCII without markup, Texinfo input format, LaTeX input format, SGML
90
+or XML using a publicly available DTD, and standard-conforming simple
91
+HTML, PostScript or PDF designed for human modification.  Examples of
92
+transparent image formats include PNG, XCF and JPG.  Opaque formats
93
+include proprietary formats that can be read and edited only by
94
+proprietary word processors, SGML or XML for which the DTD and/or
95
+processing tools are not generally available, and the
96
+machine-generated HTML, PostScript or PDF produced by some word
97
+processors for output purposes only.
98
+
99
+The "Title Page" means, for a printed book, the title page itself,
100
+plus such following pages as are needed to hold, legibly, the material
101
+this License requires to appear in the title page.  For works in
102
+formats which do not have any title page as such, "Title Page" means
103
+the text near the most prominent appearance of the work's title,
104
+preceding the beginning of the body of the text.
105
+
106
+A section "Entitled XYZ" means a named subunit of the Document whose
107
+title either is precisely XYZ or contains XYZ in parentheses following
108
+text that translates XYZ in another language.  (Here XYZ stands for a
109
+specific section name mentioned below, such as "Acknowledgements",
110
+"Dedications", "Endorsements", or "History".)  To "Preserve the Title"
111
+of such a section when you modify the Document means that it remains a
112
+section "Entitled XYZ" according to this definition.
113
+
114
+The Document may include Warranty Disclaimers next to the notice which
115
+states that this License applies to the Document.  These Warranty
116
+Disclaimers are considered to be included by reference in this
117
+License, but only as regards disclaiming warranties: any other
118
+implication that these Warranty Disclaimers may have is void and has
119
+no effect on the meaning of this License.
120
+
121
+
122
+2. VERBATIM COPYING
123
+
124
+You may copy and distribute the Document in any medium, either
125
+commercially or noncommercially, provided that this License, the
126
+copyright notices, and the license notice saying this License applies
127
+to the Document are reproduced in all copies, and that you add no other
128
+conditions whatsoever to those of this License.  You may not use
129
+technical measures to obstruct or control the reading or further
130
+copying of the copies you make or distribute.  However, you may accept
131
+compensation in exchange for copies.  If you distribute a large enough
132
+number of copies you must also follow the conditions in section 3.
133
+
134
+You may also lend copies, under the same conditions stated above, and
135
+you may publicly display copies.
136
+
137
+
138
+3. COPYING IN QUANTITY
139
+
140
+If you publish printed copies (or copies in media that commonly have
141
+printed covers) of the Document, numbering more than 100, and the
142
+Document's license notice requires Cover Texts, you must enclose the
143
+copies in covers that carry, clearly and legibly, all these Cover
144
+Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
145
+the back cover.  Both covers must also clearly and legibly identify
146
+you as the publisher of these copies.  The front cover must present
147
+the full title with all words of the title equally prominent and
148
+visible.  You may add other material on the covers in addition.
149
+Copying with changes limited to the covers, as long as they preserve
150
+the title of the Document and satisfy these conditions, can be treated
151
+as verbatim copying in other respects.
152
+
153
+If the required texts for either cover are too voluminous to fit
154
+legibly, you should put the first ones listed (as many as fit
155
+reasonably) on the actual cover, and continue the rest onto adjacent
156
+pages.
157
+
158
+If you publish or distribute Opaque copies of the Document numbering
159
+more than 100, you must either include a machine-readable Transparent
160
+copy along with each Opaque copy, or state in or with each Opaque copy
161
+a computer-network location from which the general network-using
162
+public has access to download using public-standard network protocols
163
+a complete Transparent copy of the Document, free of added material.
164
+If you use the latter option, you must take reasonably prudent steps,
165
+when you begin distribution of Opaque copies in quantity, to ensure
166
+that this Transparent copy will remain thus accessible at the stated
167
+location until at least one year after the last time you distribute an
168
+Opaque copy (directly or through your agents or retailers) of that
169
+edition to the public.
170
+
171
+It is requested, but not required, that you contact the authors of the
172
+Document well before redistributing any large number of copies, to give
173
+them a chance to provide you with an updated version of the Document.
174
+
175
+
176
+4. MODIFICATIONS
177
+
178
+You may copy and distribute a Modified Version of the Document under
179
+the conditions of sections 2 and 3 above, provided that you release
180
+the Modified Version under precisely this License, with the Modified
181
+Version filling the role of the Document, thus licensing distribution
182
+and modification of the Modified Version to whoever possesses a copy
183
+of it.  In addition, you must do these things in the Modified Version:
184
+
185
+A. Use in the Title Page (and on the covers, if any) a title distinct
186
+   from that of the Document, and from those of previous versions
187
+   (which should, if there were any, be listed in the History section
188
+   of the Document).  You may use the same title as a previous version
189
+   if the original publisher of that version gives permission.
190
+B. List on the Title Page, as authors, one or more persons or entities
191
+   responsible for authorship of the modifications in the Modified
192
+   Version, together with at least five of the principal authors of the
193
+   Document (all of its principal authors, if it has fewer than five),
194
+   unless they release you from this requirement.
195
+C. State on the Title page the name of the publisher of the
196
+   Modified Version, as the publisher.
197
+D. Preserve all the copyright notices of the Document.
198
+E. Add an appropriate copyright notice for your modifications
199
+   adjacent to the other copyright notices.
200
+F. Include, immediately after the copyright notices, a license notice
201
+   giving the public permission to use the Modified Version under the
202
+   terms of this License, in the form shown in the Addendum below.
203
+G. Preserve in that license notice the full lists of Invariant Sections
204
+   and required Cover Texts given in the Document's license notice.
205
+H. Include an unaltered copy of this License.
206
+I. Preserve the section Entitled "History", Preserve its Title, and add
207
+   to it an item stating at least the title, year, new authors, and
208
+   publisher of the Modified Version as given on the Title Page.  If
209
+   there is no section Entitled "History" in the Document, create one
210
+   stating the title, year, authors, and publisher of the Document as
211
+   given on its Title Page, then add an item describing the Modified
212
+   Version as stated in the previous sentence.
213
+J. Preserve the network location, if any, given in the Document for
214
+   public access to a Transparent copy of the Document, and likewise
215
+   the network locations given in the Document for previous versions
216
+   it was based on.  These may be placed in the "History" section.
217
+   You may omit a network location for a work that was published at
218
+   least four years before the Document itself, or if the original
219
+   publisher of the version it refers to gives permission.
220
+K. For any section Entitled "Acknowledgements" or "Dedications",
221
+   Preserve the Title of the section, and preserve in the section all
222
+   the substance and tone of each of the contributor acknowledgements
223
+   and/or dedications given therein.
224
+L. Preserve all the Invariant Sections of the Document,
225
+   unaltered in their text and in their titles.  Section numbers
226
+   or the equivalent are not considered part of the section titles.
227
+M. Delete any section Entitled "Endorsements".  Such a section
228
+   may not be included in the Modified Version.
229
+N. Do not retitle any existing section to be Entitled "Endorsements"
230
+   or to conflict in title with any Invariant Section.
231
+O. Preserve any Warranty Disclaimers.
232
+
233
+If the Modified Version includes new front-matter sections or
234
+appendices that qualify as Secondary Sections and contain no material
235
+copied from the Document, you may at your option designate some or all
236
+of these sections as invariant.  To do this, add their titles to the
237
+list of Invariant Sections in the Modified Version's license notice.
238
+These titles must be distinct from any other section titles.
239
+
240
+You may add a section Entitled "Endorsements", provided it contains
241
+nothing but endorsements of your Modified Version by various
242
+parties--for example, statements of peer review or that the text has
243
+been approved by an organization as the authoritative definition of a
244
+standard.
245
+
246
+You may add a passage of up to five words as a Front-Cover Text, and a
247
+passage of up to 25 words as a Back-Cover Text, to the end of the list
248
+of Cover Texts in the Modified Version.  Only one passage of
249
+Front-Cover Text and one of Back-Cover Text may be added by (or
250
+through arrangements made by) any one entity.  If the Document already
251
+includes a cover text for the same cover, previously added by you or
252
+by arrangement made by the same entity you are acting on behalf of,
253
+you may not add another; but you may replace the old one, on explicit
254
+permission from the previous publisher that added the old one.
255
+
256
+The author(s) and publisher(s) of the Document do not by this License
257
+give permission to use their names for publicity for or to assert or
258
+imply endorsement of any Modified Version.
259
+
260
+
261
+5. COMBINING DOCUMENTS
262
+
263
+You may combine the Document with other documents released under this
264
+License, under the terms defined in section 4 above for modified
265
+versions, provided that you include in the combination all of the
266
+Invariant Sections of all of the original documents, unmodified, and
267
+list them all as Invariant Sections of your combined work in its
268
+license notice, and that you preserve all their Warranty Disclaimers.
269
+
270
+The combined work need only contain one copy of this License, and
271
+multiple identical Invariant Sections may be replaced with a single
272
+copy.  If there are multiple Invariant Sections with the same name but
273
+different contents, make the title of each such section unique by
274
+adding at the end of it, in parentheses, the name of the original
275
+author or publisher of that section if known, or else a unique number.
276
+Make the same adjustment to the section titles in the list of
277
+Invariant Sections in the license notice of the combined work.
278
+
279
+In the combination, you must combine any sections Entitled "History"
280
+in the various original documents, forming one section Entitled
281
+"History"; likewise combine any sections Entitled "Acknowledgements",
282
+and any sections Entitled "Dedications".  You must delete all sections
283
+Entitled "Endorsements".
284
+
285
+
286
+6. COLLECTIONS OF DOCUMENTS
287
+
288
+You may make a collection consisting of the Document and other documents
289
+released under this License, and replace the individual copies of this
290
+License in the various documents with a single copy that is included in
291
+the collection, provided that you follow the rules of this License for
292
+verbatim copying of each of the documents in all other respects.
293
+
294
+You may extract a single document from such a collection, and distribute
295
+it individually under this License, provided you insert a copy of this
296
+License into the extracted document, and follow this License in all
297
+other respects regarding verbatim copying of that document.
298
+
299
+
300
+7. AGGREGATION WITH INDEPENDENT WORKS
301
+
302
+A compilation of the Document or its derivatives with other separate
303
+and independent documents or works, in or on a volume of a storage or
304
+distribution medium, is called an "aggregate" if the copyright
305
+resulting from the compilation is not used to limit the legal rights
306
+of the compilation's users beyond what the individual works permit.
307
+When the Document is included in an aggregate, this License does not
308
+apply to the other works in the aggregate which are not themselves
309
+derivative works of the Document.
310
+
311
+If the Cover Text requirement of section 3 is applicable to these
312
+copies of the Document, then if the Document is less than one half of
313
+the entire aggregate, the Document's Cover Texts may be placed on
314
+covers that bracket the Document within the aggregate, or the
315
+electronic equivalent of covers if the Document is in electronic form.
316
+Otherwise they must appear on printed covers that bracket the whole
317
+aggregate.
318
+
319
+
320
+8. TRANSLATION
321
+
322
+Translation is considered a kind of modification, so you may
323
+distribute translations of the Document under the terms of section 4.
324
+Replacing Invariant Sections with translations requires special
325
+permission from their copyright holders, but you may include
326
+translations of some or all Invariant Sections in addition to the
327
+original versions of these Invariant Sections.  You may include a
328
+translation of this License, and all the license notices in the
329
+Document, and any Warranty Disclaimers, provided that you also include
330
+the original English version of this License and the original versions
331
+of those notices and disclaimers.  In case of a disagreement between
332
+the translation and the original version of this License or a notice
333
+or disclaimer, the original version will prevail.
334
+
335
+If a section in the Document is Entitled "Acknowledgements",
336
+"Dedications", or "History", the requirement (section 4) to Preserve
337
+its Title (section 1) will typically require changing the actual
338
+title.
339
+
340
+
341
+9. TERMINATION
342
+
343
+You may not copy, modify, sublicense, or distribute the Document except
344
+as expressly provided for under this License.  Any other attempt to
345
+copy, modify, sublicense or distribute the Document is void, and will
346
+automatically terminate your rights under this License.  However,
347
+parties who have received copies, or rights, from you under this
348
+License will not have their licenses terminated so long as such
349
+parties remain in full compliance.
350
+
351
+
352
+10. FUTURE REVISIONS OF THIS LICENSE
353
+
354
+The Free Software Foundation may publish new, revised versions
355
+of the GNU Free Documentation License from time to time.  Such new
356
+versions will be similar in spirit to the present version, but may
357
+differ in detail to address new problems or concerns.  See
358
+http://www.gnu.org/copyleft/.
359
+
360
+Each version of the License is given a distinguishing version number.
361
+If the Document specifies that a particular numbered version of this
362
+License "or any later version" applies to it, you have the option of
363
+following the terms and conditions either of that specified version or
364
+of any later version that has been published (not as a draft) by the
365
+Free Software Foundation.  If the Document does not specify a version
366
+number of this License, you may choose any version ever published (not
367
+as a draft) by the Free Software Foundation.
368
+
369
+
370
+ADDENDUM: How to use this License for your documents
371
+
372
+To use this License in a document you have written, include a copy of
373
+the License in the document and put the following copyright and
374
+license notices just after the title page:
375
+
376
+    Copyright (c)  YEAR  YOUR NAME.
377
+    Permission is granted to copy, distribute and/or modify this document
378
+    under the terms of the GNU Free Documentation License, Version 1.2
379
+    or any later version published by the Free Software Foundation;
380
+    with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
381
+    A copy of the license is included in the section entitled "GNU
382
+    Free Documentation License".
383
+
384
+If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts,
385
+replace the "with...Texts." line with this:
386
+
387
+    with the Invariant Sections being LIST THEIR TITLES, with the
388
+    Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
389
+
390
+If you have Invariant Sections without Cover Texts, or some other
391
+combination of the three, merge those two alternatives to suit the
392
+situation.
393
+
394
+If your document contains nontrivial examples of program code, we
395
+recommend releasing these examples in parallel under your choice of
396
+free software license, such as the GNU General Public License,
397
+to permit their use in free software.

+ 17
- 0
ChangeLog View File

@@ -0,0 +1,17 @@
1
+1998-12-05  Alex Zepeda  <garbanzo@hooked.net>
2
+
3
+	* README: Use a "new" style README.
4
+
5
+1998-11-13  Alex Zepeda  <garbanzo@hooked.net>
6
+
7
+	* Makefile.cvs (all): Use an updated Makefile.cvs from kdenetwork that
8
+	tests for the admin directory.
9
+
10
+	* configure.in.1: Remove comment about this being Alpha (quality)
11
+	software, and update version number (now it's at 1.1pre).  Also, now
12
+	it uses the kde-common copy of the autoconf stuff.
13
+
14
+1998-11-08  Alex Zepeda  <alex@zippy.dyn.ml.org>
15
+
16
+	* Makefile.cvs (all): Use the kde-common version of automoc.
17
+

+ 176
- 0
INSTALL View File

@@ -0,0 +1,176 @@
1
+Basic Installation
2
+==================
3
+
4
+   These are generic installation instructions.
5
+
6
+   The `configure' shell script attempts to guess correct values for
7
+various system-dependent variables used during compilation.  It uses
8
+those values to create a `Makefile' in each directory of the package.
9
+It may also create one or more `.h' files containing system-dependent
10
+definitions.  Finally, it creates a shell script `config.status' that
11
+you can run in the future to recreate the current configuration, a file
12
+`config.cache' that saves the results of its tests to speed up
13
+reconfiguring, and a file `config.log' containing compiler output
14
+(useful mainly for debugging `configure').
15
+
16
+   If you need to do unusual things to compile the package, please try
17
+to figure out how `configure' could check whether to do them, and mail
18
+diffs or instructions to the address given in the `README' so they can
19
+be considered for the next release.  If at some point `config.cache'
20
+contains results you don't want to keep, you may remove or edit it.
21
+
22
+   The file `configure.in' is used to create `configure' by a program
23
+called `autoconf'.  You only need `configure.in' if you want to change
24
+it or regenerate `configure' using a newer version of `autoconf'.
25
+
26
+The simplest way to compile this package is:
27
+
28
+  1. `cd' to the directory containing the package's source code and type
29
+     `./configure' to configure the package for your system.  If you're
30
+     using `csh' on an old version of System V, you might need to type
31
+     `sh ./configure' instead to prevent `csh' from trying to execute
32
+     `configure' itself.
33
+
34
+     Running `configure' takes a while.  While running, it prints some
35
+     messages telling which features it is checking for.
36
+
37
+  2. Type `make' to compile the package.
38
+
39
+  3. Optionally, type `make check' to run any self-tests that come with
40
+     the package.
41
+
42
+  4. Type `make install' to install the programs and any data files and
43
+     documentation.
44
+
45
+  5. You can remove the program binaries and object files from the
46
+     source code directory by typing `make clean'.  To also remove the
47
+     files that `configure' created (so you can compile the package for
48
+     a different kind of computer), type `make distclean'.  There is
49
+     also a `make maintainer-clean' target, but that is intended mainly
50
+     for the package's developers.  If you use it, you may have to get
51
+     all sorts of other programs in order to regenerate files that came
52
+     with the distribution.
53
+
54
+Compilers and Options
55
+=====================
56
+
57
+   Some systems require unusual options for compilation or linking that
58
+the `configure' script does not know about.  You can give `configure'
59
+initial values for variables by setting them in the environment.  Using
60
+a Bourne-compatible shell, you can do that on the command line like
61
+this:
62
+     CC=c89 CFLAGS=-O2 LIBS=-lposix ./configure
63
+
64
+Or on systems that have the `env' program, you can do it like this:
65
+     env CPPFLAGS=-I/usr/local/include LDFLAGS=-s ./configure
66
+
67
+Compiling For Multiple Architectures
68
+====================================
69
+
70
+   You can compile the package for more than one kind of computer at the
71
+same time, by placing the object files for each architecture in their
72
+own directory.  To do this, you must use a version of `make' that
73
+supports the `VPATH' variable, such as GNU `make'.  `cd' to the
74
+directory where you want the object files and executables to go and run
75
+the `configure' script.  `configure' automatically checks for the
76
+source code in the directory that `configure' is in and in `..'.
77
+
78
+   If you have to use a `make' that does not supports the `VPATH'
79
+variable, you have to compile the package for one architecture at a time
80
+in the source code directory.  After you have installed the package for
81
+one architecture, use `make distclean' before reconfiguring for another
82
+architecture.
83
+
84
+Installation Names
85
+==================
86
+
87
+   By default, `make install' will install the package's files in
88
+`/usr/local/kde/bin', `/usr/local/kde/lib', etc.  You can specify an
89
+installation prefix other than `/usr/local/kde' by giving `configure'
90
+the option `--prefix=PATH'.
91
+
92
+   You can specify separate installation prefixes for
93
+architecture-specific files and architecture-independent files.  If you
94
+give `configure' the option `--exec-prefix=PATH', the package will use
95
+PATH as the prefix for installing programs and libraries.
96
+Documentation and other data files will still use the regular prefix.
97
+
98
+   If the package supports it, you can cause programs to be installed
99
+with an extra prefix or suffix on their names by giving `configure' the
100
+option `--program-prefix=PREFIX' or `--program-suffix=SUFFIX'.
101
+
102
+Optional Features
103
+=================
104
+
105
+   Some packages pay attention to `--enable-FEATURE' options to
106
+`configure', where FEATURE indicates an optional part of the package.
107
+They may also pay attention to `--with-PACKAGE' options, where PACKAGE
108
+is something like `gnu-as' or `x' (for the X Window System).  The
109
+`README' should mention any `--enable-' and `--with-' options that the
110
+package recognizes.
111
+
112
+   For packages that use the X Window System, `configure' can usually
113
+find the X include and library files automatically, but if it doesn't,
114
+you can use the `configure' options `--x-includes=DIR' and
115
+`--x-libraries=DIR' to specify their locations.
116
+
117
+Specifying the System Type
118
+==========================
119
+
120
+   There may be some features `configure' can not figure out
121
+automatically, but needs to determine by the type of host the package
122
+will run on.  Usually `configure' can figure that out, but if it prints
123
+a message saying it can not guess the host type, give it the
124
+`--host=TYPE' option.  TYPE can either be a short name for the system
125
+type, such as `sun4', or a canonical name with three fields:
126
+     CPU-COMPANY-SYSTEM
127
+
128
+See the file `config.sub' for the possible values of each field.  If
129
+`config.sub' isn't included in this package, then this package doesn't
130
+need to know the host type.
131
+
132
+   If you are building compiler tools for cross-compiling, you can also
133
+use the `--target=TYPE' option to select the type of system they will
134
+produce code for and the `--build=TYPE' option to select the type of
135
+system on which you are compiling the package.
136
+
137
+Sharing Defaults
138
+================
139
+
140
+   If you want to set default values for `configure' scripts to share,
141
+you can create a site shell script called `config.site' that gives
142
+default values for variables like `CC', `cache_file', and `prefix'.
143
+`configure' looks for `PREFIX/share/config.site' if it exists, then
144
+`PREFIX/etc/config.site' if it exists.  Or, you can set the
145
+`CONFIG_SITE' environment variable to the location of the site script.
146
+A warning: not all `configure' scripts look for a site script.
147
+
148
+Operation Controls
149
+==================
150
+
151
+   `configure' recognizes the following options to control how it
152
+operates.
153
+
154
+`--cache-file=FILE'
155
+     Use and save the results of the tests in FILE instead of
156
+     `./config.cache'.  Set FILE to `/dev/null' to disable caching, for
157
+     debugging `configure'.
158
+
159
+`--help'
160
+     Print a summary of the options to `configure', and exit.
161
+
162
+`--quiet'
163
+`--silent'
164
+`-q'
165
+     Do not print messages saying which checks are being made.
166
+
167
+`--srcdir=DIR'
168
+     Look for the package's source code in directory DIR.  Usually
169
+     `configure' can determine that directory automatically.
170
+
171
+`--version'
172
+     Print the version of Autoconf used to generate the `configure'
173
+     script, and exit.
174
+
175
+`configure' also accepts some other, not widely useful, options.
176
+

+ 16
- 0
Mainpage.dox View File

@@ -0,0 +1,16 @@
1
+/**
2
+	* @mainpage The KDE Graphics API Reference
3
+	*
4
+	* This section contains the KDE online class reference for the current
5
+	* development version of the KDE graphics package. 
6
+	*
7
+	* - <a href="kviewshell/html/index.html"><b>kviewshell</b></a>
8
+        *   (<a href="kviewshell/html/classes.html">classes</a>)\n
9
+	*   <i>API for the implementation of kviewshell plugins.</i>
10
+	*
11
+	* More information about the KDE architecture in form of
12
+	* tutorials, HOWTOs,
13
+	* and FAQs can be found at
14
+	* the <a href="http://developer.kde.org">KDE Developer's corner</a>.
15
+	*/
16
+

+ 22
- 0
Makefile.am.in View File

@@ -0,0 +1,22 @@
1
+## kdegraphics/Makefile.am $Id$
2
+## (C) 1997 Stephan Kulow
3
+
4
+AUTOMAKE_OPTIONS = foreign 1.6.1
5
+
6
+COMPILE_BEFORE_kooka = libkscan
7
+COMPILE_BEFORE_kfaxview = kfax
8
+COMPILE_BEFORE_kfile-plugins = kghostview
9
+COMPILE_AFTER_kviewshell = kdvi kfaxview
10
+
11
+DISTCLEANFILES = inst-apps
12
+
13
+EXTRA_DIST = admin debian kdebase.spec.in README.pam kde.pamd 
14
+
15
+dist-hook:
16
+	cd $(top_distdir) && perl $(top_srcdir)/admin/am_edit -padmin
17
+
18
+MAINTAINERCLEANFILES = subdirs configure.in acinclude.m4 SUBDIRS
19
+
20
+include admin/Doxyfile.am
21
+include admin/deps.am
22
+

+ 16
- 0
Makefile.cvs View File

@@ -0,0 +1,16 @@
1
+
2
+all: 
3
+	@echo "This Makefile is only for the CVS repository"
4
+	@echo "This will be deleted before making the distribution"
5
+	@echo ""
6
+	@if test ! -d admin; then \
7
+	   echo "Please recheckout this module!" ;\
8
+	   echo "for cvs: use checkout once and after that update again" ;\
9
+	   echo "for cvsup: checkout kde-common from cvsup and" ;\
10
+	   echo "   link kde-common/admin to ./admin" ;\
11
+	   exit 1 ;\
12
+	fi
13
+	$(MAKE) -f admin/Makefile.common cvs
14
+
15
+.SILENT:
16
+

+ 97
- 0
README View File

@@ -0,0 +1,97 @@
1
+In this file:
2
+
3
+* About kdegraphics
4
+* Common Mistakes
5
+* Debugging
6
+* More Info
7
+
8
+
9
+About kdegraphics
10
+-----------------
11
+kdegraphics is a collection of graphic oriented applications:
12
+
13
+* debian
14
+    Files needed to create Debian packages.
15
+
16
+* doc
17
+    XML based documentation for the programs.
18
+
19
+* kamera
20
+    Digital camera io_slave for Konqueror. Together gPhoto this allows you
21
+    to access your camera's picture with the URL kamera:/
22
+
23
+* kcoloredit
24
+    Contains two programs: a color value editor and also a color picker.
25
+
26
+* kdvi
27
+    Program (and embeddable KPart) to display *.DVI files from TeX.
28
+
29
+* kfax
30
+    A program to display raw and tiffed fax images (g3, g3-2d, g4).
31
+
32
+* kfaxview
33
+    An embeddable KPart to display tiffed fax images.
34
+
35
+* kfile-plugins
36
+    Provide meta information for graphic files.
37
+
38
+* kghostview
39
+    Program (and embeddable KPart) to display *.pdf and *.ps
40
+
41
+* kiconedit
42
+    An icon editor.
43
+
44
+* kmrml
45
+    Connects to a MRML server and find similar images
46
+
47
+* kooka
48
+    A raster image scan program, based on SANE and libkscan.
49
+
50
+* kolourpaint
51
+    An easy-to-use paint program designed for everyday tasks like drawing
52
+    simple diagrams/logos/icons and editing screenshots.
53
+                     
54
+* kpovmodeler
55
+    Program to enter scenes for the 3D rendering engine PovRay.
56
+
57
+* kruler
58
+    A ruler in inch, centimeter and pixel to check distances on the screen.
59
+
60
+* ksnapshot
61
+    Make snapshots of the screen contents.
62
+
63
+* kuickshow
64
+    Fast and comfortable imageviewer.
65
+
66
+* kview
67
+    Picture viewer, provided as standalone program and embeddable KPart.
68
+
69
+* kviewshell
70
+    Generic framework for viewer applications.
71
+
72
+* libkscan
73
+    Library to access scanners used by kooka (and koffice), needs SANE to be
74
+    used
75
+
76
+
77
+Common Mistakes
78
+---------------
79
+If configure claims Qt cannot be found, have a look at http://www.trolltech.com
80
+to get a copy of latest Qt 3.3.x version.
81
+
82
+
83
+Debugging
84
+---------
85
+You can use --enable-debug with the configure script, if you want to have
86
+debug code in your KDE apps and libs. This will ensure useful and more 
87
+verbose backtraces, but will require a lot more disk space. 
88
+
89
+
90
+More Info
91
+---------
92
+Please direct any bug reports to our bug list by visiting
93
+http://bugs.kde.org.
94
+
95
+General KDE discussions should go to the KDE mailing list (kde@kde.org).
96
+
97
+

+ 17
- 0
configure.in.in View File

@@ -0,0 +1,17 @@
1
+#MIN_CONFIG
2
+DO_NOT_COMPILE="$DO_NOT_COMPILE"
3
+
4
+dnl Checks for header files.
5
+AC_HEADER_DIRENT
6
+AC_HEADER_STDC
7
+AC_CHECK_HEADERS(fcntl.h sys/time.h unistd.h stdlib.h paths.h)
8
+AC_CHECK_SETENV
9
+AC_CHECK_UNSETENV
10
+AC_CHECK_USLEEP
11
+AC_CHECK_MKSTEMPS
12
+dnl Checks for typedefs, structures, and compiler characteristics.
13
+AC_HEADER_TIME
14
+
15
+CXXFLAGS="$CXXFLAGS $KDE_DEFAULT_CXXFLAGS"
16
+
17
+KDE_INIT_DOXYGEN([KDE Graphics API Reference], [Version $VERSION])

+ 5
- 0
doc/Makefile.am View File

@@ -0,0 +1,5 @@
1
+
2
+KDE_LANG = en
3
+KDE_DOCS = AUTO
4
+SUBDIRS = $(AUTODIRS)
5
+

+ 4
- 0
doc/kamera/Makefile.am View File

@@ -0,0 +1,4 @@
1
+
2
+KDE_LANG = en
3
+KDE_DOCS = AUTO
4
+

+ 78
- 0
doc/kamera/index.docbook View File

@@ -0,0 +1,78 @@
1
+<?xml version="1.0" ?>
2
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
3
+  <!ENTITY kappname "&kamera;">
4
+  <!ENTITY package "kdegraphics">
5
+  <!ENTITY % addindex "IGNORE">
6
+  <!ENTITY % English "INCLUDE">
7
+]>
8
+
9
+<book lang="&language;">
10
+
11
+<bookinfo>
12
+<title>The &kamera; Handbook</title>
13
+
14
+<authorgroup>
15
+<author>
16
+<firstname></firstname>
17
+<othername></othername>
18
+<surname></surname>
19
+<affiliation>
20
+<address><email></email></address>
21
+</affiliation>
22
+</author>
23
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
24
+</authorgroup>
25
+
26
+<legalnotice>&FDLNotice;</legalnotice>
27
+
28
+<!-- Date and version information of the documentation
29
+Don't forget to include this last date and this last revision number, we
30
+need them for translation coordination !
31
+Please respect the format of the date (DD/MM/YYYY) and of the version
32
+(Major.minor.lesser), it could be used by automation scripts -->
33
+
34
+<date>2000-09-02</date>
35
+<releaseinfo>0.00.00</releaseinfo>
36
+
37
+<!-- Abstract about this handbook -->
38
+
39
+<abstract>
40
+<para>
41
+&kamera; allows you to view and download images on a digital camera.
42
+</para>
43
+</abstract>
44
+
45
+
46
+<keywordset>
47
+<keyword>KDE</keyword>
48
+<keyword>Kapp</keyword>
49
+</keywordset>
50
+
51
+</bookinfo>
52
+
53
+<chapter id="introduction"> <title>Introduction</title> <para>Sorry, but
54
+the documentation for &kappname; was not finished when &kde; was installed on
55
+this computer.</para> <para>If you need help, please check <ulink
56
+url="http://www.kde.org">The &kde; Website</ulink> for updates, or by
57
+submitting your question to <ulink url="mailto:kde@kde.org">The
58
+&kde; User Mailing list</ulink>.</para> <para><emphasis>The &kde;
59
+Team</emphasis></para>
60
+
61
+&underFDL;
62
+
63
+</chapter>
64
+
65
+&documentation.index; 
66
+</book>
67
+
68
+<!--
69
+Local Variables:
70
+mode: sgml
71
+sgml-minimize-attributes:nil
72
+sgml-general-insert-case:lower
73
+sgml-indent-step:0
74
+sgml-indent-data:nil
75
+End:
76
+
77
+// vim:ts=2:sw=2:tw=78:noet
78
+-->

+ 4
- 0
doc/kcoloredit/Makefile.am View File

@@ -0,0 +1,4 @@
1
+
2
+KDE_LANG = en
3
+KDE_DOCS = AUTO
4
+

+ 468
- 0
doc/kcoloredit/index.docbook View File

@@ -0,0 +1,468 @@
1
+<?xml version="1.0" ?>
2
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
3
+  <!ENTITY kcoloredit "<application>KColorEdit</application>">
4
+  <!ENTITY kappname "&kcoloredit;">
5
+  <!ENTITY package "kdegraphics">
6
+  <!ENTITY % addindex "IGNORE">
7
+  <!ENTITY % English "INCLUDE"> <!-- Change language only here --> 
8
+]
9
+>
10
+
11
+<book lang="&language;">
12
+<bookinfo>
13
+<title> The &kcoloredit; Handbook</title>
14
+<authorgroup>
15
+<author>
16
+<firstname>Artur</firstname>
17
+<surname>Rataj</surname>
18
+<affiliation>
19
+<address>&Artur.Rataj.mail;</address>
20
+</affiliation>
21
+</author>
22
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
23
+
24
+</authorgroup>
25
+
26
+<copyright>
27
+<year>2000</year>
28
+<holder>&Artur.Rataj;</holder>
29
+</copyright>
30
+
31
+<legalnotice>&FDLNotice;</legalnotice>
32
+
33
+<date>2005-12-10</date>
34
+<releaseinfo>3.5.0</releaseinfo>
35
+
36
+<abstract>
37
+<para>&kcoloredit; is a palette files editor. It can be used for editing
38
+color palettes and for color choosing and naming.</para>
39
+</abstract>
40
+
41
+<keywordset>
42
+<keyword>KDE</keyword>
43
+<keyword>graphics</keyword>
44
+<keyword>palette</keyword>
45
+</keywordset>
46
+</bookinfo>
47
+
48
+<chapter id="introduction">
49
+<title>Introduction</title>
50
+
51
+<para>&kcoloredit; is a palette files editor. It can be used for
52
+editing color palettes and for color choosing and naming.</para>
53
+
54
+</chapter>
55
+
56
+<chapter id="file-operations">
57
+<title>File operations</title>
58
+
59
+<sect1 id="file">
60
+<title>About palette files</title>
61
+
62
+<para>
63
+The palette files installed by &kde; can be either system-wide or the
64
+user ones.  The latter are in you private &kde; configuration
65
+folders, and they are named <guilabel>Custom Colors</guilabel> and
66
+<guilabel>Recent Colors</guilabel>.
67
+</para>
68
+
69
+<para>
70
+In &kcoloredit;, you may open all of these palettes, as well as
71
+palettes in arbitrary files.
72
+</para>
73
+
74
+</sect1>
75
+
76
+<sect1 id="file-open">
77
+<title>Opening a file</title>
78
+<para>
79
+In the  <guilabel>Open File</guilabel> dialog,  you may choose  from a
80
+list of installed palettes, or browse folders for files.
81
+</para>
82
+</sect1>
83
+
84
+</chapter>
85
+
86
+<chapter id="Edition">
87
+<title>Editing</title>
88
+
89
+<sect1 id="cursor">
90
+<title>Cursor</title>
91
+
92
+<para>The cursor is visible as a line in the palette view. It can be
93
+moved by clicking on an area beside a color.</para>
94
+
95
+<para>The cursor has the following functions:</para>
96
+
97
+<itemizedlist>
98
+<listitem>
99
+<para>
100
+It points to the color after it. The color, if any, is described below
101
+the palette view. You may edit its name there.
102
+</para>
103
+</listitem>
104
+<listitem>
105
+<para>
106
+It can be used to make a selection. A selection can be made by
107
+clicking on an area beside a color, so to move the cursor there, and
108
+by moving the mouse then with the left mouse button pressed.
109
+</para>
110
+</listitem>
111
+<listitem>
112
+<para>If the <guilabel>At cursor</guilabel> check-box near the
113
+<guilabel>Add Color</guilabel> button is checked, a color from the
114
+color chooser is put at the cursor.  The color is either inserted
115
+or it overwrites another one, depending on whether the
116
+<guilabel>Overwrite</guilabel> mode is chosen. The mode can be chosen
117
+by checking the <guilabel>Overwrite</guilabel> check-box, that is next
118
+to the <guilabel>At cursor</guilabel> one.</para>
119
+</listitem>
120
+</itemizedlist>
121
+
122
+</sect1>
123
+
124
+<sect1 id = "selection">
125
+<title>Selection</title>
126
+<para>
127
+A selection, that can be made as it was written in the previous
128
+section, can be used with the copy, cut and paste operations.
129
+</para>
130
+</sect1>
131
+
132
+<sect1 id = "clipboard-format">
133
+<title>Clipboard format</title>
134
+<para>
135
+&kcoloredit; uses the following format for clipboard data: for each
136
+color three numbers for red, green and blue components, respectively,
137
+and an optional color name, followed by a new line character if there
138
+is another color. Therefore, if for example three numbers are in the
139
+clipboard, they can be pasted by &kcoloredit; as a color.
140
+</para>
141
+</sect1>
142
+
143
+</chapter>
144
+
145
+<chapter id="color-selection">
146
+<title>Selecting a color from an RGB space</title>
147
+
148
+<para>
149
+A color can be selected from an RGB space in &kcoloredit; in the
150
+following ways:
151
+<itemizedlist>
152
+<listitem>
153
+<para>
154
+By editing the HSV or RGB components.
155
+</para>
156
+</listitem>
157
+<listitem>
158
+<para>
159
+By selecting a color from color gradient panels. In the left one, two
160
+from HSV components can be selected, and in the right one, the third
161
+one. The third component can be chosen by clicking on one of the
162
+buttons labeled <guilabel>H:</guilabel>, <guilabel>S:</guilabel> and
163
+<guilabel>V:</guilabel>. The one component panel display colors with
164
+the other two components equal to these selected in the two components
165
+panel.  The two components panel may display colors with the third
166
+component fixed, or, if the <guilabel>Variable</guilabel> check-box is
167
+set, with a value equal to the one selected in the one component
168
+panel. In the <guilabel>Replace</guilabel> mode, the color selected in
169
+panels replaces the output one instantly, and in the
170
+<guilabel>Change:</guilabel> mode it modifies the output color after
171
+each click, or a mouse move while a mouse button is
172
+pressed. Therefore, in the latter mode the color selected in the
173
+gradient panels may be different from the output color. To synchronize
174
+the colors, the <guibutton>Synchronize</guibutton> button can be used.
175
+</para>
176
+</listitem>
177
+</itemizedlist>
178
+</para>
179
+</chapter>
180
+
181
+<!-- Someone energetic might want to write a small chapter here -->
182
+<!-- describing RGB vs HSV etc -->
183
+
184
+<chapter id="drag-and-drop">
185
+<title>Drag and drop</title>
186
+<para>
187
+The palette colors and the color selection output color can be dragged
188
+with a mouse.
189
+</para>
190
+</chapter>
191
+
192
+<chapter id="menu-reference">
193
+<title>Menu Reference</title>
194
+
195
+<sect1 id="file-menu">
196
+<title>The <guimenu>File</guimenu> Menu</title>
197
+
198
+<variablelist>
199
+<varlistentry>
200
+<term><menuchoice>
201
+<shortcut><keycombo action="simul">&Ctrl;
202
+<keycap>N</keycap></keycombo></shortcut>
203
+<guimenu>File</guimenu>
204
+<guimenuitem>New</guimenuitem>
205
+</menuchoice></term>
206
+<listitem>
207
+<para><action>Start a new palette in the current window.</action></para>
208
+</listitem>
209
+</varlistentry>
210
+
211
+<varlistentry>
212
+<term><menuchoice>
213
+<guimenu>File</guimenu>
214
+<guimenuitem>New Window</guimenuitem>
215
+</menuchoice></term>
216
+<listitem>
217
+<para><action>Open a new window</action></para>
218
+</listitem>
219
+</varlistentry>
220
+
221
+<varlistentry>
222
+<term><menuchoice>
223
+<shortcut><keycombo action="simul">&Ctrl;
224
+<keycap>O</keycap></keycombo></shortcut>
225
+<guimenu>File</guimenu>
226
+<guimenuitem>Open</guimenuitem>
227
+</menuchoice></term>
228
+<listitem>
229
+<para><action>Open a saved palette.</action></para>
230
+</listitem>
231
+</varlistentry>
232
+
233
+<varlistentry>
234
+<term><menuchoice>
235
+<guimenu>File</guimenu>
236
+<guimenuitem>Open Recent</guimenuitem>
237
+</menuchoice></term>
238
+<listitem>
239
+<para><action>Reopen a palette that you have recently been
240
+editing.</action></para>
241
+</listitem>
242
+</varlistentry>
243
+
244
+<varlistentry>
245
+<term><menuchoice>
246
+<shortcut><keycombo action="simul">&Ctrl;
247
+<keycap>S</keycap></keycombo></shortcut>
248
+<guimenu>File</guimenu>
249
+<guimenuitem>Save</guimenuitem>
250
+</menuchoice></term>
251
+<listitem>
252
+<para><action>Save the currently open palette.</action></para>
253
+</listitem>
254
+</varlistentry>
255
+
256
+<varlistentry>
257
+<term><menuchoice>
258
+<guimenu>File</guimenu>
259
+<guimenuitem>Save As...</guimenuitem>
260
+</menuchoice></term>
261
+<listitem>
262
+<para><action>Save the currently open palette with a new
263
+name.</action></para>
264
+</listitem>
265
+</varlistentry>
266
+
267
+<varlistentry>
268
+<term><menuchoice>
269
+<shortcut><keycombo action="simul">&Ctrl;
270
+<keycap>W</keycap></keycombo></shortcut>
271
+<guimenu>File</guimenu>
272
+<guimenuitem>Close</guimenuitem>
273
+</menuchoice></term>
274
+<listitem>
275
+<para><action>Close</action> the current &kcoloredit; window</para>
276
+</listitem>
277
+</varlistentry>
278
+
279
+<varlistentry>
280
+<term><menuchoice>
281
+<shortcut><keycombo action="simul">&Ctrl;
282
+<keycap>Q</keycap></keycombo></shortcut>
283
+<guimenu>File</guimenu>
284
+<guimenuitem>Quit</guimenuitem>
285
+</menuchoice></term>
286
+<listitem>
287
+<para><action>Quit</action> &kcoloredit;.</para>
288
+</listitem>
289
+</varlistentry>
290
+</variablelist>
291
+
292
+</sect1>
293
+
294
+<sect1 id="edit-menu">
295
+<title>The <guimenu>Edit</guimenu> Menu</title>
296
+
297
+<variablelist>
298
+<varlistentry>
299
+<term><menuchoice>
300
+<shortcut><keycombo action="simul">&Ctrl;
301
+<keycap>X</keycap></keycombo></shortcut>
302
+<guimenu>Edit</guimenu>
303
+<guimenuitem>Cut</guimenuitem>
304
+</menuchoice></term>
305
+<listitem>
306
+<para><action>Cut the currently selected color to the
307
+clipboard.</action></para>
308
+</listitem>
309
+</varlistentry>
310
+
311
+<varlistentry>
312
+<term><menuchoice>
313
+<shortcut><keycombo action="simul">&Ctrl;
314
+<keycap>C</keycap></keycombo></shortcut>
315
+<guimenu>Edit</guimenu>
316
+<guimenuitem>Copy</guimenuitem>
317
+</menuchoice></term>
318
+<listitem>
319
+<para><action>Copy the currently selected color to the
320
+clipboard.</action></para>
321
+</listitem>
322
+</varlistentry>
323
+
324
+<varlistentry>
325
+<term><menuchoice>
326
+<shortcut><keycombo action="simul">&Ctrl;
327
+<keycap>V</keycap></keycombo></shortcut>
328
+<guimenu>Edit</guimenu>
329
+<guimenuitem>Paste</guimenuitem>
330
+</menuchoice></term>
331
+<listitem>
332
+<para><action>Paste a color from the clipboard.</action></para>
333
+</listitem>
334
+</varlistentry>
335
+</variablelist>
336
+
337
+</sect1>
338
+
339
+<sect1 id="color-menu">
340
+<title>The <guimenu>Color</guimenu> Menu</title>
341
+
342
+<variablelist>
343
+<varlistentry>
344
+<term><menuchoice>
345
+<guimenu>Color</guimenu>
346
+<guimenuitem>From Palette</guimenuitem>
347
+</menuchoice></term>
348
+<listitem>
349
+<para><action>Find the color currently selected in the palette, in the
350
+color selector on the left.</action></para><!-- eww... needs rewrite -->
351
+</listitem>
352
+</varlistentry>
353
+
354
+<varlistentry>
355
+<term><menuchoice>
356
+<guimenu>Color</guimenu>
357
+<guimenuitem>From Screen</guimenuitem>
358
+</menuchoice></term>
359
+<listitem>
360
+<para><action>Pick a color from anywhere on the screen, and find it
361
+in the color selector on the left.</action></para>
362
+</listitem>
363
+</varlistentry>
364
+</variablelist>
365
+
366
+</sect1>
367
+
368
+<sect1 id="settings-menu">
369
+<title>The <guimenu>Settings</guimenu> Menu</title>
370
+
371
+<variablelist>
372
+<varlistentry>
373
+<term><menuchoice>
374
+<guimenu>Settings</guimenu>
375
+<guimenuitem>Hide/Show Toolbar</guimenuitem>
376
+</menuchoice></term>
377
+<listitem>
378
+<para><action>Toggle on and off the toolbar icons.</action></para>
379
+</listitem>
380
+</varlistentry>
381
+
382
+<varlistentry>
383
+<term><menuchoice>
384
+<guimenu>Settings</guimenu>
385
+<guimenuitem>Hide/Show Statusbar</guimenuitem>
386
+</menuchoice></term>
387
+<listitem>
388
+<para><action>Toggle on and off the status bar.</action></para>
389
+</listitem>
390
+</varlistentry>
391
+
392
+<varlistentry>
393
+<term><menuchoice>
394
+<guimenu>Settings</guimenu>
395
+<guimenuitem>Hide/Show Color Names</guimenuitem>
396
+</menuchoice></term>
397
+<listitem>
398
+<para>If the currently open palette has color name, <action>display
399
+them alongside the colors</action>.</para>
400
+</listitem>
401
+</varlistentry>
402
+
403
+<varlistentry>
404
+<term><menuchoice>
405
+<guimenu>Settings</guimenu>
406
+<guimenuitem>Configure Shortcuts...</guimenuitem>
407
+</menuchoice></term>
408
+<listitem>
409
+<para><action>Configure</action> the keyboard keys you use to access the 
410
+different actions.</para>
411
+</listitem>
412
+</varlistentry>
413
+
414
+<varlistentry>
415
+<term><menuchoice>
416
+<guimenu>Settings</guimenu>
417
+<guimenuitem>Configure Toolbars...</guimenuitem>
418
+</menuchoice></term>
419
+<listitem>
420
+<para><action>Configure</action> the items you want to put in the toolbar
421
+</para>
422
+</listitem>
423
+</varlistentry>
424
+
425
+</variablelist>
426
+
427
+</sect1>
428
+
429
+<sect1 id="help-menu">
430
+<title>The <guimenu>Help</guimenu> Menu</title>
431
+
432
+&help.menu.documentation;
433
+
434
+</sect1>
435
+
436
+</chapter>
437
+
438
+<chapter id="credits-and-licenses">
439
+<title>Credits and Licenses</title>
440
+
441
+<para>&kcoloredit; copyright 2000 &Artur.Rataj;</para>
442
+
443
+<para>Documentation copyright 2000 &Artur.Rataj;</para>
444
+
445
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
446
+
447
+&underFDL;
448
+&underGPL;
449
+</chapter>
450
+
451
+<appendix id="installation">
452
+<title>Installation</title>
453
+
454
+&install.intro.documentation;
455
+
456
+&install.compile.documentation;
457
+
458
+</appendix>
459
+
460
+</book>
461
+<!--
462
+Local Variables:
463
+mode: sgml
464
+sgml-omittag: nil
465
+sgml-shorttag: t
466
+End:
467
+-->
468
+

BIN
doc/kdvi/KDVI-features.dvi View File


+ 480
- 0
doc/kdvi/KDVI-features.tex View File

@@ -0,0 +1,480 @@
1
+\documentclass{article}
2
+
3
+\usepackage{amstext}
4
+\usepackage{colordvi}
5
+\usepackage{graphicx}
6
+\usepackage{times} 
7
+\usepackage[arrow,matrix,curve,ps]{xy}
8
+\xyoption{dvips}
9
+\usepackage[active]{srcltx}
10
+\usepackage[hypertex]{hyperref}
11
+\sloppy
12
+
13
+\newcommand{\KDVI}{{\sf KDVI 1.1}}
14
+
15
+\begin{document}
16
+
17
+\title{Support for \TeX\ extensions in \KDVI}
18
+
19
+\author{Stefan Kebekus}
20
+
21
+\maketitle
22
+\begin{abstract}
23
+  This document describes the extensions to the standard format of DVI
24
+  files which \KDVI\ implements in order to support PostScript
25
+  inclusion and hyperlinks.
26
+  
27
+  \KDVI\ is a program that displays DVI-files generated by the \TeX\ 
28
+  typesetting system. If you don't know what \TeX\ is then you are
29
+  most likely not interested in this. If you would like to know how to
30
+  use special features of \KDVI, then you can find examples here.
31
+\end{abstract}
32
+
33
+\tableofcontents
34
+
35
+\section{What's all this}
36
+
37
+The DVI-previewing program \KDVI\ is able to display standard
38
+DVI-files as specified in \cite{Level0Std}. In order to support
39
+graphics inclusion, hyperlinks and non-standard fonts, \KDVI\ 
40
+implements a number of features which extend \cite{Level0Std}. In
41
+particular, \KDVI\ supports a number of \TeX 's $\backslash${\tt
42
+  special} commands. The aim of this document is to describe these
43
+extensions and give examples of their use.
44
+
45
+Unfortunately, in spite of several attempts to find a sound standard
46
+for the use of $\backslash${\tt special} commands, there is now a
47
+wealth of competing and mutually incompatible definitions.
48
+
49
+\KDVI\ does not attempt to support all possible features. Instead, we
50
+tried to implement those which are most useful and used most commonly.
51
+In this, we have tried to be consistent with the {\sf dvips} program.
52
+\KDVI\ does not support a number of outdated and unsane standards, nor
53
+does it support features which impair the system security.
54
+
55
+
56
+\section{Virtual fonts}
57
+
58
+\KDVI\ supports ``virtual fonts''. This enables \TeX\ to use
59
+PostScript fonts. For more information, and a complete specification,
60
+consult \cite{dvips}.
61
+
62
+\paragraph*{Example}
63
+
64
+This text uses the ``Times'' family of fonts instead of the ``Computer
65
+Modern'' fonts which are usually used by \TeX. This was realized in
66
+\LaTeX 2$\epsilon$ by including the line
67
+\begin{verbatim}
68
+\usepackage{times} 
69
+\end{verbatim}
70
+in the header of this document.
71
+
72
+
73
+\section{PostScript support}
74
+
75
+\KDVI\ implements basic facilities to include PostScript graphics in a
76
+DVI file, which will enable the reader to conviently read most
77
+scientific papers which use such features. 
78
+
79
+\subsection{Literal PostScript}
80
+
81
+\KDVI\ supports the inclusion of PostScript into DVI-files by means of
82
+the quote-special. The syntax follows the specification of
83
+\cite{dvips}:
84
+\begin{verbatim}
85
+\special{" PostScript-commands}
86
+\end{verbatim}
87
+The PostScript-commands are not directly included, in fact they are
88
+sandwiched between a {\tt save} and {\tt restore} pair. That way
89
+\KDVI\ ensures that the command cannot affect PostScript-commands
90
+which appear somewhere else in your file.
91
+
92
+\paragraph*{Example}
93
+
94
+Figure~\ref{quote-special} shows an example taken from \cite{dvips}.
95
+The generating \TeX -code is
96
+\begin{verbatim}
97
+\vbox to 100bp{\vss
98
+\special{" newpath 0 0 moveto 100 100 lineto
99
+ 300 0 lineto closepath gsave 0.8 setgray fill 
100
+ grestore stroke}}
101
+\end{verbatim}
102
+
103
+\begin{figure}
104
+\vbox to 100bp{\vss
105
+\special{" newpath 0 0 moveto 100 100 lineto 300 0 lineto closepath gsave 0.8 setgray fill grestore stroke}}
106
+\caption{Graphic generated by literal PostScript inclusion\label{quote-special}}
107
+\end{figure}
108
+
109
+
110
+\subsection{Direct PostScript}
111
+
112
+\KDVI\ supports the inclusion of PostScript into DVI-files by means of
113
+the direct-special. The syntax follows the specification of
114
+\cite{dvips}:
115
+\begin{verbatim}
116
+\special{ps: Postscript-commands}
117
+\end{verbatim}
118
+The PostScript-commands are directly included, and there is no
119
+protective {\tt save} and {\tt restore} pair. The use of this command
120
+is not recommended, as it may have funny side effects on other
121
+PostScript commands which appear later in your file.
122
+
123
+\KDVI\ also supports the following syntactical variants which are
124
+explained in \cite{dvips}:
125
+\begin{verbatim}
126
+\special{ps: Postscript-commands}
127
+\special{ps::[begin] Postscript-commands}
128
+\special{ps:: Postscript-commands}
129
+\special{ps::[end] Postscript-commands}
130
+\end{verbatim}
131
+The variant
132
+\begin{verbatim}
133
+\special{ps: plotfile filename}
134
+\end{verbatim}
135
+is not currently supported.
136
+
137
+\paragraph*{Example}
138
+
139
+The command
140
+\begin{verbatim}
141
+\includegraphics[height=3cm, angle=20]{aboutkde.ps}
142
+\end{verbatim}
143
+which is used in section~\ref{chap:eps} uses the direct-special
144
+internally in order to set the rotation.
145
+
146
+\subsection{Literal headers}
147
+
148
+Literal headers work as described in \cite{dvips}.
149
+\begin{verbatim}
150
+\special{! PostScript-Header-commands}
151
+\end{verbatim}
152
+
153
+\paragraph*{Example}
154
+The following diagram, which was generated using the \Xy -pic macro
155
+packages uses literal postscript inclusion which relies on literal
156
+headers.
157
+$$
158
+\xymatrix{ {\tilde X}
159
+  \ar@{-->}[rrd]_{\exists \alpha} \ar[rrrr]^{\eta}_{\txt{\tiny
160
+      normalization}} \ar@/_/ [rrdd]_ {\tilde \pi} & & & & {X}
161
+  \ar@/^/[lldd]^{\pi}  \\ & & {X'}
162
+  \ar@{-->}[rru]_{\exists \beta} \ar@{-->}[d]_{\exists \pi'} & & \\ & &
163
+  {Y}& &}
164
+$$
165
+Note that the actual headers are defined on the first page of the
166
+document. This was a major source of trouble in earlier versions of
167
+KDVI.
168
+
169
+
170
+
171
+\subsection{PostScript headers}
172
+
173
+PostScript headers work as described in \cite{dvips}. This command is
174
+very similar to the literal header command, but expects the name of a
175
+file which should be included.
176
+\begin{verbatim}
177
+\special{header=filename}
178
+\end{verbatim}
179
+
180
+
181
+
182
+
183
+\subsection{EPS inclusion}\label{chap:eps}
184
+
185
+A popular way to include PostScript-files into \TeX\ documents uses
186
+the PSFile $\backslash${\tt special} command. Again this is explained
187
+in detail in \cite{dvips}. Currently \KDVI\ supports the syntax
188
+\begin{verbatim}
189
+\special{psfile=File keyword=value keyword=value ...}
190
+\end{verbatim}
191
+Where keyword is one of the following
192
+\begin{description}
193
+\item[llx] lower left corner of the bounding box, $x$-coordinate
194
+\item[lly] lower left corner of the bounding box, $y$-coordinate
195
+\item[urx] upper right corner of the bounding box, $x$-coordinate
196
+\item[ury] upper right corner of the bounding box, $y$-coordinate
197
+\item[rwi] width of the bounding box. If $llx-urx \not = rwi$, then
198
+the boundig box is scaled accordingly. 
199
+\item[rhi] height of the bounding box If $lly-ury \not = rhi$, then
200
+the boundig box is scaled accordingly.
201
+\item[angle] rotates the picture counterclockwise
202
+\end{description}
203
+Unknown keywords are silently ignored. The keywords {\tt llx}, {\tt
204
+  lly}, {\tt urx}, {\tt ury} and {\tt rwi} are usually generated by
205
+the {\tt epsf} macros.  The keywords {\tt hoffset}, {\tt voffset},
206
+{\tt hsize}, {\tt vsize}, {\tt hscale}, {\tt vscale}, {\tt angle} and
207
+{\tt clip} are not currently implemented. The ``uncompression''
208
+feature of {\sf dvips} and {\sf xdvi} which allows to execute
209
+arbitrary commands in via the syntactical variant
210
+\begin{verbatim}
211
+\special{psfile="'shell-command" keyword=value ...}
212
+\end{verbatim}
213
+is deliberately not implemented for security reasons.
214
+
215
+\paragraph*{Example}
216
+Figure~\ref{epsf-special} shows an embedded postscript-file. 
217
+\begin{figure}
218
+  \begin{center}
219
+    \includegraphics[height=3cm]{aboutkde.ps}
220
+    \includegraphics[height=4cm]{aboutkde.ps}
221
+    \includegraphics[height=3cm, angle=20]{aboutkde.ps}
222
+  \end{center}
223
+\caption{Embedded PostScript graphic\label{epsf-special}}
224
+\end{figure}
225
+This was easily realized by including the line
226
+\begin{verbatim}
227
+\usepackage{graphicx}
228
+\end{verbatim}
229
+into the header of this document, and the lines
230
+\begin{verbatim}
231
+\includegraphics[height=3cm]{aboutkde.ps}
232
+\includegraphics[height=4cm]{aboutkde.ps}
233
+\includegraphics[height=3cm, angle=20]{aboutkde.ps}
234
+\end{verbatim}
235
+at the place where the graphic should appear. It is strongly
236
+recommended to use the {\tt graphicx} macro package for this purpose.
237
+\begin{figure}
238
+  \begin{center}
239
+    \includegraphics[height=2cm, bb=0 0 150 50]{nonexistent.ps}
240
+  \end{center}
241
+\caption{Reference to a non-existent PS-file\label{nonex-special}}
242
+\end{figure}
243
+Figure~\ref{nonex-special} shows how \KDVI\ warns you about
244
+non-existent files.
245
+
246
+
247
+\section{Hypertext support}
248
+
249
+\KDVI\ supports commands for hyperlink support which commands
250
+establish links between sections of documents in a manner exactly
251
+analogous to the HTML of the WWW. For a detailed specification we
252
+refer to \cite{HFAQ99} or \cite{Rah98}. Note, however, that \KDVI\ 
253
+does currently not allow nested hyperlinks.
254
+
255
+\subsection{Hyper-Labels}
256
+
257
+The commands
258
+\begin{verbatim}
259
+\special{html:<a name="namestring">}
260
+\special{html:</a>}
261
+\end{verbatim}
262
+labels the current point of the text for later reference.
263
+
264
+\subsection{Hyper-References}
265
+
266
+The commands 
267
+\begin{verbatim}
268
+\special{html:<a href="hrefstring">}
269
+Text
270
+\special{html:</a>}
271
+\end{verbatim}
272
+makes {\tt Text} a link to {\tt hrefstring}, where {\tt hrefstring} is
273
+an absolute or relative URL in the standard format used on the
274
+internel. If {\tt hrefstring} is of the form {\tt \#label} then it
275
+points to the section of the current document which is labeled using
276
+the labeling command described above:
277
+\begin{verbatim}
278
+\special{html:<a name="namestring">}
279
+\end{verbatim}
280
+
281
+
282
+
283
+\paragraph*{Example}
284
+This document features a clickable table of contents, and also the
285
+references can be clicked on. This has been achieved by using the {\tt
286
+  hyperref} macro package in \LaTeX\ by including the line
287
+\begin{verbatim}
288
+\usepackage[hypertex]{hyperref}
289
+\end{verbatim}
290
+into the document preamble. Everything else is automatic.
291
+
292
+Here is an external link which points to the \href{http://www.kde.org}{main
293
+  website of the KDE project}. For this, the command {\tt href} of the
294
+{\tt hyperref} macro package was used:
295
+\begin{verbatim}
296
+\href{http://www.kde.org}{main
297
+  website of the KDE project}
298
+\end{verbatim}
299
+
300
+
301
+\paragraph{Warning.} On some installations, the {\tt
302
+  hyperref} macro package is configured to generate PostScript
303
+hyperlinks for {\tt dvips} by default. On these systems, using the
304
+line
305
+\begin{verbatim}
306
+\usepackage{hyperref}
307
+\end{verbatim}
308
+will generate DVI file whose hyperlinks are not visible in KDVI.
309
+Worse, KDVI will call the {\tt ghostview} PostScript interpreter for
310
+every page, which makes the display very slow.
311
+
312
+
313
+
314
+\section{Colored \Red{text} \Green{and} \Blue{background}}
315
+
316
+The DVI specials for colored text are supported as they are described
317
+in \cite{dvips}. 
318
+
319
+\paragraph*{Example} In this document, the following code was used to
320
+generate the text below.
321
+\begin{verbatim}
322
+\usepackage{colordvi}
323
+
324
+...
325
+
326
+\textGreen This text is green but here we are
327
+\Red{switching to red, \Blue{nesting blue}, 
328
+recovering the red} and back to original green.
329
+\textCyan The text from here on will be cyan 
330
+unless \Yellow{locally changed to yellow}. Now
331
+we are back to cyan. \textBlack
332
+\end{verbatim}
333
+
334
+This gave the following output:
335
+\begin{verse}
336
+ \textGreen This text is green but here
337
+we are \Red{switching to red, \Blue{nesting blue}, recovering the red}
338
+and back to original green.  \textCyan The text from here on will be
339
+cyan unless \Yellow{locally changed to yellow}. Now we are back to
340
+cyan.  \textBlack
341
+\end{verse}
342
+
343
+To set the background color of the page, the command
344
+\background{Lavender}
345
+\begin{verbatim}
346
+\background{Lavender}
347
+\end{verbatim}
348
+was used. To switch back to normal, the command
349
+\begin{verbatim}
350
+\background{White}
351
+\end{verbatim}
352
+was placed somewhere on the following page. As you see, the background
353
+command does not fit well into \LaTeX's philosophy and should be
354
+avoided.
355
+
356
+\section{Rotated Text}
357
+
358
+Rotated text can sometimes be useful, e.g. to fit large table onto a
359
+single page. This is used, e.g.~in the style files of journals of the
360
+American Astronomical Society. Here is one example.
361
+
362
+\begin{table}[h]
363
+  \centering
364
+\begin{tabular}{l|ll}
365
+  & \rotatebox{90}{uses \TeX} & \rotatebox{90}{uses Linux} \\ \hline
366
+  Stefan & $\times$ & $\times$ \\
367
+  Anke & & $\times$ \\
368
+  Thomas & $\times$ &\\
369
+\end{tabular}
370
+\end{table}
371
+
372
+This was easily realized by including the line
373
+\begin{verbatim}
374
+\usepackage{graphicx}
375
+\end{verbatim}
376
+into the header of this document. The table itself was then typeset by
377
+{\footnotesize
378
+\begin{verbatim}
379
+\begin{tabular}{l|ll}
380
+  & \rotatebox{90}{uses \TeX} & \rotatebox{90}{uses Linux} \\ \hline
381
+  Stefan & $\times$ & $\times$ \\
382
+  Anke & & $\times$ \\
383
+  Thomas & $\times$ &\\
384
+\end{tabular}
385
+\end{verbatim}
386
+}
387
+
388
+\section{Source text specials}
389
+
390
+\KDVI\ is able to make use of source file information which is included
391
+in the DVI file. To include source file information, a {\tt special}
392
+command like to following should be included at the beginning of every
393
+paragraph or every line:
394
+\begin{verbatim}
395
+\special{src:123text.tex}
396
+\end{verbatim}
397
+This tells \KDVI\ that the next paragraph should be associated with
398
+line 123 in the source file text.tex.
399
+
400
+It is of course not practical to add these commands manually to the
401
+beginning of every line ---see the \href{help:/kdvi}{Handbook of
402
+\KDVI} to learn how to add the special commands automatically to your
403
+DVI files.
404
+
405
+The main use of source file specials is the interaction between \KDVI\
406
+and your editor. Starting from version~1.0, both \emph{forward search}
407
+and \emph{inverse search} are supported.
408
+
409
+\subsection{Forward search}
410
+
411
+Forward search is a feature that helps you find the place in the DVI
412
+file that corresponds to a certain line in the source text. If source
413
+file information is included, you can find the place in the DVI file
414
+{\tt test.dvi} which corresponds to line 1234 in the source file {\tt
415
+text.tex} by starting \KDVI\ like this:
416
+\begin{verbatim}
417
+kdvi file:test.dvi#1234text.tex
418
+\end{verbatim}
419
+In pracitse, this command line will be generated by a script that
420
+communicates with your editor. Currently, scripts for Emacs and XEmacs
421
+exist. As usual, the \href{help:/kdvi/forward-search.html}{Handbook of
422
+\KDVI} explains how to set up your editor with thest scripts.
423
+
424
+
425
+\subsection{Inverse search}
426
+
427
+\background{White}
428
+Inverse search means that you can click into the document in \KDVI,
429
+and your editor will open, load the source file and jump to the proper
430
+place. \KDVI\ currently supports the editors Emacs, Kate, NEdit, VI
431
+and XEmacs. Users who prefer a different editor can specify shell
432
+commands which are to be used. Again we refer to the
433
+\href{help:/kdvi/inverse-search.html}{Handbook of \KDVI} for a detailed explanation.
434
+
435
+\paragraph*{Example}
436
+If you are viewing this document in \KDVI, you can click anywhere with
437
+the middle mouse button (if your mouse has only two buttons, click
438
+left and right simultaneously). An editor will pop up, load the
439
+\LaTeX\ sourcefile and jump to the appropriate line in the
440
+text. Source specials has been added using the {\tt srcltx} macro
441
+package in \LaTeX\ by including the line
442
+\begin{verbatim}
443
+\usepackage[active]{srcltx}
444
+\end{verbatim}
445
+into the document preamble. Everything else is automatic.
446
+
447
+
448
+\begin{thebibliography}{CM97}
449
+
450
+\bibitem[Bha99]{HFAQ99}
451
+T.~Bhattacharya et al.
452
+\newblock {\em Hyper\TeX\ FAQ}
453
+\newblock available on the internet site of the preprint server of the
454
+ Los Alamos National Labatories at 
455
+\href{http://arXiv.org/hypertex}{\small \tt http://arXiv.org/hypertex}
456
+
457
+\bibitem[Rah98]{Rah98}
458
+S.~Rahts
459
+\newblock {\em Hypertext marks in \LaTeX: the {\sf hyperref} package}
460
+\newblock included in the tetex distribution. A copy can be found on KDVI's 
461
+home page at \hfill \linebreak
462
+\href{http://devel-home.kde.org/~kdvi/DVI/hyperref-manual.pdf}{\small \tt http://devel-home.kde.org/$\sim$kdvi/DVI/hyperref-manual.pdf}
463
+
464
+\bibitem[Rok00]{dvips}
465
+T.~Rokicki
466
+\newblock {\em DVIPS: A \TeX\ Driver}
467
+\newblock included in the tetex distribution. A copy can be found on KDVI's 
468
+home page at \hfill \linebreak
469
+\href{http://devel-home.kde.org/~kdvi/DVI/dvips.dvi}{\small \tt http://devel-home.kde.org/$\sim$kdvi/DVI/dvips.dvi}
470
+
471
+\bibitem[TUG0]{Level0Std}
472
+The TUG DVI Driver Standards Committee
473
+\newblock {\em The DVI Driver Standard, Level 0}
474
+\newblock included in the tetex distribution. A copy can be found on KDVI's 
475
+home page at \hfill \linebreak
476
+\href{http://devel-home.kde.org/~kdvi/DVI/dvistd0.dvi}{\small \tt http://devel-home.kde.org/$\sim$kdvi/DVI/dvistd0.dvi}
477
+
478
+
479
+\end{thebibliography}
480
+\end{document}

+ 4
- 0
doc/kdvi/Makefile.am View File

@@ -0,0 +1,4 @@
1
+
2
+KDE_LANG = en
3
+KDE_DOCS = AUTO
4
+

+ 3351
- 0
doc/kdvi/aboutkde.ps
File diff suppressed because it is too large
View File


+ 1072
- 0
doc/kdvi/index.docbook
File diff suppressed because it is too large
View File


+ 102
- 0
doc/kdvi/kdvi-search.el View File

@@ -0,0 +1,102 @@
1
+;;; (X)Emacs frontend to forward search with kdvi. See the section on
2
+;;; FORWARD SEARCH in the kdvi manual for more information on forward
3
+;;; search, and for an explanation how to use this script. This script
4
+;;; is a modified version of the script "xdvi-search.el" by Stefan
5
+;;; Ulrich <ulrich@cis.uni-muenchen.de>, version 2000/03/13. The
6
+;;; modifications were performed by Stefan Kebekus
7
+;;; <kebekus@kde.org>. Tested with Emacs 20.7.1 and Xemacs 21.4.
8
+;;;
9
+;;; This program is free software; you can redistribute it and/or
10
+;;; modify it under the terms of the GNU General Public License as
11
+;;; published by the Free Software Foundation; either version 2 of the
12
+;;; License, or (at your option) any later version.
13
+;;; 
14
+;;; This program is distributed in the hope that it will be useful,
15
+;;; but WITHOUT ANY WARRANTY; without even the implied warranty of
16
+;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17
+;;; General Public License for more details.
18
+;;; 
19
+;;; You should have received a copy of the GNU General Public License
20
+;;; along with this program; if not, write to the Free Software
21
+;;; Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
22
+;;; 02110-1301, USA.
23
+;;;
24
+;;; Please report bugs or improvements, etc. via the "Report bug"-Menu
25
+;;; of kdvi.
26
+;;;
27
+
28
+(defvar kdvi-script "kdvi"
29
+  "*Name of start script for kdvi.")
30
+
31
+(defun kdvi-jump-to-line ()
32
+  "Call kdvi-script to perform a `forward search' for current file and line number.
33
+See contents of kdvi-script for details.
34
+If AucTeX is used, the value of TeX-master-file is used as filename
35
+for the master .dvi file; else, the return value of kdvi-master-file-name
36
+is used (which see)."
37
+  (interactive)
38
+  (save-excursion
39
+    (save-restriction
40
+      (widen)
41
+      (beginning-of-line 1)
42
+      (let* (;;; current line in file, as found in the documentation
43
+	     ;;; of emacs. Slightly non-intuitive.
44
+	     (current-line (format "%d" (+ 1 (count-lines (point-min) (point)))))
45
+	     ;;; name of the `main' .tex file, which is also used as .dvi basename:
46
+	     (master-file (expand-file-name (if (fboundp 'TeX-master-file)
47
+					     (TeX-master-file t)
48
+					   (kdvi-get-masterfile (kdvi-master-file-name)))))
49
+	     ;;; .dvi file name:
50
+	     (dvi-file (concat (file-name-sans-extension master-file) ".dvi"))
51
+	     ;;; current source file name.
52
+	     (filename (expand-file-name (buffer-file-name))))
53
+	(start-process "kdvi"
54
+		       "kdvi-output" "kdvi" ;;; src-args
55
+		      ;;; args for -sourceposition:
56
+		       "--unique" (concat "file:" dvi-file "#src:" current-line filename)
57
+		       )))))
58
+
59
+(defun kdvi-get-masterfile (file)
60
+  "Small helper function for AucTeX compatibility.
61
+Converts the special value t that TeX-master might be set to
62
+into a real file name."
63
+  (if (eq file t)
64
+      (buffer-file-name)
65
+    file))
66
+
67
+
68
+(defun kdvi-master-file-name ()
69
+  "Emulate AucTeX's TeX-master-file function.
70
+Partly copied from tex.el's TeX-master-file and TeX-add-local-master."
71
+  (if (boundp 'TeX-master)
72
+      TeX-master
73
+    (let ((master-file (read-file-name "Master file (default this file): ")))
74
+      (if (y-or-n-p "Save info as local variable? ")
75
+	  (progn
76
+	    (goto-char (point-max))
77
+	    (if (re-search-backward "^\\([^\n]+\\)Local Variables:" nil t)
78
+		(let* ((prefix (if (match-beginning 1)
79
+				   (buffer-substring (match-beginning 1) (match-end 1))
80
+				 ""))
81
+		      (start (point)))
82
+		  (re-search-forward (regexp-quote (concat prefix "End:")) nil t)
83
+		  (if (re-search-backward (regexp-quote (concat prefix "TeX-master")) start t)
84
+		      ;;; if TeX-master line exists already, replace it
85
+		      (progn
86
+			(beginning-of-line 1)
87
+			(kill-line 1))
88
+		    (beginning-of-line 1))
89
+		  (insert prefix "TeX-master: " (prin1-to-string master-file) "\n"))
90
+	      (insert "\n%%% Local Variables: "
91
+;;; mode is of little use without AucTeX ...
92
+;;;		      "\n%%% mode: " (substring (symbol-name major-mode) 0 -5)
93
+		      "\n%%% TeX-master: " (prin1-to-string master-file)
94
+		      "\n%%% End: \n"))
95
+	    (save-buffer)
96
+	    (message "(local variables written.)"))
97
+	(message "(nothing written.)"))
98
+      (set (make-local-variable 'TeX-master) master-file))))
99
+
100
+
101
+(provide 'kdvi-search)
102
+

BIN
doc/kdvi/optionrequester1.png View File


BIN
doc/kdvi/optionrequester2.png View File


+ 184
- 0
doc/kdvi/srcltx.sty View File

@@ -0,0 +1,184 @@
1
+
2
+% ------------------------------------------------------------------------
3
+% File: srcltx.sty
4
+%       ==========
5
+%
6
+% Version 1.002 1999 Sep 3  (modified to change \everypar)
7
+%               by David Carlisle
8
+%
9
+% Version 1.001 1998 Dec 23 (modified to change \output)
10
+%               by Berthold Horn
11
+%
12
+% This package was originally written by Aleksander Simonic (the
13
+% author of WinEdt Shell) to implement a source file tracking and
14
+% DVI "SRC" specials for LaTeX.
15
+%
16
+% This package comes with no guarantees and no reserved rights.
17
+% You can use or modify this file at your own risk.
18
+% ************************************************************************
19
+% NOTE: TeX commands are case sensitive. You have to use uppercase
20
+% \Input to take advantage of this package
21
+%
22
+% This package supports nested \Input commands...
23
+% File extension should be specified in \Input!
24
+%
25
+% This file should be placed in a directory where your LaTeX is
26
+% looking for inputs (eg. ...\localtexmf\tex for MiKTeX).
27
+%
28
+% If you are writing a book with WinEdt and LaTeX simply
29
+% include this file and use \include{mychapter} command...
30
+% This way all the necessary specials for DVI Search and
31
+% Inverse Search are inserted in your DVI File.
32
+%
33
+% WinEdt will be able to track Errors from your LOG file.
34
+%
35
+% ************************************************************************
36
+%
37
+% Some TeX implementations (eg. MiKTeX 1.20 [or later]) can insert
38
+% the SRC specials much better than any macro package. Consult your
39
+% TeX documentation to see if it is better to leave the task to your
40
+% TeX. You can still use the [inactive] version of this package to
41
+% take advantage of the re-defined Input commands and thus allowing
42
+% WinEdt to keep track of errors in included source files.
43
+%
44
+% MiKTeX inserts the SRC specials in the DVI file if you start
45
+% [La]TeX with --src qualifier (see MiKTeX's Manual:
46
+% ...\texmf\Doc\MiKTeX\MiKTeX.pdf for more info).
47
+%
48
+% ************************************************************************
49
+%
50
+% * NOTE: Some TeX implementations add the file type to the "\jobname".
51
+% In that case the definition of the "\MainFile" should be modified to:
52
+%
53
+%     \def\MainFile{\jobname} instead of \def\MainFile{\jobname.tex}.
54
+%
55
+% ************************************************************************
56
+%
57
+% *** Example - Your LaTeX thesis document may look like this:
58
+%
59
+%\documentclass[12pt]{report}
60
+%\usepackage[centertags]{amstex}
61
+%\usepackage{thesis,newlfont,amsthm}
62
+%\usepackage[active]{srcltx}
63
+%%No src specials are written when loading the package by
64
+%%\usepackage[inactive]{srcltx}
65
+%
66
+% .... Preamble ....
67
+%
68
+%\begin{document}
69
+%
70
+% .... Title, Author etc. ....
71
+%
72
+%\WinEdt{?0000} % Do not process any Errors (Overful/Underful Boxes)
73
+%\beforepreface
74
+%\WinEdt{?1111} % Process All Types of Errors from here on
75
+%\include{ABS}
76
+%\include{ACK}
77
+%\afterpreface
78
+%\include{chapter0}
79
+%\include{chapter1}
80
+%\include{chapter2}
81
+%\include{chapter3}
82
+%\bibliographystyle{amsplain}
83
+%\bibliography{xbib}
84
+%\end{document}
85
+%
86
+% ------------------------------------------------------------------------
87
+\NeedsTeXFormat{LaTeX2e}
88
+\ProvidesPackage{srcltx}[1999/10/11 v1.002 DVI Search]
89
+\newif\ifSRCOK \SRCOKtrue
90
+\DeclareOption{active}{\SRCOKtrue}
91
+\DeclareOption{inactive}{\SRCOKfalse}
92
+\ExecuteOptions{inactive}
93
+\ProcessOptions
94
+% ------------------------------------------------------------------------
95
+\newcount\PAGETOP
96
+\newcount\LASTLINE
97
+\global\PAGETOP=1
98
+\global\LASTLINE=-1
99
+\gdef\MainFile{\jobname.tex}% ".tex" needed for MiKTeX
100
+\gdef\CurrentInput{\MainFile}
101
+\newcount\INPSP
102
+\global\INPSP=0
103
+\def\EJECT{\SRC\eject}
104
+\def\WinEdt#1{\typeout{:#1}}% WinEdt LOG MODE and INPUT
105
+% ------------------------------------------------------------------------
106
+%If your are using DVIWIN remove the \space from the definitions below...
107
+\def\SRC{\ifSRCOK%
108
+  \ifnum\inputlineno>\LASTLINE%
109
+    \ifnum\LASTLINE<0%
110
+      \global\PAGETOP=\inputlineno%
111
+    \fi%
112
+    \global\LASTLINE=\inputlineno%
113
+    \ifnum\INPSP=0%
114
+      \ifnum\inputlineno>\PAGETOP%
115
+        \special{src:\the\inputlineno\space\CurrentInput}%
116
+      \fi%
117
+    \else%
118
+      \special{src:\the\inputlineno\space\CurrentInput}%
119
+    \fi%
120
+  \fi%
121
+\fi}
122
+% ------------------------------------------------------------------------
123
+\def\PUSH#1{%
124
+\SRC%
125
+\ifnum\INPSP=0 \global\let\INPSTACKA=\CurrentInput \else%
126
+\ifnum\INPSP=1 \global\let\INPSTACKB=\CurrentInput \else%
127
+\ifnum\INPSP=2 \global\let\INPSTACKC=\CurrentInput \else%
128
+\ifnum\INPSP=3 \global\let\INPSTACKD=\CurrentInput \else%
129
+\ifnum\INPSP=4 \global\let\INPSTACKE=\CurrentInput \else%
130
+\ifnum\INPSP=5 \global\let\INPSTACKF=\CurrentInput \else%
131
+               \global\let\INPSTACKX=\CurrentInput \fi\fi\fi\fi\fi\fi%
132
+\gdef\CurrentInput{#1}%
133
+\WinEdt{<+ \CurrentInput}%
134
+\global\LASTLINE=0%
135
+\ifSRCOK\special{src:1\CurrentInput}\fi%
136
+\global\advance\INPSP by 1}
137
+%
138
+\def\POP{%
139
+\ifnum\INPSP>0 \global\advance\INPSP by -1  \fi%
140
+\ifnum\INPSP=0 \global\let\CurrentInput=\INPSTACKA \else%
141
+\ifnum\INPSP=1 \global\let\CurrentInput=\INPSTACKB \else%
142
+\ifnum\INPSP=2 \global\let\CurrentInput=\INPSTACKC \else%
143
+\ifnum\INPSP=3 \global\let\CurrentInput=\INPSTACKD \else%
144
+\ifnum\INPSP=4 \global\let\CurrentInput=\INPSTACKE \else%
145
+\ifnum\INPSP=5 \global\let\CurrentInput=\INPSTACKF \else%
146
+               \global\let\CurrentInput=\INPSTACKX \fi\fi\fi\fi\fi\fi%
147
+\WinEdt{<-}%
148
+\global\LASTLINE=\inputlineno%
149
+\global\advance\LASTLINE by -1%
150
+\SRC}
151
+% ------------------------------------------------------------------------
152
+% Dummy Input: can be used as \INPUT{<file>.bbl} to collect \bibitems
153
+\def\INPUT#1{\relax}
154
+% ------------------------------------------------------------------------
155
+% Redefine the original \include command
156
+\let\OldINCLUDE=\include
157
+\def\include#1{%Always ".tex" file type!
158
+\EJECT%
159
+\PUSH{#1.tex}%
160
+\OldINCLUDE{#1}%
161
+\POP}
162
+% ------------------------------------------------------------------------
163
+\def\Input#1{%Specify File Extension!
164
+\PUSH{#1}%
165
+\input #1%
166
+\POP}
167
+% ------------------------------------------------------------------------
168
+% Note that these have been defined to concatenate the \SRC with
169
+% whatever those token lists did before, just in case they were not
170
+% empty token lists.  Of course, later definitions may undo all this...
171
+\let\originalxxxeverypar\everypar
172
+\newtoks\everypar
173
+\originalxxxeverypar{\the\everypar\expandafter\SRC}
174
+%\everypar\expandafter{\the\everypar\expandafter\SRC}
175
+% ??? Remove the following line if you encounter problems:
176
+\everymath\expandafter{\the\everymath\expandafter\SRC}
177
+% ------------------------------------------------------------------------
178
+% Redefine the \bibliography command:
179
+\let\zzzxxxbibliography=\bibliography
180
+\def\bibliography#1{\PUSH{\jobname.bbl}\zzzxxxbibliography{#1}\POP}
181
+%------------------------------------------------------------------------
182
+% Modification to output routine to turn off \SRC while \output is active
183
+\output\expandafter{\expandafter\SRCOKfalse\the\output}
184
+%------------------------------------------------------------------------

+ 146
- 0
doc/kdvi/srctex.sty View File

@@ -0,0 +1,146 @@
1
+% ------------------------------------------------------------------------
2
+% File: srctex.sty
3
+%       ==========
4
+%
5
+% Version 1.002 1999 Sep 3  (modified to change \everypar)
6
+%               by David Carlisle
7
+%
8
+% Version 1.001 1998 Dec 23 (modified to change \output)
9
+%               by Berthold Horn
10
+%
11
+% This package was originally written by Aleksander Simonic (the
12
+% author of WinEdt Shell) to implement a source file tracking and
13
+% DVI "SRC" specials for TeX.
14
+%
15
+% This package comes with no guarantees and no reserved rights.
16
+% You can use or modify this file at your own risk.
17
+% ************************************************************************
18
+% NOTE: TeX commands are case sensitive. You have to use uppercase
19
+% \Input to take advantage of this package
20
+%
21
+% This package supports nested \Input commands...
22 </