diff options
Diffstat (limited to 'Master/texmf-dist/doc/epspdf')
-rw-r--r-- | Master/texmf-dist/doc/epspdf/COPYING | 339 | ||||
-rw-r--r-- | Master/texmf-dist/doc/epspdf/default.css | 56 | ||||
-rw-r--r-- | Master/texmf-dist/doc/epspdf/epspdf.install | 285 | ||||
-rw-r--r-- | Master/texmf-dist/doc/epspdf/epspdf_UG.html | 185 | ||||
-rw-r--r-- | Master/texmf-dist/doc/epspdf/images/config_mac.png | bin | 0 -> 27971 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/epspdf/images/dia_save.png | bin | 0 -> 29314 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/epspdf/images/greenbroccoli.png | bin | 0 -> 71686 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/epspdf/images/main_w32.png | bin | 0 -> 6111 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/epspdf/index.html | 312 |
9 files changed, 1177 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/epspdf/COPYING b/Master/texmf-dist/doc/epspdf/COPYING new file mode 100644 index 00000000000..3c69bb94fa5 --- /dev/null +++ b/Master/texmf-dist/doc/epspdf/COPYING @@ -0,0 +1,339 @@ + GNU GENERAL PUBLIC LICENSE
+ Version 2, June 1991
+
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc.
+ 59 Temple Place, Suite 330, Boston, MA 02111 USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+ Preamble
+
+ The licenses for most software are designed to take away your
+freedom to share and change it. By contrast, the GNU General Public
+License is intended to guarantee your freedom to share and change free
+software--to make sure the software is free for all its users. This
+General Public License applies to most of the Free Software
+Foundation's software and to any other program whose authors commit to
+using it. (Some other Free Software Foundation software is covered by
+the GNU Library General Public License instead.) You can apply it to
+your programs, too.
+
+ When we speak of free software, we are referring to freedom, not
+price. Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+this service if you wish), that you receive source code or can get it
+if you want it, that you can change the software or use pieces of it
+in new free programs; and that you know you can do these things.
+
+ To protect your rights, we need to make restrictions that forbid
+anyone to deny you these rights or to ask you to surrender the rights.
+These restrictions translate to certain responsibilities for you if you
+distribute copies of the software, or if you modify it.
+
+ For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must give the recipients all the rights that
+you have. You must make sure that they, too, receive or can get the
+source code. And you must show them these terms so they know their
+rights.
+
+ We protect your rights with two steps: (1) copyright the software, and
+(2) offer you this license which gives you legal permission to copy,
+distribute and/or modify the software.
+
+ Also, for each author's protection and ours, we want to make certain
+that everyone understands that there is no warranty for this free
+software. If the software is modified by someone else and passed on, we
+want its recipients to know that what they have is not the original, so
+that any problems introduced by others will not reflect on the original
+authors' reputations.
+
+ Finally, any free program is threatened constantly by software
+patents. We wish to avoid the danger that redistributors of a free
+program will individually obtain patent licenses, in effect making the
+program proprietary. To prevent this, we have made it clear that any
+patent must be licensed for everyone's free use or not licensed at all.
+
+ The precise terms and conditions for copying, distribution and
+modification follow.
+
+ GNU GENERAL PUBLIC LICENSE
+ TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+ 0. This License applies to any program or other work which contains
+a notice placed by the copyright holder saying it may be distributed
+under the terms of this General Public License. The "Program", below,
+refers to any such program or work, and a "work based on the Program"
+means either the Program or any derivative work under copyright law:
+that is to say, a work containing the Program or a portion of it,
+either verbatim or with modifications and/or translated into another
+language. (Hereinafter, translation is included without limitation in
+the term "modification".) Each licensee is addressed as "you".
+
+Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope. The act of
+running the Program is not restricted, and the output from the Program
+is covered only if its contents constitute a work based on the
+Program (independent of having been made by running the Program).
+Whether that is true depends on what the Program does.
+
+ 1. You may copy and distribute verbatim copies of the Program's
+source code as you receive it, in any medium, provided that you
+conspicuously and appropriately publish on each copy an appropriate
+copyright notice and disclaimer of warranty; keep intact all the
+notices that refer to this License and to the absence of any warranty;
+and give any other recipients of the Program a copy of this License
+along with the Program.
+
+You may charge a fee for the physical act of transferring a copy, and
+you may at your option offer warranty protection in exchange for a fee.
+
+ 2. You may modify your copy or copies of the Program or any portion
+of it, thus forming a work based on the Program, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+ a) You must cause the modified files to carry prominent notices
+ stating that you changed the files and the date of any change.
+
+ b) You must cause any work that you distribute or publish, that in
+ whole or in part contains or is derived from the Program or any
+ part thereof, to be licensed as a whole at no charge to all third
+ parties under the terms of this License.
+
+ c) If the modified program normally reads commands interactively
+ when run, you must cause it, when started running for such
+ interactive use in the most ordinary way, to print or display an
+ announcement including an appropriate copyright notice and a
+ notice that there is no warranty (or else, saying that you provide
+ a warranty) and that users may redistribute the program under
+ these conditions, and telling the user how to view a copy of this
+ License. (Exception: if the Program itself is interactive but
+ does not normally print such an announcement, your work based on
+ the Program is not required to print an announcement.)
+
+These requirements apply to the modified work as a whole. If
+identifiable sections of that work are not derived from the Program,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works. But when you
+distribute the same sections as part of a whole which is a work based
+on the Program, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Program.
+
+In addition, mere aggregation of another work not based on the Program
+with the Program (or with a work based on the Program) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+ 3. You may copy and distribute the Program (or a work based on it,
+under Section 2) in object code or executable form under the terms of
+Sections 1 and 2 above provided that you also do one of the following:
+
+ a) Accompany it with the complete corresponding machine-readable
+ source code, which must be distributed under the terms of Sections
+ 1 and 2 above on a medium customarily used for software interchange; or,
+
+ b) Accompany it with a written offer, valid for at least three
+ years, to give any third party, for a charge no more than your
+ cost of physically performing source distribution, a complete
+ machine-readable copy of the corresponding source code, to be
+ distributed under the terms of Sections 1 and 2 above on a medium
+ customarily used for software interchange; or,
+
+ c) Accompany it with the information you received as to the offer
+ to distribute corresponding source code. (This alternative is
+ allowed only for noncommercial distribution and only if you
+ received the program in object code or executable form with such
+ an offer, in accord with Subsection b above.)
+
+The source code for a work means the preferred form of the work for
+making modifications to it. For an executable work, complete source
+code means all the source code for all modules it contains, plus any
+associated interface definition files, plus the scripts used to
+control compilation and installation of the executable. However, as a
+special exception, the source code distributed need not include
+anything that is normally distributed (in either source or binary
+form) with the major components (compiler, kernel, and so on) of the
+operating system on which the executable runs, unless that component
+itself accompanies the executable.
+
+If distribution of executable or object code is made by offering
+access to copy from a designated place, then offering equivalent
+access to copy the source code from the same place counts as
+distribution of the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+ 4. You may not copy, modify, sublicense, or distribute the Program
+except as expressly provided under this License. Any attempt
+otherwise to copy, modify, sublicense or distribute the Program is
+void, and will automatically terminate your rights under this License.
+However, parties who have received copies, or rights, from you under
+this License will not have their licenses terminated so long as such
+parties remain in full compliance.
+
+ 5. You are not required to accept this License, since you have not
+signed it. However, nothing else grants you permission to modify or
+distribute the Program or its derivative works. These actions are
+prohibited by law if you do not accept this License. Therefore, by
+modifying or distributing the Program (or any work based on the
+Program), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Program or works based on it.
+
+ 6. Each time you redistribute the Program (or any work based on the
+Program), the recipient automatically receives a license from the
+original licensor to copy, distribute or modify the Program subject to
+these terms and conditions. You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties to
+this License.
+
+ 7. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License. If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Program at all. For example, if a patent
+license would not permit royalty-free redistribution of the Program by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Program.
+
+If any portion of this section is held invalid or unenforceable under
+any particular circumstance, the balance of the section is intended to
+apply and the section as a whole is intended to apply in other
+circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system, which is
+implemented by public license practices. Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+ 8. If the distribution and/or use of the Program is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Program under this License
+may add an explicit geographical distribution limitation excluding
+those countries, so that distribution is permitted only in or among
+countries not thus excluded. In such case, this License incorporates
+the limitation as if written in the body of this License.
+
+ 9. The Free Software Foundation may publish revised and/or new versions
+of the General Public License from time to time. Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+Each version is given a distinguishing version number. If the Program
+specifies a version number of this License which applies to it and "any
+later version", you have the option of following the terms and conditions
+either of that version or of any later version published by the Free
+Software Foundation. If the Program does not specify a version number of
+this License, you may choose any version ever published by the Free Software
+Foundation.
+
+ 10. If you wish to incorporate parts of the Program into other free
+programs whose distribution conditions are different, write to the author
+to ask for permission. For software which is copyrighted by the Free
+Software Foundation, write to the Free Software Foundation; we sometimes
+make exceptions for this. Our decision will be guided by the two goals
+of preserving the free status of all derivatives of our free software and
+of promoting the sharing and reuse of software generally.
+
+ NO WARRANTY
+
+ 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
+OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
+OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
+TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
+PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
+REPAIR OR CORRECTION.
+
+ 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
+REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
+INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
+OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
+TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
+YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
+PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+ END OF TERMS AND CONDITIONS
+
+ Appendix: How to Apply These Terms to Your New Programs
+
+ If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+ To do so, attach the following notices to the program. It is safest
+to attach them to the start of each source file to most effectively
+convey the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+ <one line to give the program's name and a brief idea of what it does.>
+ Copyright (C) 19yy <name of author>
+
+ This program is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 2 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program; if not, write to the Free Software
+ Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program is interactive, make it output a short notice like this
+when it starts in an interactive mode:
+
+ Gnomovision version 69, Copyright (C) 19yy name of author
+ Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+ This is free software, and you are welcome to redistribute it
+ under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License. Of course, the commands you use may
+be called something other than `show w' and `show c'; they could even be
+mouse-clicks or menu items--whatever suits your program.
+
+You should also get your employer (if you work as a programmer) or your
+school, if any, to sign a "copyright disclaimer" for the program, if
+necessary. Here is a sample; alter the names:
+
+ Yoyodyne, Inc., hereby disclaims all copyright interest in the program
+ `Gnomovision' (which makes passes at compilers) written by James Hacker.
+
+ <signature of Ty Coon>, 1 April 1989
+ Ty Coon, President of Vice
+
+This General Public License does not permit incorporating your program into
+proprietary programs. If your program is a subroutine library, you may
+consider it more useful to permit linking proprietary applications with the
+library. If this is what you want to do, use the GNU Library General
+Public License instead of this License.
diff --git a/Master/texmf-dist/doc/epspdf/default.css b/Master/texmf-dist/doc/epspdf/default.css new file mode 100644 index 00000000000..0b1cdd46c3a --- /dev/null +++ b/Master/texmf-dist/doc/epspdf/default.css @@ -0,0 +1,56 @@ +body { + color: black; + background-color: #ffffff; + margin-left: 15px; + margin-right: 9px; + font-family: serif; +} +h1 { + font-size: xx-large; + font-weight: bold; + margin-top: 12px; + margin-bottom: 6px; +} +h1.display { + text-align: center +} +h2 { + font-size: x-large; + font-weight: bold; + margin-top: 12px; + margin-bottom: 6px; +} +h3 { + font-weight: bold; + margin-top: 9px; + margin-bottom: 3px; +} +p { + margin-top: 6px; + margin-bottom: 3px; +} +p.display { + text-align: center +} +.fineprint { + font-size: x-small; +} +table { + border-width: 0px; + margin-left: 0px; + margin-right: 6px; +} +ul { + margin-top: 9px; + margin-bottom: 9px; +} +ul li { + margin-top: 3px; + margin-bottom: 3px; + margin-left: -6px +} +pre { + margin-top: 3px; + margin-bottom: 3px; + margin-left: 0px; +}
\ No newline at end of file diff --git a/Master/texmf-dist/doc/epspdf/epspdf.install b/Master/texmf-dist/doc/epspdf/epspdf.install new file mode 100644 index 00000000000..759cebde26e --- /dev/null +++ b/Master/texmf-dist/doc/epspdf/epspdf.install @@ -0,0 +1,285 @@ + Epspdf and epspdftk + + A multiplatform GUI- and command-line converter for [e]ps and pdf. + + Siep Kroonenberg, + siepo at cybercomm dot nl + + [1]Current online version of this page + +Table of Contents + + * [2]Features + * [3]Prerequisites + * [4]Installation + * [5]Preview programs + * [6]Files + * [7]Supporting software + * [8]Releases + * [9]To do + * [10]User Guide + +Features + + * Distiller + * Works both for documents and for graphics + * Single-page selection + * Also converts from pdf back to PostScript and eps + * Removal of preview headers from eps files + * Cropping extra whitespace + * Grayscaling (sometimes) + * GUI- and command-line version + * GUI-configurable preferences + * Multiplatform: works unchanged on Windows, Unix/Linux and Mac OS X + + Epspdf has been created with TeX users in mind. For them, eps and pdf are + the preferred graphics formats. + + Ghostscript can convert PostScript to pdf. However, few people are + prepared to deal with the ghostscript command-line. Several command-line + utilities try to help out, e.g. epstopdf, a2ping, and the convert utility + from ImageMagick. But for most users this is still not good enough. + + Epspdftk adds a GUI, with buttons to select options and with dialogs for + opening and saving files. + + A lot more can be done if you can round-trip between PostScript and pdf. + Although Ghostscript can go from pdf to PostScript, pdftops does a much + better job. This opens several new possibilities: grayscaling and + computing a better boundingbox for either eps- or pdf graphics, and page + selection from multipage PostScript- and pdf documents. Epspdf will use + pdftops if it can find it, and silently does whatever back-and-forth + conversions are necessary. + + The command-line program epspdf is written in Ruby. Epspdftk, its GUI + companion, in Ruby/Tk. + +Prerequisites + + Windows with setup progrogam + + Download Ghostscript and GSview from the [11]Ghostscript site. Ghostscript + and GSview each come with a standard Windows setup program. + + You can get pdftops as part of the xpdf suite from the [12]xpdf site. + Download the zipfile with Windows binaries and unpack it in a location of + your choice. The Configure screen of epspdftk lets you browse for this + location. You only have to do this once. Xpdf itself is not in this zip + file. + + The necessary Ruby components are already included in the setup program. + + Windows zipfile with separately installed Ruby + + For Ghostscript, GSview and the xpdf suite, see above. + + You can get a [13]one-click Ruby installer from [14]Rubyforge. For Ruby + version 1.8.4 and later you have to download and install Tcl/Tk + separately, in the form of [15]ActiveTcl. If you are only interested in + the command-line version then you can leave out ActiveTcl. + + Unix/Linux + + You need Ghostscript, preferably xpdf/pdftops, Ruby (version at least 1.8) + and for GUI use also Ruby/Tk. These will almost certainly be available as + packages from your distribution. + + Mac OS X + + Ghostscript and xpdf are available via the [16]Fink Project, in the Text + section. + + If you don't (want to) use Fink, you can download and install Gerben + Wierda's i-Installer from the [17]i-Installer Home Page and then use the + i-Installer to download and install the Ghostscript i-package. + + There is a [18]package for the xpdf suite at + [19]http://users.phg-online.de/tk/MOSXS/. Or you can compile it yourself. + You can download the source from the [20]xpdf site. For compilation, you + need to have XCode installed, but nothing else, I think, at least not + under Tiger. You can safely omit the xpdf- and pdftoppm components if + configure says that they will not be compiled because of missing + libraries. + + Ruby 1.8.2 and Ruby/Tk are part of Mac OS X Tiger. X11 needs to be + installed, although Ruby/Tk is not an X11 application. For earlier + versions of Mac OS X, you are on your own. + +Installation + + Windows with setup program + + Download the [21]epspdftk setup program. You can run it in the usual way, + by double-clicking. The setup program will create entries in your start + menu for epspdftk and for the user manual. + + Windows zipfile + + Download the [22]epspdf zip file, unpack it somewhere and create a + shortcut for epspdftk.rbw. If you plan to use the command-line version, + put a batchfile in a directory on your path with the line + + "<path_to_ruby.exe>" "<path_to_epspdf.rb>" %1 %2 %3 %4 %5 %6 %7 %8 %9 + + Epspdf[tk] has been tested with Windows 2000 and Windows XP. + + Unix/Linux + + Download the [23]tar.gz archive and unpack it in some directory. All files + should be in the same directory; that is how they find each other. If you + plan to use epspdf.rb from the command-line, then you may want to create a + shell script epspdf such as + + #!/bin/sh + <path_to_epspdf>/epspdf.rb $* + + and put it somewhere on your path. + + You can do the same for epspdftk. The first command-line parameter will be + interpreted as startup directory for the file browser. + + Mac OS X + + Install as for Unix/Linux. Here, too, all files should be in the same + directory. + + You can try to start epspdftk.rb from the dock or by doubleclicking. If + that doesn't work out, give the [24]epspdf.app applet a try. After + unpacking, move the file epspdf.app to the same directory as the .rb + files. The zipfile also includes this file in text format + (epspdf.applescript). + + Epspdf mostly duplicates functionality of Preview. But having an alternate + conversion engine means that you can have another shot at problem files. + +Preview programs + + Windows + + Epspdftk will use the default Windows viewers for PostScript and pdf. + Without GSview, you probably won't be able to view PostScript files. + + Unix/Linux + + Supported PostScript viewers include evince, gv, ggv and kghostview. These + are also listed as pdf viewers. Additional pdf viewers are xpdf, gpdf and + acroread/Adobe Reader. If you think that I omitted a PostScript- or pdf + viewer, let me know and I'll probably add it in the next release. + + Mac OS X + + Epspdftk will always use Preview as viewer under OS X. + +Files + + * [25]epspdf.0.2.12.tgz preferred for Unix and Mac OS X + * [26]epspdf.0.2.12.zip preferred for Windows + * [27]epspdf.0.2.12.exe Windows setup program, including Ruby/Tk subset + * [28]epspdf_app.0.2.01.zip Mac OS X applet for starting epspdftk.rb + + Older releases + + * [29]epspdf.0.2.11.tgz for Unix and Mac OS X + * [30]epspdf.0.2.11.zip for Windows + * [31]epspdf.0.2.11.exe Windows setup program + * [32]epspdf.0.2.01.tgz for Unix and Mac OS X + * [33]epspdf.0.2.01.zip for Windows + * [34]epspdf.0.2.exe, Windows setup program + +Supporting software + + * [35]Ghostscript and GSview + * [36]XPDF + * [37]OS X binary for xpdf/pdftops + * [38]Ruby one-click installer + * [39]Ruby Home Page + * [40]ActiveTcl + +Releases + + 0.2.12 + Current version. Bug fixes: log rotation now works. Under Windows, + sometimes boundingboxes couldn't be calculated. This was caused by + double quotes within backquotes. This is now avoided by using + short filenames within backquotes. Minor changes in user guide. + + 0.2.11 + Minor fixes. Changes in documentation. + + 0.2.10 + A computed boundingbox is now expanded by one point in all + directions. This should prevent too-tight cropping. There is no + interface for changing this amount; it can only be changed by + hand-editing the bb_spread option in the .epspdfrc file or in the + HKCU\software\epspdf registry key. + The File Open dialog remembers the last directory visited (between + calls, not between program sessions). + Changes in documentation. + + 0.2.01 + Fixes to the Applescript applet epspdf.app for starting up + epspdftk under Mac OS X. It picks up the terminal search path and + no longer requires correct settings in + $HOME/.MacOSX/environment.plist. + Epspdf.app is now [41]packaged separately, under Mac OS X, and now + has an intact resource fork. It has been removed from the other + archives. + + 0.2 + Original release + +To do + + * Artwork + * GUI for some pdftops options + * Proper help + * Support for bitmapped formats (maybe) + + -------------------------------------------------------------------------- + + Last revised: November 20, 2006 + +References + + Visible links + 1. http://tex.aanhet.net/epspdf/ + 2. http://tex.aanhet.net/epspdf/index.html#features + 3. http://tex.aanhet.net/epspdf/index.html#prerequisites + 4. http://tex.aanhet.net/epspdf/index.html#install + 5. http://tex.aanhet.net/epspdf/index.html#preview + 6. http://tex.aanhet.net/epspdf/index.html#files + 7. http://tex.aanhet.net/epspdf/index.html#supporting + 8. http://tex.aanhet.net/epspdf/index.html#releases + 9. http://tex.aanhet.net/epspdf/index.html#todo + 10. http://tex.aanhet.net/epspdf/epspdf_UG.html + 11. http://www.cs.wisc.edu/~ghost/ + 12. http://www.foolabs.com/xpdf/ + 13. http://rubyforge.org/projects/rubyinstaller/ + 14. http://rubyforge.org/ + 15. http://activestate.com/Products/ActiveTcl/ + 16. http://fink.sourceforge.net/ + 17. http://ii2.sourceforge.net/ + 18. http://users.phg-online.de/tk/MOSXS/xpdf-tools-3.dmg + 19. http://users.phg-online.de/tk/MOSXS/ + 20. http://www.foolabs.com/xpdf/ + 21. http://tex.aanhet.net/epspdf/epspdf.0.2.12.exe + 22. http://tex.aanhet.net/epspdf/epspdf.0.2.12.zip + 23. http://tex.aanhet.net/epspdf/epspdf.0.2.12.tgz + 24. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip + 25. http://tex.aanhet.net/epspdf/epspdf.0.2.12.tgz + 26. http://tex.aanhet.net/epspdf/epspdf.0.2.12.zip + 27. http://tex.aanhet.net/epspdf/epspdf.0.2.12.exe + 28. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip + 29. http://tex.aanhet.net/epspdf/epspdf.0.2.11.tgz + 30. http://tex.aanhet.net/epspdf/epspdf.0.2.11.zip + 31. http://tex.aanhet.net/epspdf/epspdf.0.2.11.exe + 32. http://tex.aanhet.net/epspdf/epspdf.0.2.01.tgz + 33. http://tex.aanhet.net/epspdf/epspdf.0.2.01.zip + 34. http://tex.aanhet.net/epspdf/epspdf.0.2.exe + 35. http://www.cs.wisc.edu/~ghost/ + 36. http://www.foolabs.com/xpdf/ + 37. http://users.phg-online.de/tk/MOSXS/ + 38. http://rubyforge.org/projects/rubyinstaller/ + 39. http://ruby-lang.org/ + 40. http://activestate.com/Products/ActiveTcl/ + 41. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip diff --git a/Master/texmf-dist/doc/epspdf/epspdf_UG.html b/Master/texmf-dist/doc/epspdf/epspdf_UG.html new file mode 100644 index 00000000000..27a7d96626a --- /dev/null +++ b/Master/texmf-dist/doc/epspdf/epspdf_UG.html @@ -0,0 +1,185 @@ +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC +"-//W3C//DTD XHTML 1.0 Transitional//EN" + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> + +<html xmlns="http://www.w3.org/1999/xhtml"> + +<head> + +<link rel="stylesheet" href="default.css" type="text/css"/> + +<title>Epspdf and epspdftk User Guide</title> + +</head><body> + +<h1 class="display">Epspdf and epspdftk User Guide</h1> + +<p class="display">A multiplatform GUI- and command-line converter +for [e]ps and pdf.</p> + +<p class="display"><i>Siep Kroonenberg,<br/><tt>siepo at cybercomm +dot nl</tt></i></p> + +<h2>Overview</h2> + +<p>Epspdftk converts files between eps, pdf and general +PostScript. The main screen lets you open a file, select some options +and convert the file.</p> + +<p>When opening a file, epspdf tries to find out file type and, in +the case of a pdf file, the number of pages. This information is +displayed in the box in the upper half of the screen.</p> + +<p class="display"><img src="images/main_w32.png" alt=""/></p> + +<h2>Viewing</h2> + +<p>The View button at the bottom of the screen calls an appropriate +external viewer. For Windows this is determined by the default Open +command, for OS X it is always Preview, and under Linux it is +configurable; see below under <a href="#configure">The Configuration +screen.</a></p> + +<p>The View button is grayed if epspdf thinks that there is no +previewer for the current file.</p> + +<p class="display"><img src="images/greenbroccoli.png" alt=""/></p> + +<h2>Conversion options</h2> + +<p><a name="gray"><i>Grayscaling:</i></a> Simple color figures can +be converted to grayscale. Grayscaling will fail for bitmapped data +and for advanced color models. 'Try harder to grayscale' will handle +a few more cases, but may take longer and still won't handle +bitmaps.</p> + +<p><i>Call for assistance:</i> If a PostScript color expert is +reading this: please have a look at makegray.pro and see whether you +can come up with something that handles more color models.</p> + +<p><i>Compute tight boundingbox:</i> This option is only available +if a single page is converted.</p> + +<p><i>Page selection:</i> The only possibilities are selecting a +single page or selecting all pages. When converting to eps you are +restricted to a single page.</p> + +<p>For general PostScript files, there is no quick way to determine +the number of pages, so the program won't check beforehand whether +you picked an existing page. If you picked a non-existent page, the +program will abort. If you don't like that, convert the entire +document to pdf first - which will be done behind the scenes +anyhow.</p> + +<p>Specifying options such as grayscaling or page selection may +require several roundtrips between PostScript or eps and pdf. If +epspdf cannot use pdftops then some combinations of options will not +be available.</p> + +<h2>Converting</h2> + +<p>The Convert and save... button calls up a file save dialog, with +appropriate default extension. After a successful conversion, the +result becomes the new current file, so you can judge the result by +pressing the View button again.</p> + +<p class="display"><img src="images/dia_save.png" alt=""/></p> + +<h2><a name="configure">The configuration screen</a></h2> + +<p>Epspdftk also has a configuration screen. The settings here are +preserved between sessions. Pay particular attention to 'Intended +use' under PDF CONVERSION. Choose 'prepress' for pdfs which are +intended for commercial printing. This option will try to embed all +fonts, among other things. More and more often, printshops insist on +this. With luck, Ghostscript fonts and system fonts will be used for +fonts which were not originally embedded.</p> + +<p>Under Windows, this screen also lets you tell the program where +to find pdftops.exe. Under Linux, it lets you pick PostScript- and +pdf previewers.</p> + +<p class="display"><img src="images/config_mac.png" alt=""/></p> + +<h2>Adding standard fonts to an existing pdf</h2> + +<p>You can add standard fonts such as Times and Helvetica to an +existing pdf: first, convert to ps, with 'Convert all pages' +selected. Then, make sure that in the configuration screen 'Intended +use' is set to prepress, then convert back to pdf.</p> + +<p>If this option is set to screen, then standard fonts will be +removed instead of added. This option may also affect the resolution +of bitmaps.</p> + +<h2>Eps preview headers</h2> + +<p>Preview headers are quietly stripped from eps files. These +preview headers are used by e.g. desktop-publishing software to +represent eps files on screen without having to interpret the +PostScript code itself. Epspdf currently has no option to preserve +or add them.</p> + +<h2>Exporting PostScript from Windows programs</h2> + +<p>Often, the only way to get EPS or PostScript from a Windows +program is by 'printing' to a PostScript file. From some programs, +you can print a selection. A suitable driver which comes with +Windows is Generic / MS Publisher Imagesetter. Pay attention to the +printer properties: avoid the 'Optimize for speed' setting and choose +Outline for font downloading. These options can be found under the +Advanced button.</p> + +<p>Other possibilities are the TpX and wmf2eps programs, which both +have options to write clipboard contents to an emf file. Wmf2eps +uses a printer driver in the background. For faithful conversion, +pick wmf2eps; for subsequent editing, choose TpX. Both programs are +availbable from <a href="http://www.tug.org/ctan.html">CTAN</a>.</p> + +<h2>Command-line use</h2> + +<p>Epspdf.rb, the library for epspdftk.rb, does double duty as +command-line version of epspdftk.rb. Type <tt>epspdf.rb -h</tt> for +help. It shares configuration settings with epspdftk.</p> + +<h2>Troubleshooting</h2> + +<h3>Grayscaling fails</h3> + +<p>See above, under <a href="#gray">Grayscaling.</a> Epspdf is +limited by what can be done by the backend tools, i.e. Ghostscript +and pdftops.</p> + +<h3>Part of the graphic gets cut off</h3> + +<p>I have seen this happen with eps files generated by printing +landscape PowerPoint slides to PostScript with the Encapsulated +PostScript output option. Using the Archive output option instead +solved the problem. In general, experiment a bit in generating +your PostScript.</p> + +<h3>Resources for troubleshooting</h3> + +<p><i>Logfile.</i> Epspdf and epspdftk maintain a log file +epspdf.log in your home directory or, in case of Windows, your +profile directory. This profile directory may be c:\Documents and +Settings\<your user name>. Otherwise, open a DOS box and type +'<tt>echo %USERPROFILE%</tt>', which will produce this +information.</p> + +<p>This logfile lists all Ghostscript- and pdftops program +calls plus error information. 'EPCallError' is probably a program +error. 'EPSystemError' is more likely caused by a faulty file, but +may be a program error as well.</p> + +<p><i>Temporary files.</i> The temporary files may give clues as +well. They will be deleted at the end of the session (for the +command-line version, give a -d parameter to keep the temporary +files). Check the logfile which temporary files have been +created.</p> + +<h3><a href="index.html">Main page...</a></h3> + +<hr/> +<p class="fineprint">Last revised: Noverber 20, 2006</p> +</body></html> diff --git a/Master/texmf-dist/doc/epspdf/images/config_mac.png b/Master/texmf-dist/doc/epspdf/images/config_mac.png Binary files differnew file mode 100644 index 00000000000..0ad0c855509 --- /dev/null +++ b/Master/texmf-dist/doc/epspdf/images/config_mac.png diff --git a/Master/texmf-dist/doc/epspdf/images/dia_save.png b/Master/texmf-dist/doc/epspdf/images/dia_save.png Binary files differnew file mode 100644 index 00000000000..ea56dbcab0e --- /dev/null +++ b/Master/texmf-dist/doc/epspdf/images/dia_save.png diff --git a/Master/texmf-dist/doc/epspdf/images/greenbroccoli.png b/Master/texmf-dist/doc/epspdf/images/greenbroccoli.png Binary files differnew file mode 100644 index 00000000000..64883e00d47 --- /dev/null +++ b/Master/texmf-dist/doc/epspdf/images/greenbroccoli.png diff --git a/Master/texmf-dist/doc/epspdf/images/main_w32.png b/Master/texmf-dist/doc/epspdf/images/main_w32.png Binary files differnew file mode 100644 index 00000000000..579e64f0db9 --- /dev/null +++ b/Master/texmf-dist/doc/epspdf/images/main_w32.png diff --git a/Master/texmf-dist/doc/epspdf/index.html b/Master/texmf-dist/doc/epspdf/index.html new file mode 100644 index 00000000000..476deff50c9 --- /dev/null +++ b/Master/texmf-dist/doc/epspdf/index.html @@ -0,0 +1,312 @@ +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC +"-//W3C//DTD XHTML 1.0 Transitional//EN" + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> + +<html xmlns="http://www.w3.org/1999/xhtml"> + +<head> + +<link rel="stylesheet" href="default.css" type="text/css"/> + +<title>Epspdf and epspdftk</title> + +</head><body> + +<h1 class="display">Epspdf and epspdftk</h1> + +<p class="display">A multiplatform GUI- and command-line converter +for [e]ps and pdf.</p> + +<p class="display"><i>Siep Kroonenberg,<br/><tt>siepo at cybercomm +dot nl</tt></i></p> + +<p><a href="http://tex.aanhet.net/epspdf/">Current online version of +this page</a></p> + +<h2>Table of Contents</h2> + +<ul> +<li><a href="#features">Features</a></li> +<li><a href="#prerequisites">Prerequisites</a></li> +<li><a href="#install">Installation</a></li> +<li><a href="#preview">Preview programs</a></li> +<li><a href="#files">Files</a></li> +<li><a href="#supporting">Supporting software</a></li> +<li><a href="#releases">Releases</a></li> +<li><a href="#todo">To do</a></li> +<li><a href="epspdf_UG.html">User Guide</a></li> +</ul> + +<h2><a name="features"/>Features</h2> + +<ul> +<li>Distiller</li> +<li>Works both for documents and for graphics</li> +<li>Single-page selection</li> +<li>Also converts from pdf back to PostScript and eps</li> +<li>Removal of preview headers from eps files</li> +<li>Cropping extra whitespace</li> +<li>Grayscaling (sometimes)</li> +<li>GUI- and command-line version</li> +<li>GUI-configurable preferences</li> +<li>Multiplatform: works unchanged on Windows, Unix/Linux and Mac OS X</li> +</ul> + +<p>Epspdf has been created with TeX users in mind. For them, eps and +pdf are the preferred graphics formats.</p> + +<p>Ghostscript can convert PostScript to pdf. However, few people +are prepared to deal with the ghostscript command-line. Several +command-line utilities try to help out, e.g. epstopdf, a2ping, and +the convert utility from ImageMagick. But for most users this is +still not good enough.</p> + +<p>Epspdftk adds a GUI, with buttons to select options and with +dialogs for opening and saving files.</p> + +<p>A lot more can be done if you can round-trip between PostScript +and pdf. Although Ghostscript can go from pdf to PostScript, pdftops +does a much better job. This opens several new possibilities: +grayscaling and computing a better boundingbox for either eps- or pdf +graphics, and page selection from multipage PostScript- and pdf +documents. Epspdf will use pdftops if it can find it, and silently +does whatever back-and-forth conversions are necessary.</p> + +<p>The command-line program epspdf is written in Ruby. Epspdftk, +its GUI companion, in Ruby/Tk.</p> + +<h2><a name="prerequisites"/>Prerequisites</h2> + +<h3>Windows with setup progrogam</h3> + +<p>Download Ghostscript and GSview from the <a +href="http://www.cs.wisc.edu/~ghost/">Ghostscript site.</a> +Ghostscript and GSview each come with a standard Windows setup +program.</p> + +<p>You can get pdftops as part of the xpdf suite from the <a +href="http://www.foolabs.com/xpdf/">xpdf site.</a> Download the +zipfile with Windows binaries and unpack it in a location of your +choice. The Configure screen of epspdftk lets you browse for this +location. You only have to do this once. Xpdf itself is not in this +zip file.</p> + +<p>The necessary Ruby components are already included in the setup +program.</p> + +<h3>Windows zipfile with separately installed Ruby</h3> + +<p>For Ghostscript, GSview and the xpdf suite, see above.</p> + +<p>You can get a <a +href="http://rubyforge.org/projects/rubyinstaller/">one-click Ruby +installer</a> from <a href="http://rubyforge.org/">Rubyforge.</a> +For Ruby version 1.8.4 and later you have to download and install +Tcl/Tk separately, in the form of <a +href="http://activestate.com/Products/ActiveTcl/">ActiveTcl.</a> If +you are only interested in the command-line version then you can +leave out ActiveTcl.</p> + +<h3>Unix/Linux</h3> + +<p>You need Ghostscript, preferably xpdf/pdftops, Ruby (version at +least 1.8) and for GUI use also Ruby/Tk. These will almost certainly +be available as packages from your distribution.</p> + +<h3>Mac OS X</h3> + +<p>Ghostscript and xpdf are available via the <a +href="http://fink.sourceforge.net/">Fink Project</a>, in the Text +section.</p> + +<p>If you don't (want to) use Fink, you can download and +install Gerben Wierda's i-Installer from the <a +href="http://ii2.sourceforge.net/">i-Installer Home Page</a> and +then use the i-Installer to download and install the Ghostscript +i-package.</p> + +<p>There is +a <a +href="http://users.phg-online.de/tk/MOSXS/xpdf-tools-3.dmg">package</a> +for the xpdf suite +at <a +href="http://users.phg-online.de/tk/MOSXS/">http://users.phg-online.de/tk/MOSXS/.</a> +Or you can compile it yourself. You can download the source from +the <a href="http://www.foolabs.com/xpdf/">xpdf site</a>. For +compilation, you need to have XCode installed, but nothing else, I +think, at least not under Tiger. You can safely omit the xpdf- and +pdftoppm components if configure says that they will not be compiled +because of missing libraries.</p> + +<p>Ruby 1.8.2 and Ruby/Tk are part of Mac OS X Tiger. X11 needs to +be installed, although Ruby/Tk is <i>not</i> an X11 application. For +earlier versions of Mac OS X, you are on your own.</p> + +<h2><a name="install"/>Installation</h2> + +<h3>Windows with setup program</h3> + +<p>Download the <a href="epspdf.0.2.12.exe">epspdftk setup +program.</a> You can run it in the usual way, by double-clicking. The +setup program will create entries in your start menu for epspdftk +and for the user manual.</p> + +<h3>Windows zipfile</h3> + +<p>Download the <a href="epspdf.0.2.12.zip">epspdf zip file</a>, +unpack it somewhere and create a shortcut for epspdftk.rbw. If you +plan to use the command-line version, put a batchfile in a directory +on your path with the line</p> + +<pre> +"<path_to_ruby.exe>" "<path_to_epspdf.rb>" %1 %2 %3 %4 %5 %6 %7 %8 %9 +</pre> + +<p>Epspdf[tk] has been tested with Windows 2000 and Windows XP.</p> + +<h3>Unix/Linux</h3> + +<p>Download the <a href="epspdf.0.2.12.tgz">tar.gz archive</a> and +unpack it in some directory. All files should be in the same +directory; that is how they find each other. If you plan to use +epspdf.rb from the command-line, then you may want to create a shell +script <tt>epspdf</tt> such as</p> + +<pre> +#!/bin/sh +<path_to_epspdf>/epspdf.rb $* +</pre> + +<p>and put it somewhere on your path.</p> + +<p>You can do the same for epspdftk. The first command-line +parameter will be interpreted as startup directory for the file +browser.</p> + +<h3>Mac OS X</h3> + +<p>Install as for Unix/Linux. Here, too, all files should be in the +same directory.</p> + +<p>You can try to start epspdftk.rb from the dock or by +doubleclicking. If that doesn't work out, give the <a +href="epspdf_app.0.2.01.zip">epspdf.app</a> applet a try. After +unpacking, move the file <tt>epspdf.app</tt> to the same directory +as the .rb files. The zipfile also includes this file in text format +(<tt>epspdf.applescript</tt>).</p> + +<p>Epspdf mostly duplicates functionality of Preview. But having an +alternate conversion engine means that you can have another shot at +problem files.</p> + +<h2><a name="preview"/>Preview programs</h2> + +<h3>Windows</h3> + +<p>Epspdftk will use the default Windows viewers for PostScript and +pdf. Without GSview, you probably won't be able to view PostScript +files.</p> + +<h3>Unix/Linux</h3> + +<p>Supported PostScript viewers include evince, gv, ggv and +kghostview. These are also listed as pdf viewers. Additional pdf +viewers are xpdf, gpdf and acroread/Adobe Reader. If you think that +I omitted a PostScript- or pdf viewer, let me know and I'll probably +add it in the next release.</p> + +<h3>Mac OS X</h3> + +<p>Epspdftk will always use Preview as viewer under OS X.</p> + +<h2><a name="files"/>Files</h2> + +<ul> +<li><a href="epspdf.0.2.12.tgz">epspdf.0.2.12.tgz</a> preferred for Unix +and Mac OS X</li> + +<li><a href="epspdf.0.2.12.zip">epspdf.0.2.12.zip</a> preferred for +Windows</li> + +<li><a href="epspdf.0.2.12.exe">epspdf.0.2.12.exe</a> Windows setup + program, including Ruby/Tk subset</li> + +<li><a href="epspdf_app.0.2.01.zip">epspdf_app.0.2.01.zip</a> Mac OS X +applet for starting epspdftk.rb</li> +</ul> + +<h3>Older releases</h3> +<ul> +<li><a href="epspdf.0.2.11.tgz">epspdf.0.2.11.tgz</a> for Unix +and Mac OS X</li> +<li><a href="epspdf.0.2.11.zip">epspdf.0.2.11.zip</a> for +Windows</li> +<li><a href="epspdf.0.2.11.exe">epspdf.0.2.11.exe</a> Windows setup + program</li> +<li><a href="epspdf.0.2.01.tgz">epspdf.0.2.01.tgz</a> for Unix + and Mac OS X</li> +<li><a href="epspdf.0.2.01.zip">epspdf.0.2.01.zip</a> for + Windows</li> +<li><a href="epspdf.0.2.exe">epspdf.0.2.exe</a>, Windows setup + program</li> +</ul> + +<h2><a name="supporting"/>Supporting software</h2> + +<ul> +<li><a href="http://www.cs.wisc.edu/~ghost/">Ghostscript and + GSview</a></li> +<li><a href="http://www.foolabs.com/xpdf/">XPDF</a></li> +<li><a href="http://users.phg-online.de/tk/MOSXS/">OS X + binary for xpdf/pdftops</a></li> +<li><a href="http://rubyforge.org/projects/rubyinstaller/">Ruby one-click + installer</a></li> +<li><a href="http://ruby-lang.org/">Ruby Home Page</a></li> +<li><a +href="http://activestate.com/Products/ActiveTcl/">ActiveTcl</a></li> +</ul> + +<h2><a name="releases"/>Releases</h2> + +<dl> +<dt>0.2.12</dt><dd>Current version. Bug fixes: log rotation now +works. Under Windows, sometimes boundingboxes couldn't be +calculated. This was caused by double quotes within backquotes. This +is now avoided by using short filenames within backquotes. Minor +changes in user guide.</dd> + +<dt>0.2.11</dt><dd> Minor fixes. Changes in documentation.</dd> + +<dt>0.2.10</dt><dd>A computed boundingbox is now expanded by one +point in all directions. This should prevent too-tight +cropping. There is no interface for changing this amount; it can +only be changed by hand-editing the bb_spread +option in the .epspdfrc file or in the HKCU\software\epspdf registry +key.</dd> <dd>The File Open dialog remembers the last directory +visited (between calls, not between program +sessions).</dd><dd>Changes in documentation.</dd> + +<dt>0.2.01</dt><dd>Fixes to the Applescript applet epspdf.app for +starting up epspdftk under Mac OS X. It picks up the terminal search +path and no longer requires correct settings in +$HOME/.MacOSX/environment.plist.</dd><dd>Epspdf.app is now <a +href="epspdf_app.0.2.01.zip">packaged separately</a>, under Mac OS +X, and now has an intact resource fork. It has been removed from the +other archives.</dd> + +<dt>0.2</dt><dd>Original release</dd> +</dl> + +<h2><a name="todo"/>To do</h2> + +<ul> +<li>Artwork</li> +<li>GUI for some pdftops options</li> +<li>Proper help</li> +<li>Support for bitmapped formats (maybe)</li> +</ul> + +<hr/> + +<p class="fineprint">Last revised: November 20, 2006</p> +</body></html> |