home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 3 / Meeting_Pearls_III.iso / Pearls / texmf / inputs / latex / packages / graphics / 00readme.txt next >
Text File  |  1995-06-21  |  7KB  |  211 lines
  1. %%
  2. %% This file is part of the Standard LaTeX `Graphics Bundle'.
  3. %%
  4. %% It should be distributed *unchanged* and together with all other
  5. %% files in the graphics bundle. The file 00readme.txt contains a list
  6. %% of all of these files.
  7. %%
  8. %% A modified version of this file may be distributed, but it should
  9. %% be distributed with a *different* name. Changed files must be
  10. %% distributed *together with a complete and unchanged* distribution
  11. %% of these files.
  12. %%
  13.  
  14.  
  15. The LaTeX Colour and Graphics Packages
  16. ========================================
  17.                     1995/06/19
  18.  
  19. This is a pre-release of LaTeX packages for:
  20.  * producing colour
  21.  * including graphics (eg PostScript) files 
  22.  * rotation and scaling of text
  23. in LaTeX documents.
  24.  
  25.  
  26. This is still a test release.
  27.  
  28.  
  29. Main Changes in the June 1995  version
  30. ======================================
  31.  
  32. Not much new at the user level 
  33.    - hopefully this will be the last `test' release!
  34.  
  35. graphicx package defines a couple of new keys for \includegraphics:
  36.   trim and viewport (see grfguide for more info about these).
  37.  
  38. epsfig no longer forces a default to dvips driver.
  39.   (The default specified in a graphics.cfg file will be used)
  40.  
  41. Due to internal changes, old `.def' files will *not* work with this
  42. release. The main change is that the `bounding box' coordinates are no
  43. longer stored in TeX dimen registers, but rather in macros. this
  44. allows the exact value to be passed to the driver in `bp' without
  45. introducing rounding errors.
  46.  
  47.     
  48. David Carlisle 1994/11/29
  49.  
  50.  
  51. ========================================================================
  52.  
  53.  
  54. THIS DIRECTORY CONTAINS 
  55. ======================
  56. ======================
  57.  
  58. 00readme.txt    This File
  59. changes.txt     Log of changes to the packages.
  60. graphics.ins    Install file for docstrip.
  61.  
  62. Standard packages
  63. =================
  64. color.dtx       Source for color package
  65. graphics.dtx    Source for graphics package
  66. trig.dtx        Source for trig package (required by graphics)
  67.  
  68. Non Standard Packages
  69. =====================
  70. graphicx.dtx    Source for graphicx package (extension of graphics)
  71. epsfig.dtx      Source for epsfig package (extension of graphicx)
  72. keyval.dtx      Source for keyval pacakge (required by both the above)
  73. pstcol.sty      Small wrapper for pstricks package.
  74. lscape.sty      Produce landscape pages in a (mainly) portrait document.
  75.  
  76. Driver Files
  77. ============
  78. drivers.dtx     Source for driver files for supported drivers.
  79.  
  80. User Documentation
  81. ==================
  82. grfguide.tex    User Guide to all the packages in this bundle.
  83.                 WARNING: 
  84.                 This file calls color and graphics packages
  85.                 without a driver option. 
  86.                 You *must* set up two files 
  87.                                  color.cfg and graphics.cfg
  88.                 containing (for example)
  89.                                 \ExecuteOptions{dvips}
  90.                 Before running this file.
  91.  
  92. grfguide.ps     PostScript version of the above (Using PostScript fonts)
  93.                 You may use this to see examples that your driver may
  94.         not be able to achieve.
  95.  
  96.  
  97. =============================================
  98.  
  99. TO UNPACK THE PACKAGES
  100. ======================
  101.  
  102. latex graphics.ins
  103.  
  104. This will produce the 
  105.  
  106. .sty package files
  107. .def driver files.
  108.  
  109. =============================================
  110.  
  111. USING THE PACKAGES
  112. ==================
  113.  
  114. Move files ending in .sty .def  to a standard TeX input directory.
  115.  
  116. Make a default option for your site by creating two files
  117.      color.cfg and graphics.cfg
  118. containing (if dvips is your default driver)
  119. \ExecuteOptions{dvips}
  120.  
  121. You may then LaTeX the user guide:
  122. latex grfguide.tex.
  123.  
  124. ==============================================
  125.  
  126.  
  127. Comments from the previous release.
  128. **********************************
  129.  
  130.  
  131. Main Changes in the November/December 1994 version
  132. ========================================================================
  133.  
  134. color.sty
  135. ============
  136.  
  137.    Some code now obsolete code removed as the new LaTeX kernel is more
  138.    colour-aware.
  139.  
  140. graphics.sty
  141. ============
  142. **** Important Note: Change in user-syntax!
  143. *******************************************
  144.     The optional argument to     \DeclareGraphicsExtensions 
  145.     has been removed.
  146.     The new behaviour is equivalent to specifying an argument of []
  147.     in the previous version. ie there is *no longer* a default `.'
  148.     added.
  149.  
  150.     As a consequence of this, all extensions must now be specified
  151.     including the `.' ie .eps not just eps.
  152.  
  153.     This change does not lose any functionality, and makes it much
  154.     easier to work with files with no extension.
  155.  
  156.  
  157. Main Changes in the July/September/October 1994 version
  158. ========================================================================
  159.  
  160. color.sty
  161. ============
  162.  
  163. 1) I separated out the code that converts from `user syntax' to the
  164.    internal version for \special from the code that actually inserts the
  165.    special.
  166.    This means that:
  167.    * It should be easier to work with PSTricks, where the `internal' code
  168.      has to be done *inside* a larger special, so you can not do any
  169.      fancy TeX stuff at that point. A pstcol.sty using pstrics with 
  170.      color.sty based colours is included in this test release.
  171.  
  172.    * The .def file can be a lot simpler as it no longer has to define a
  173.      a `set' command and a `define' command for each colour model.
  174.      It just defines a single `user spec' to `special syntax' command
  175.      for each model, \color and \definecolor both use this same
  176.      internal interface.
  177.  
  178. 2) \color \textcolor are now robust.
  179.    [although \textcolor turns into \color if used as a robust command.
  180.     That is if you say \textcolor{red}{foo} in a section header, 
  181.     the toc file will have {\color{red}foo}
  182.    ]
  183.  
  184. 3) \textcolor is no longer \long (so it matches \textrm) if you want
  185.    lots of paragraphs use \color or \begin{color}
  186.  
  187. 4) Added \DefineNamedColor command to give an interface for the 'named'
  188.    colour model.
  189.  
  190.  
  191. graphics.sty
  192. ===============
  193.  
  194. 1) Added a default rule, eg dvips.def now has the equivalent of
  195.    \DeclareGraphicsRule{*}{eps}{*}{}
  196.    Which means that you can include file with arbitrary extensions:
  197.    \includegraphics{a.xyz} 
  198.    will input this as an eps file unless another rule has been decared
  199.    for the extension xyz.
  200.  
  201. 2) More care taken with catcodes so hopefully this version will work
  202.    with language packages that make ! or " active.
  203.  
  204. 3) Add new error
  205.       {Cannot determine size of graphic in ... (no size specifed)}%
  206.    Generated in the case that the file type has no `read file'
  207.    specified, but the user has not given a size argument.
  208.  
  209. 4) New driver loading code.
  210.  
  211.