diff options
author | Karl Berry <karl@freefriends.org> | 2009-03-08 01:37:33 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2009-03-08 01:37:33 +0000 |
commit | 527a74fac35059aa094d70a74a74949e35655060 (patch) | |
tree | f72b507060bd21b802a6b47aa453ce236031a239 /Master/texmf-dist/doc/support | |
parent | ff0e5deb9aa09b585004a4e4c66a0543979e8425 (diff) |
epspdf update
git-svn-id: svn://tug.org/texlive/trunk@12334 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/support')
-rw-r--r-- | Master/texmf-dist/doc/support/epspdf/COPYING | 339 | ||||
-rw-r--r-- | Master/texmf-dist/doc/support/epspdf/Changelog | 38 | ||||
-rw-r--r-- | Master/texmf-dist/doc/support/epspdf/README | 19 | ||||
-rw-r--r-- | Master/texmf-dist/doc/support/epspdf/README.tl | 2 | ||||
-rw-r--r-- | Master/texmf-dist/doc/support/epspdf/default.css | 93 | ||||
-rw-r--r-- | Master/texmf-dist/doc/support/epspdf/epspdf.install | 359 | ||||
-rw-r--r-- | Master/texmf-dist/doc/support/epspdf/epspdf.pdf | bin | 0 -> 224690 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/support/epspdf/epspdf.texi | 511 | ||||
-rw-r--r-- | Master/texmf-dist/doc/support/epspdf/images/cnv_osx.png | bin | 0 -> 32216 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/support/epspdf/images/config_lnx.png | bin | 0 -> 14765 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/support/epspdf/images/main_w32.png | bin | 0 -> 7274 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/support/epspdf/images/ps_settings.png | bin | 0 -> 10205 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/support/epspdf/index.html | 406 | ||||
-rw-r--r-- | Master/texmf-dist/doc/support/epspdf/pstexi.tex | 49 |
14 files changed, 1816 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/support/epspdf/COPYING b/Master/texmf-dist/doc/support/epspdf/COPYING new file mode 100644 index 00000000000..1bf15263878 --- /dev/null +++ b/Master/texmf-dist/doc/support/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/support/epspdf/Changelog b/Master/texmf-dist/doc/support/epspdf/Changelog new file mode 100644 index 00000000000..2ff47b20fbc --- /dev/null +++ b/Master/texmf-dist/doc/support/epspdf/Changelog @@ -0,0 +1,38 @@ +2009-03-02 0.4 + + Handles hires boundingbox. Can use MikTeX Ghostscript. Updated, + streamlined Ruby subset. Simpler testing of prerequisites. In + particular, no pdftops version testing. More tolerant boundingbox + parsing. Windows: View with... button. OS X: use open command for + viewing. Converting... text in main window. + +2008-07-28 0.3 + + TeX Live integration. Packaging for CTAN. Bug fixes: more tolerant + pdftops version testing; no inappropriate warning about missing + viewers under Mac OS X. + +2006-11-20 0.2.12 + + Bug fixes: log rotation now works. Solved quoting problems under + w2k by using short names. Minor updates to documentation. + +2006-11-03 0.2.11 + + Minor fixes. Changes in documentation. + +2006-10-29 0.2.10 + + Computed boundingbox padded by 1pt, to prevent some + cropping. Amount bb_spread is manually configurable. The File Open + dialog remembers the last directory visited (between function + calls, not between program sessions). Changes in documentation. + +2006-08-14 0.2.01 + + epspdf.app now packaged separately. Bug fix to Applescript applet + epspdf.app for starting up epspdftk under Mac OS X. + +2006-07-30 0.2 + + Original release diff --git a/Master/texmf-dist/doc/support/epspdf/README b/Master/texmf-dist/doc/support/epspdf/README new file mode 100644 index 00000000000..bed4e7ec655 --- /dev/null +++ b/Master/texmf-dist/doc/support/epspdf/README @@ -0,0 +1,19 @@ +Epspdf is an ps/eps/pdf converter which can be used both from the +command-line and as a GUI application. + +Full documentation is available in the doc subdirectory. + +Windows users: you may prefer the Windows setup program available +from http://tex.aanhet.net/epspdf/ or on CTAN as part of +epspdf-extra. This setup program includes a minimal subset of Ruby/Tk, +whereas this version requires separate installation of Ruby, and for +the GUI also Tcl/Tk. + +Mac users: you may want to have a look at epspdf_app, a very simple +AppleScript applet for starting epspdftk.rb by double-clicking. Also +available from http://tex.aanhet.net/epspdf/ or on CTAN as part of +epspdf-extra. + +The files in the texlive subdirectory are NOT useful for a +standalone installation. They are wrapper scripts for +embedding epspdf and epspdftk into TeX Live. diff --git a/Master/texmf-dist/doc/support/epspdf/README.tl b/Master/texmf-dist/doc/support/epspdf/README.tl new file mode 100644 index 00000000000..233bf67951c --- /dev/null +++ b/Master/texmf-dist/doc/support/epspdf/README.tl @@ -0,0 +1,2 @@ +The scripts in this directory are for use by TeX Live and are +useless for a standalone install. diff --git a/Master/texmf-dist/doc/support/epspdf/default.css b/Master/texmf-dist/doc/support/epspdf/default.css new file mode 100644 index 00000000000..d4311458e08 --- /dev/null +++ b/Master/texmf-dist/doc/support/epspdf/default.css @@ -0,0 +1,93 @@ +body { + color: black; + background-color: #ffe; + margin-left: 15px; + margin-right: 5px; + font-family: serif; +} + +h1, h2, h3 { + font-weight: bold; + color: #008; +} +h1 { + font-size: xx-large; + margin-top: 12px; + margin-bottom: 6px; +} +h1.display { + text-align: center; +} +h2 { + font-size: x-large; + margin-top: 12px; + margin-bottom: 6px; +} +h3 { + margin-top: 9px; + margin-bottom: 3px; +} +p { + margin-top: 6px; + margin-bottom: 3px; + max-width: 60em; +} +p.display { + text-align: center; + max-width: none; +} +.fineprint { + font-size: x-small; +} + +blockquote { + max-width: 40em; +} + +table { + border-width: 0px; + margin-left: 0px; + margin-right: 6px; +} +table#prereq { + border: 2px solid #448; + margin-top: 9px; + margin-bottom: 9px; +} +table#prereq th { + text-align: left; + } +td, th { + padding-left: 12px; + padding-right: 12px; + max-width: 55em; +} +tfoot { + font-style: italic; + font-size: small; +} +th, tfoot td { + background-color: #ffc; +} + +ul, dl { + margin-top: 9px; + margin-bottom: 9px; + max-width: 60em; +} +ul li { + margin-top: 3px; + margin-bottom: 3px; + margin-left: -6px +} +pre { + margin-top: 3px; + margin-bottom: 3px; + margin-left: 0px; +} + +img { + margin: 20px; + float: right; + clear: right; +}
\ No newline at end of file diff --git a/Master/texmf-dist/doc/support/epspdf/epspdf.install b/Master/texmf-dist/doc/support/epspdf/epspdf.install new file mode 100644 index 00000000000..8aa4fa90f07 --- /dev/null +++ b/Master/texmf-dist/doc/support/epspdf/epspdf.install @@ -0,0 +1,359 @@ + 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]Releases + * [8]User Manual + +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 + * Support for TeX Live and MiKTeX + + Epspdf has been created with TeX in mind. For TeX and its derivatives, 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 converting text back to PostScript. 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. + + Starting with the 2008 edition, epspdf is included in TeX Live as an + optional package, complete with wrapper scripts epspdf and epspdftk which + can be called from the command-line without further ado. + +Prerequisites + + These are the required and optional prerequisites, which will be checked + for when epspdf starts: + + * Ghostscript + * pdftops from the xpdf suite, strongly recommended for better pdf to + PostScript conversions + * Ruby 1.8.x + * Tcl/Tk is only required for the GUI interface. Only version 8.4 has + been tested. + * Optional: viewers for PostScript and pdf + + You may not have to install all of these yourself. + + Linux + + On a current Linux distribution you can almost certainly install + everything from your distribution's package repositories. You may have to + install Ruby's Tk bindings, in addition to Ruby and Tcl/Tk themselves. The + name of such a package might be e.g. libtcltk-ruby. As to PostScript- and + pdf viewers: epspdf tests for several popular viewers, but the + configuration screen also lets you specify viewers manually. + + Mac OS X (Tiger and later) + + Ruby and Tcl/Tk are already part of the operating system. Ghostscript is + included in MacTeX, but is also available via e.g. MacPorts. You can get + pdftops from MacPorts as part of either Poppler or xpdf. Another source is + [9]http://users.phg-online.de/tk/MOSXS/. + + If you want to compile xpdf it yourself, which is not hard, you can ignore + warnings about X, Motif or FreeType not being found since these missing + libraries won't affect the compilation of pdftops. + + Windows (Windows 2000 and later) + + By itself, Windows lacks any of the prerequisites of epspdf. However, a + TeX installation may fill some of the gaps, and there is a special Windows + installer which includes a partial Ruby installation. See the table below: + + TeX distribution Installer Zipfile + (1) MikTeX and TeX Live 2008 include a hidden Ghostscript which is always + installed, and which epspdf knows how to find. Caveat: although older + versions of TeX Live include a Ghostscript installer, it is not impossible + to install an older TeX Live without Ghostscript, in which case you have + to provide a Ghostscript yourself. + (2) With TeX Live >= 2008, you are better off installing the TeX Live + package, which also gives you wrapper batchfiles epspdf.bat and + epspdftk.bat. You still need to install Ruby and Tcl/Tk. + TeX Live[10](1) No additional Ruby, Tcl/Tk[11](2) + requirements + MiKTeX Pdftops (optional) Pdftops (optional); Ruby, + Tcl/Tk(optional) + Ghostscript, pdftops Ghostscript; + Other/None (optional) pdftops(optional), Ruby, + Tcl/Tk (optional) + + URLs for the prerequisites + + Ghostscript and GSview ([12]http://pages.cs.wisc.edu/~ghost/) + Contains sources and Windows binaries. The Windows binaries come + with standard GUI Windows setup programs. + + XPDF ([13]http://www.foolabs.com/xpdf/) + Sources and Windows binaries. The Windows binaries are packaged + into a zipfile, which has to be manually unpacked. The Configure + screen of epspdftk lets you browse for the chosen location. You + have to do this only once. + + XPDF, Mac OS X binaries ([14]http://users.phg-online.de/tk/MOSXS/) + These are universal binaries. + + TeX Live ([15]http://www.tug.org/texlive/) + TeX Live 2008 includes epspdf as an optional install. For Windows, + this version doesn't require external copies of pdftops or + Ghostscript but does not include Ruby or Tcl/Tk. + + MacTeX ([16]http://www.tug.org/mactex/) + MacTeX is based on TeX Live. Its set of add-ons includes + Ghostscript, and can be downloaded separately. + + The MacPorts Project ([17]http://www.macports.org/) + MacTeX has Poppler- and xpdf packages either of which include + pdftops. + + Ruby one-click installer for Windows ( + [18]http://rubyforge.org/projects/rubyinstaller/) + Current versions (1.8.4 and later) require Tcl/Tk to be separately + installed. + + Old releases of Ruby one-click installer ( + [19]http://rubyforge.org/frs/?group_id=167) + Versions prior to 1.8.4 include Tcl/Tk. + + Ruby source code ([20]http://www.ruby-lang.org/en/downloads/) + For those people who prefer to roll their own... + + ActiveTcl from ActiveState ( + [21]http://activestate.com/Products/ActiveTcl/ + Get version 8.4, not 8.5. + +Installation + + First make sure that the prerequisites are met. Then: + + TeX Live 2008 + + Use TeX Live's package manager tlmgr for installation. + + Windows setup program + + Download the [22]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 [23]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>" %* + + With such a batchfile, the caller has to take care of quoting: + + epspdf "my file.eps" "my file.pdf" + + Epspdf[tk] has been tested with Windows 2000, Windows XP and Windows + Vista. + + Unix/Linux + + Download the [24]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 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 [25]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 programs for PostScript and pdf. If + you have TeX Live 2008 or later then you can assign <TeX Live + root>\bin\win32\psv.bat as previewer for .ps- and .eps files. For Windows + only, there is an additional View with... button to select a viewer + yourself. + + Unix/Linux + + Supported PostScript viewers include evince, gv, gsview and okular. These + are also listed as pdf viewers. Additional pdf viewers are xpdf, gpdf, + epdfview and acroread/Adobe Reader. You can also specify a previewer + manually in the configuration screen; see the [26]user manual.. + + Mac OS X + + Epspdftk will always use the default pdf viewer under OS X, usually + Preview or Adobe Reader. + +Files + + * [27]epspdf.0.4.0.tgz preferred for Unix and Mac OS X + * [28]epspdf.0.4.0.zip preferred for Windows + * [29]epspdf.0.4.0.exe Windows setup program, including Ruby/Tk subset + * [30]epspdf_app.0.2.01.zip Mac OS X applet for starting epspdftk.rb + + Older releases + + * [31]epspdf.0.3.0.tgz for Unix and Mac OS X + * [32]epspdf.0.3.0.zip for Windows + * [33]epspdf.0.3.0.exe Windows setup program + * [34]epspdf.0.2.12.tgz for Unix and Mac OS X + * [35]epspdf.0.2.12.zip for Windows + * [36]epspdf.0.2.12.exe Windows setup program + * [37]epspdf.0.2.11.tgz for Unix and Mac OS X + * [38]epspdf.0.2.11.zip for Windows + * [39]epspdf.0.2.11.exe Windows setup program + * [40]epspdf.0.2.01.tgz for Unix and Mac OS X + * [41]epspdf.0.2.01.zip for Windows + * [42]epspdf.0.2.exe, Windows setup program + +Releases + + 0.4.0 + Current version. Optionally uses hires boundingbox. Faster startup + due to simpler testing of prerequisites. Grayscaling: support for + HSB color model, although I yet have to encounter a PostScript + file using this. Manual converted to texinfo format. Windows: new + View with... button; support for MikTeX's built-in Ghostscript; + streamlined Ruby subset, with Tcl/Tk compiled from source. + + 0.3.0 + Under Windows, now recognizes whether it is embedded in TeX Live + 2008 and then can use ghostscript/pdftops from TeX Live. Also + added TeX Live wrapper scripts. Uninstaller for Windows setup + program. Bug fixes: now accepts non-numerical version strings for + pdftops. No longer checks for viewers under Mac OS X. + + 0.2.12 + 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 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 + + -------------------------------------------------------------------------- + + Last revised: February 29, 2009 + +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#releases + 8. http://tex.aanhet.net/epspdf/epspdf.pdf + 9. http://users.phg-online.de/tk/MOSXS/ + 10. http://tex.aanhet.net/epspdf/index.html#tlnote + 11. http://tex.aanhet.net/epspdf/index.html#tlzipnote + 12. http://pages.cs.wisc.edu/~ghost/ + 13. http://www.foolabs.com/xpdf/ + 14. http://users.phg-online.de/tk/MOSXS/ + 15. http://www.tug.org/texlive/ + 16. http://www.tug.org/mactex/ + 17. http://www.macports.org/ + 18. http://rubyforge.org/projects/rubyinstaller/ + 19. http://rubyforge.org/frs/?group_id=167 + 20. http://www.ruby-lang.org/en/downloads/ + 21. http://activestate.com/Products/ActiveTcl/ + 22. http://tex.aanhet.net/epspdf/epspdf.0.3.0.exe + 23. http://tex.aanhet.net/epspdf/epspdf.0.3.0.zip + 24. http://tex.aanhet.net/epspdf/epspdf.0.3.0.tgz + 25. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip + 26. http://tex.aanhet.net/epspdf/epspdf.pdf + 27. http://tex.aanhet.net/epspdf/epspdf.0.4.0.tgz + 28. http://tex.aanhet.net/epspdf/epspdf.0.4.0.zip + 29. http://tex.aanhet.net/epspdf/epspdf.0.4.0.exe + 30. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip + 31. http://tex.aanhet.net/epspdf/epspdf.0.3.0.tgz + 32. http://tex.aanhet.net/epspdf/epspdf.0.3.0.zip + 33. http://tex.aanhet.net/epspdf/epspdf.0.3.0.exe + 34. http://tex.aanhet.net/epspdf/epspdf.0.2.12.tgz + 35. http://tex.aanhet.net/epspdf/epspdf.0.2.12.zip + 36. http://tex.aanhet.net/epspdf/epspdf.0.2.12.exe + 37. http://tex.aanhet.net/epspdf/epspdf.0.2.11.tgz + 38. http://tex.aanhet.net/epspdf/epspdf.0.2.11.zip + 39. http://tex.aanhet.net/epspdf/epspdf.0.2.11.exe + 40. http://tex.aanhet.net/epspdf/epspdf.0.2.01.tgz + 41. http://tex.aanhet.net/epspdf/epspdf.0.2.01.zip + 42. http://tex.aanhet.net/epspdf/epspdf.0.2.exe diff --git a/Master/texmf-dist/doc/support/epspdf/epspdf.pdf b/Master/texmf-dist/doc/support/epspdf/epspdf.pdf Binary files differnew file mode 100644 index 00000000000..9ac30cf1cf0 --- /dev/null +++ b/Master/texmf-dist/doc/support/epspdf/epspdf.pdf diff --git a/Master/texmf-dist/doc/support/epspdf/epspdf.texi b/Master/texmf-dist/doc/support/epspdf/epspdf.texi new file mode 100644 index 00000000000..284b106bdd7 --- /dev/null +++ b/Master/texmf-dist/doc/support/epspdf/epspdf.texi @@ -0,0 +1,511 @@ +\input texinfo @c -*-texinfo -*- +@c %**start of header +@setfilename epspdf.info +@settitle Epspdf and epspdftk User Guide 0.4 +@afourpaper +@c %**end of header + +@ifhtml +@alias chapter = unnumbered +@alias section = unnumberedsec +@alias subsection = unnumberedsubsec +@end ifhtml + +@tex +\input pstexi +@end tex + +@iftex +@textfonts +@rm +@raggedbottom +@end iftex + +@set version 0.4.0 +@set homepage http://tex.aanhet.net/epspdf/ + +@setchapternewpage off +@paragraphindent none + +@copying +This manual is for epspdf, version @value{version}. + +Copyright @copyright{} 2006, 2007, 2008, 2009 Siep Kroonenberg. + +@quotation +Permission is granted to make and distribute verbatim copies of this +entire document without royalty provided the copyright notice and this +notice are preserved. +@end quotation +@end copying + +@titlepage +@sp 2 +@center @titlefont {Epspdf and epspdftk User Manual} +@sp 1 +@center A multiplatform GUI- and command-line converter for [e]ps and pdf +@sp 2 +@center Siep Kroonenberg (@email{n dot s dot kroonenberg at rug dot nl}) +@vskip 0pt plus 1filll +@insertcopying +@end titlepage + +@contents + +@ifnottex +@node Top +@top Epspdf and epsdftk + +@insertcopying +@end ifnottex + +@menu +* Usage:: +* Command-line usage:: +* Notes on PostScript and pdf:: +* Troubleshooting:: +* Changes in version 0.4:: + +@detailmenu + --- The Detailed Node Listing --- + +Usage + +* Overview:: +* Viewing:: +* Conversion options:: +* Converting:: +* The configuration screen:: + +Command-line usage + +* Option summary:: + +Notes on PostScript and pdf + +* Bitmapped and vector:: +* Font embedding:: +* Eps preview headers:: +* Bounding- and other boxes:: +* Orientation:: +* Exporting PostScript from Windows programs:: + +Troubleshooting + +* Grayscaling fails:: +* Part of the graphic gets cut off:: +* Fonts look ugly:: +* Resources for troubleshooting:: + +@end detailmenu +@end menu + +@node Usage +@chapter Usage + +@menu +* Overview:: +* Viewing:: +* Conversion options:: +* Converting:: +* The configuration screen:: +@end menu + +@node Overview +@section Overview + +Epspdftk converts files between eps, pdf and general +PostScript. The main screen lets you open a file, select some options +and convert the file. + +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 part of the screen. + +@noindent @image{images/main_w32,,3in} +@iftex +@hfill +@end iftex +@image{images/cnv_osx,,3in} + +@node Viewing +@section Viewing + +The View button at the bottom of the screen calls an appropriate +external viewer. + +@i{Windows:} Epspdftk simply tries to use the default Open command. A +second button, labeled @i{View with...}, lets the user select a +different program to view the file. + +For OS X the viewer is also the default program, but there is no @i{View +with...} button. + +Under Linux the PostScript- and pdf viewers are +configurable; see @ref{The configuration screen}. + +The View button is grayed if epspdf thinks that there is no +previewer for the current file. + +@node Conversion options +@section Conversion options + +@anchor{gray}@i{Grayscaling:} Simple color figures can be converted to +grayscale. Bitmapped data won't be converted. If grayscaling doesn't +work on non-bitmapped data, select the ``Try harder to +grayscale'' option. This may cause an extra pdf-PostScript roundtrip. + +@i{Compute tight boundingbox:} This option is only available +if a single page is converted. + +@i{Page selection:} The only possibilities are selecting a +single page or selecting all pages. When converting to eps you are +restricted to a single page. + +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. + +Specifying options such as grayscaling or page selection may require +several roundtrips between PostScript or eps and pdf. + +@node Converting +@section Converting + +The Convert and save... button calls up a file save dialog. After a +successful conversion, the result becomes the new current file, so you +can judge the result by pressing the View button again. + +@node The configuration screen +@section The configuration screen + +@image{images/config_lnx,3in} + +Epspdftk also has a configuration screen. The settings here are +preserved between sessions. + +@subsection Configuring viewers + +Under Linux, the preferred PostScript- and pdf viewers can be configured +in this screen. Epspdf looks for a number of PostScript- and pdf +viewers, from which you can select one, but you can also enter one +manually. + +For Windows and Mac OS X, there is no such configuration option. Epspdf +will use the program associated with the file type, which can be +configured outside epspdf. Under Windows, you can use the ``View +with...'' button instead. + +@subsection Options for converting to pdf +Double-check the setting ``Target use'' under ``Conversion to +pdf''. Choose ``prepress'' for pdfs which are target for commercial +printing. This option will try to embed all fonts, among other +things. Often, printshops insist on this. With luck, Ghostscript fonts +and system fonts will be used for fonts which were not originally +embedded. + +On the other hand, you may prefer ``screen'' if file size is a +concern. See also the Ghostscript documentation, in particular Use.htm +and Ps2pdf.htm. + +@subsection Options for converting to PostScript +For conversion the other way you may opt @i{not} to use pdftops even if +it is available. In this case, the conversion will be done by +Ghostscript. Characters may be converted to drawn shapes or little +bitmaps so this is not recommended. + +Under Windows, this is also the place to point the program to the +location of pdftops.exe. + +@anchor{hires}@subsection Hires BoundingBox +Uncheck the option ``Use hires boundingbox if possible'' if otherwise +the computed boundingbox is slightly too tight, resulting in some +clipping. It has two effects: +@itemize @bullet +@item +When converting to pdf, it uses the standard rather than the hires +boundingbox for page dimensions +@item +When computing a boundingbox, it adds a small safety margin of 1pt to +the standard boundingbox, except where it would make any boundingbox +coordinate negative. +@end itemize + +@node Command-line usage +@chapter Command-line usage + +epspdf.rb, the library for epspdftk.rb, does double duty as command-line +version of epspdftk.rb. It shares configuration settings with +epspdftk.rb. + +It is strongly recommended to invoke epspdf.rb via a wrapper script +epspdf or epspdf.bat on the search path, e.g. +@example +#!/bin/sh +@var{path_to_epspdf}/epspdf.rb "@@" +@end example +for Unix/Linux/OS X, or +@example +"@var{path_to_ruby.exe}" "@var{path_to_epspdf.rb}" %* +@end example +for Windows. It is the responsibility of the caller to provide double +quotes. + +The TeX Live package for epspdf already includes such wrapper scripts. + +Basic usage: + +@example +epspdf [@var{options}] @var{infile} @var{outfile} +@end example + +@menu +* Option summary:: +@end menu + +@node Option summary +@section Option summary + +The summary below is the output of a command @kbd{epspdf --help} +for help. +@example +$ epspdf --help +Epspdf version 0.4.0 +Copyright (C) 2006, 2008, 2009 Siep Kroonenberg +Epspdf 0.4.0 +Convert between [e]ps and pdf formats +Usage: epspdf.rb [options] infile [outfile] +Default for outfile is file.pdf if infile is file.eps or file.ps +Default for outfile is file.eps if infile is file.pdf + -g, --gray, --grey Convert to grayscale; + success not guaranteed + -G, --GRAY, --GREY Try harder to convert to grayscale + -p, --pagenumber=PAGENUMBER Page to be converted or selected + -b, --bbox, --BoundingBox Compute tight boundingbox + -n, --no-hires Don't use hires boundingbox + -r, --hires Use hires boundingbox + -T, --target=TARGET Target use of pdf; one of + default, printer, prepress, screen, ebook + -N, --pdfversion=PDFVERSION Pdf version to be generated + -V, --version=PDFVERSION Deprecated; use `-N' or `--pdfversion'. + -I Ignore pdftops even if available + (default: use if available) + -U Use pdftops if available + (overrides previous -I setting) + -C, --custom=CUSTOMOPTIONS Custom options for conversion to pdf, + view Use.htm and ps2pdf.htm from + the Ghostscript documentation set + -P, --psoptions=PSOPTIONS Options for pdftops; default -level3, + don't include -eps or page number options; + these will be generated by the program + -i, --info Info: display detected filetype + -s Save (some) settings + -d Debug: don't remove temp files + -v Prints version info + -h, --help Show this message +@end example + +@node Notes on PostScript and pdf +@chapter Notes on PostScript and pdf + +@menu +* Bitmapped and vector:: +* Font embedding:: +* Eps preview headers:: +* Bounding- and other boxes:: +* Orientation:: +* Exporting PostScript from Windows programs:: +@end menu + +@node Bitmapped and vector +@section Bitmapped and vector + +Pictures can be described either in terms of pixels, or more abstractly, +in terms of geometric shapes, fonts and text. + +Bitmapped or pixel-based graphics are appropriate for photographs and +screenshots, but less so for diagrams and spreadsheet-generated +graphics. + +A file in PostScript- or pdf format can contain both types of graphic +data, e.g. a text in vector format agains a photographic background in +bitmapped format. + +Vector graphics can be freely scaled without losing sharpness or +becoming pixellated. If bitmapped graphics are enlarged too much, +individual pixels become apparent. With low-resolution bitmaps this +happens sooner than with high-resolution bitmaps, but high-resolution +bitmaps have (much) larger file sizes, and take longer to process. + +So avoid converting vector to bitmap. However, converting from bitmap to +vector is also best avoided, since it is very hard to do well. + +Epspdf normally avoids conversion from vector to bitmap and never +converts the other way. With the screen- and ebook ``Target use'' +option, included bitmaps tend to be downsampled, i.e. reduced to a lower +resolution. + +@node Font embedding +@section Font embedding + +When converting to pdf, Ghostscript handles font embedding differently +depending on the ``Target use'' option. For prepress, it embeds even +the standard fonts, including Times etc. Ghostscript has copies of these +fonts in case the PostScript file doesn't have them. For screen, it +doesn't embed standard fonts. + +You can embed fonts after the fact by converting pdf to eps or ps, and +back to pdf, with target use set to ``prepress''. However, don't try this +unless you have pdftops. + +If target use is set to ``screen'', then standard fonts will be removed +instead of added. This option may also cause downsampling of bitmaps. + +@node Eps preview headers +@section Eps preview headers + +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. + +@node Bounding- and other boxes +@section Bounding- and other boxes + +A PostScript file may have a page size and a boundingbox defined. A pdf +file may have a mediabox, a trimbox and various other boxes. Ghostscript +by itself normally converts the PostScript page -- which is anchored at +(0,0) -- to the pdf mediabox. + +When epspdf or a similar program converts eps to pdf, it adds code to +move the bottom left corner of the graphic to (0,0) and to set the page +to the size of the graphic. Anything outside the boundingbox should be +cut off. + +Both Ghostscript and pdftops have some parameters for setting or using +these boxes; consult Ps2pdf.htm from the Ghostscript documentation and +``pdftops --help'' or ``man pdftops''. + +@node Orientation +@section Orientation + +There appears to be no reliable way to set orientation for PostScript- +and pdf files. This may result part of a graphic being cut off after +conversion or even everything falling outside the page / mediabox / +boundingbox. It may help to change the extension from ``.eps'' to +``.ps'' before converting to pdf. In this case, let epspdf generate a +new boundingbox. + +@node Exporting PostScript from Windows programs +@section Exporting PostScript from Windows programs + +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: choose +``Outline'' for font downloading and avoid the ``Optimize for speed'' +setting for PostScript Output Option. Try e.g. ``Archive'' +instead. These options can be found under the Advanced button. + +@image{images/ps_settings,2.5in} + +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 +available from @url{http://www.tug.org/ctan.html}. + +@node Troubleshooting +@chapter Troubleshooting + +@menu +* Grayscaling fails:: +* Part of the graphic gets cut off:: +* Fonts look ugly:: +* Resources for troubleshooting:: +@end menu + +@node Grayscaling fails +@section Grayscaling fails + +See above, under @ref{gray,,Grayscaling}. Epspdf is +limited by what can be done by the backend tools, i.e. Ghostscript +and pdftops. In particular, epspdf cannot grayscale bitmapped data. + +@node Part of the graphic gets cut off +@section Part of the graphic gets cut off + +Things to try: +@itemize @bullet +@item +If the PostScript file was generated with the Windows PostScript driver, +experiment with the PostScript Output option. Don't choose Optimize for +Speed. +@item +Replace the extension with ``.ps'' and let epspdf generate a +boundingbox. +@item +Boundingbox calculations may be slightly inaccurate where text is +involved. If just a sliver is cut off, let epspdf ignore the +high-resolutuion boundingbox. Command-line option: ``-n'' or +``--no-hires''. +@end itemize + +@node Fonts look ugly +@section Fonts look ugly + +If Ghostscript has to do the conversion from pdf to ps then text will +not remain text, but will be replaced by drawn shapes or bitmaps. Try +to get hold of the xpdf suite, which includes pdftops, especially if +your files contain serious amount of text. + +@node Resources for troubleshooting +@section Resources for troubleshooting + +@i{Logfile.} 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 @file{c:\Documents and +Settings\@var{your user name}}. Otherwise, open a DOS box and type +@kbd{echo %USERPROFILE%}, which will produce this +information. + +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. + +@i{Temporary files.} 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 as to which temporary files have been +created. + +@anchor{Documentation}@i{Ghostscript- and pdftops documentation.} For +Ghostscript, the most important files are Ps2pdf.htm and Use.htm. For +pdftops, type @kbd{pdftops -h}. For Unix, there is also a man page, and +for Windows there is a file pdftops.txt in the distribution zip. + +@node Changes in version 0.4 +@chapter Changes in version 0.4 + +Hi-res boundingboxes are now supported. By default, conversion from eps +to pdf now uses the hires boundingbox as ``page'' to determine the page +dmensions of the pdf file. Other conversions preserve or generate a +hires boundingbox. + +Under Windows, the new version looks for an installed @TeX{} and will +use its private Ghostscript if it cannot find separately installed +Ghostscript. @TeX{} Live's pdftops, being on the searchpath, will be +used unless epspdf finds another copy first. + +There is now a ``-v'' (lowercase) option to print the version string. + +@ifhtml +@section @url{index.html,Main page} +@end ifhtml + +@bye diff --git a/Master/texmf-dist/doc/support/epspdf/images/cnv_osx.png b/Master/texmf-dist/doc/support/epspdf/images/cnv_osx.png Binary files differnew file mode 100644 index 00000000000..3c326785d23 --- /dev/null +++ b/Master/texmf-dist/doc/support/epspdf/images/cnv_osx.png diff --git a/Master/texmf-dist/doc/support/epspdf/images/config_lnx.png b/Master/texmf-dist/doc/support/epspdf/images/config_lnx.png Binary files differnew file mode 100644 index 00000000000..5988934e22f --- /dev/null +++ b/Master/texmf-dist/doc/support/epspdf/images/config_lnx.png diff --git a/Master/texmf-dist/doc/support/epspdf/images/main_w32.png b/Master/texmf-dist/doc/support/epspdf/images/main_w32.png Binary files differnew file mode 100644 index 00000000000..ab7aa189140 --- /dev/null +++ b/Master/texmf-dist/doc/support/epspdf/images/main_w32.png diff --git a/Master/texmf-dist/doc/support/epspdf/images/ps_settings.png b/Master/texmf-dist/doc/support/epspdf/images/ps_settings.png Binary files differnew file mode 100644 index 00000000000..4648a855386 --- /dev/null +++ b/Master/texmf-dist/doc/support/epspdf/images/ps_settings.png diff --git a/Master/texmf-dist/doc/support/epspdf/index.html b/Master/texmf-dist/doc/support/epspdf/index.html new file mode 100644 index 00000000000..f1a02ef4db2 --- /dev/null +++ b/Master/texmf-dist/doc/support/epspdf/index.html @@ -0,0 +1,406 @@ +<?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="#releases">Releases</a></li> +<li><a href="epspdf.pdf">User Manual</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> +<li>Support for TeX Live and MiKTeX</li> +</ul> + +<p>Epspdf has been created with TeX in mind. For TeX and its +derivatives, 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 converting text back to PostScript. 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> + +<p>Starting with the 2008 edition, epspdf is included in TeX Live as +an optional package, complete with wrapper scripts epspdf and +epspdftk which can be called from the command-line without further +ado.</p> + +<h2><a name="prerequisites"/>Prerequisites</h2> + +<p>These are the required and optional prerequisites, which will be +checked for when epspdf starts:</p> +<ul> +<li>Ghostscript</li> +<li>pdftops from the xpdf suite, strongly recommended for better + pdf to PostScript conversions</li> +<li>Ruby 1.8.<i>x</i></li> +<li>Tcl/Tk is only required for the GUI interface. Only version 8.4 + has been tested.</li> +<li>Optional: viewers for PostScript and pdf</li> +</ul> + +<p>You may not have to install all of these yourself.</p> + +<h3>Linux</h3> + +<p>On a current Linux distribution you can almost certainly install +everything from your distribution's package repositories. You may +have to install Ruby's Tk bindings, in addition to Ruby and Tcl/Tk +themselves. The name of such a package might be +e.g. libtcltk-ruby. As to PostScript- and pdf viewers: epspdf tests +for several popular viewers, but the configuration screen also lets +you specify viewers manually.</p> + +<h3>Mac OS X (Tiger and later)</h3> + +<p>Ruby and Tcl/Tk are already part of the operating +system. Ghostscript is included in MacTeX, but is also available via +e.g. MacPorts. You can get pdftops from MacPorts as part of either +Poppler or xpdf. Another source is <a +href="http://users.phg-online.de/tk/MOSXS/">http://users.phg-online.de/tk/MOSXS/</a>.</p> + +<p>If you want to compile xpdf it yourself, which is not hard, you +can ignore warnings about X, Motif or FreeType not being found since +these missing libraries won't affect the compilation of pdftops.</p> + +<h3>Windows (Windows 2000 and later)</h3> + +<p>By itself, Windows lacks any of the prerequisites of +epspdf. However, a TeX installation may fill some of the gaps, and +there is a special Windows installer which includes a partial Ruby +installation. See the table below:</p> + +<table id="prereq"> + + <thead><tr><th class="fcol">TeX + distribution</th><th>Installer</th><th>Zipfile</th></tr></thead> + + <tfoot> + <tr><td colspan="3"><b><a name="tlnote" + class="fineprint"> (1)</a></b> MikTeX and TeX Live 2008 include a + hidden Ghostscript which is always installed, and which epspdf + knows how to find. Caveat: although older versions of TeX Live + include a Ghostscript installer, it is not impossible to install an + older TeX Live without Ghostscript, in which case you have to + provide a Ghostscript yourself.</td></tr> + + <tr><td colspan="3"><b><a name="tlzipnote" + class="fineprint"> (2)</a></b> With TeX Live ≥ 2008, you are + better off installing the TeX Live package, which also gives you + wrapper batchfiles epspdf.bat and epspdftk.bat. You still need to + install Ruby and Tcl/Tk.</td></tr> + </tfoot> + + <tr><th class="fcol">TeX Live<a href="#tlnote">(1)</a></th><td>No additional + requirements</td> <td>Ruby, Tcl/Tk<a href="#tlzipnote">(2)</a></td></tr> + + <tr><th class="fcol">MiKTeX</th><td>Pdftops (optional)</td> <td>Pdftops + (optional); Ruby, Tcl/Tk(optional)</td></tr> + + <tr><th class="fcol">Other/None</th><td>Ghostscript, pdftops (optional)</td> + <td>Ghostscript; pdftops(optional), Ruby, Tcl/Tk + (optional)</td></tr> + + +</table> + +<h3>URLs for the prerequisites</h3> + +<dl> + +<dt>Ghostscript and GSview (<a + href="http://pages.cs.wisc.edu/~ghost/">http://pages.cs.wisc.edu/~ghost/</a>)</dt> + <dd>Contains sources and Windows binaries. The Windows binaries + come with standard GUI Windows setup programs.</dd> + +<dt>XPDF (<a + href="http://www.foolabs.com/xpdf/">http://www.foolabs.com/xpdf/</a>)</dt> + <dd> Sources and Windows binaries. The Windows binaries are + packaged into a zipfile, which has to be manually unpacked. The + Configure screen of epspdftk lets you browse for the chosen + location. You have to do this only once. </dd> + +<dt>XPDF, Mac OS X binaries (<a + href="http://users.phg-online.de/tk/MOSXS/">http://users.phg-online.de/tk/MOSXS/</a>)</dt> + <dd>These are universal binaries.</dd> + +<dt>TeX Live (<a + href="http://www.tug.org/texlive/">http://www.tug.org/texlive/</a>)</dt> + <dd>TeX Live 2008 includes epspdf as an optional install. For + Windows, this version doesn't require external copies of pdftops + or Ghostscript but does not include Ruby or Tcl/Tk.</dd> + +<dt>MacTeX (<a + href="http://www.tug.org/mactex/">http://www.tug.org/mactex/</a>)</dt> + <dd>MacTeX is based on TeX Live. Its set of add-ons includes + Ghostscript, and can be downloaded separately.</dd> + +<dt>The MacPorts Project (<a + href="http://www.macports.org/">http://www.macports.org/</a>)</dt> + <dd>MacTeX has Poppler- and xpdf packages either of which include + pdftops.</dd> + +<dt>Ruby one-click installer for Windows (<a + href="http://rubyforge.org/projects/rubyinstaller/"> + http://rubyforge.org/projects/rubyinstaller/</a>)</dt> <dd>Current + versions (1.8.4 and later) require Tcl/Tk to be separately + installed.</dd> + +<dt>Old releases of Ruby one-click installer (<a + href="http://rubyforge.org/frs/?group_id=167"> + http://rubyforge.org/frs/?group_id=167</a>)</dt> <dd>Versions + prior to 1.8.4 include Tcl/Tk.</dd> + +<dt>Ruby source code (<a + href="http://www.ruby-lang.org/en/downloads/">http://www.ruby-lang.org/en/downloads/</a>)</dt><dd>For + those people who prefer to roll their own...</dd> + +<dt>ActiveTcl from ActiveState (<a + href="http://activestate.com/Products/ActiveTcl/"> + http://activestate.com/Products/ActiveTcl/</a></dt> <dd> Get + version 8.4, not 8.5.</dd> + +</dl> + + +<h2><a name="install"/>Installation</h2> + +<p>First make sure that the prerequisites are met. Then:</p> + +<h3>TeX Live 2008</h3> + +<p>Use TeX Live's package manager tlmgr for installation.</p> + +<h3>Windows setup program</h3> + +<p>Download the <a href="epspdf.0.3.0.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.3.0.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>" %* +</pre> + +<p>With such a batchfile, the caller has to take care of quoting:</p> +<pre> +epspdf "my file.eps" "my file.pdf" +</pre> + +<p>Epspdf[tk] has been tested with Windows 2000, Windows XP and +Windows Vista.</p> + +<h3>Unix/Linux</h3> + +<p>Download the <a href="epspdf.0.3.0.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 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 programs for PostScript and +pdf. If you have TeX Live 2008 or later then you can assign <TeX +Live root>\bin\win32\psv.bat as previewer for .ps- and .eps +files. For Windows only, there is an additional <q>View +with...</q> button to select a viewer yourself.</p> + +<h3>Unix/Linux</h3> + +<p>Supported PostScript viewers include evince, gv, gsview and +okular. These are also listed as pdf viewers. Additional pdf viewers +are xpdf, gpdf, epdfview and acroread/Adobe Reader. You can also +specify a previewer manually in the configuration screen; see the <a +href="epspdf.pdf"> user manual.</a>.</p> + +<h3>Mac OS X</h3> + +<p>Epspdftk will always use the default pdf viewer under OS X, +usually Preview or Adobe Reader.</p> + +<h2><a name="files"/>Files</h2> + +<ul> +<li><a href="epspdf.0.4.0.tgz">epspdf.0.4.0.tgz</a> preferred for Unix +and Mac OS X</li> + +<li><a href="epspdf.0.4.0.zip">epspdf.0.4.0.zip</a> preferred for +Windows</li> + +<li><a href="epspdf.0.4.0.exe">epspdf.0.4.0.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.3.0.tgz">epspdf.0.3.0.tgz</a> for Unix +and Mac OS X</li> +<li><a href="epspdf.0.3.0.zip">epspdf.0.3.0.zip</a> for +Windows</li> +<li><a href="epspdf.0.3.0.exe">epspdf.0.3.0.exe</a> Windows setup + program</li> +<li><a href="epspdf.0.2.12.tgz">epspdf.0.2.12.tgz</a> for Unix +and Mac OS X</li> +<li><a href="epspdf.0.2.12.zip">epspdf.0.2.12.zip</a> for +Windows</li> +<li><a href="epspdf.0.2.12.exe">epspdf.0.2.12.exe</a> Windows setup + program</li> +<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="releases"/>Releases</h2> + +<dl> <dt>0.4.0</dt><dd>Current version. Optionally uses hires + boundingbox. Faster startup due to simpler testing of + prerequisites. Grayscaling: support for HSB color model, although + I yet have to encounter a PostScript file using this. Manual + converted to texinfo format. Windows: new <q>View with...</q> + button; support for MikTeX's built-in Ghostscript; streamlined + Ruby subset, with Tcl/Tk compiled from source.</dd> + +<dt>0.3.0</dt><dd>Under Windows, now recognizes whether it is +embedded in TeX Live 2008 and then can use ghostscript/pdftops from +TeX Live. Also added TeX Live wrapper scripts. Uninstaller for +Windows setup program. Bug fixes: now accepts non-numerical version +strings for pdftops. No longer checks for viewers under Mac OS +X.</dd> + +<dt>0.2.12</dt><dd>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. Epspdf.app is now +packaged separately, 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> + +<hr/> + +<p class="fineprint">Last revised: February 29, 2009</p> +</body></html> diff --git a/Master/texmf-dist/doc/support/epspdf/pstexi.tex b/Master/texmf-dist/doc/support/epspdf/pstexi.tex new file mode 100644 index 00000000000..63e86cb3e36 --- /dev/null +++ b/Master/texmf-dist/doc/support/epspdf/pstexi.tex @@ -0,0 +1,49 @@ +% change texinfo fonts +% usage: put the following code early in your file, +% but after \input texinfo + +%%%%%%%%%%%%%%%% +% @tex +% \input pstexi +% @end tex +% +% @textfonts +% @rm +%%%%%%%%%%%%%%%% + +% Set the font macro #1 to the font named #2, adding on the +% specified font prefix (normally `cm'). +% #3 is the font's design size, #4 is a scale factor +% \def\setfont#1#2#3#4{\font#1=\fontprefix#2#3 scaled #4} +% UPDATE: a new implementation uses a fifth encoding(?) parameter, +% which we simply ignore. +\newcount\atsize +\def\setfont#1#2#3#4#5{% + \def\mag{#4} + \global\atsize=\mag + \global\multiply\atsize #3 + \global\divide\atsize 1000 + \global\font#1=#2 at \atsize pt} + +% \fontprefix not usable outside cm/lm/ec +\gdef\fontprefix{} + +\gdef\rmshape{pplr7t} +\gdef\rmbshape{pplb7t} %where the normal face is bold +\gdef\bfshape{pplb7t} +\gdef\bxshape{pplb7t} +\gdef\ttshape{texnansi-lmtt10} +\gdef\ttbshape{texnansi-lmtk10} +\gdef\ttslshape{texnansi-lmtto10} +\gdef\itshape{pplri7t} +\gdef\itbshape{pplbi7t} +\gdef\slshape{pplri7t} +\gdef\slbshape{pplbi7t} +\gdef\sfshape{texnansi-lmss10} +\gdef\sfbshape{texnansi-lmssbx10} +\gdef\scshape{pplrc7t} +\gdef\scbshape{pplbc7t} + +\definetextfontsizexi + +\global\let\subtitlerm=\tenrm |