SHORT DESCRIPTION
=================

(This is a copy of the LaTeX code of the documentation's abstract.)

This package provides a macro (|\includecombinedgraphics|) for the
inclusion of combined EPS/\LaTeX{} and PDF/\LaTeX{} graphics (an export
format of Gnuplot, Xfig, and maybe other programs).  Instead of including
the graphics with a simple |\input|, the |\includecombinedgraphics| macro
has some comforts:

\begin{itemize}
  \item changing the font and color of the text of the \LaTeX{} part
  \item rescaling the graphics without affecting the font of the \LaTeX{}
    part
  \item automatic inclusion of the vector graphics part, as far as \LaTeX{}
    part does not do it (e.\,g., for files exported from Gnuplot before
    version 4.2)
  \item rescaling and rotating of complete graphics (similar to
    |\includegraphics| from \textsf{graphicx} package)
\end{itemize}

See `combinedgraphics.pdf' for detailed information on usage.

BUILDING
========

If you do not want to use any pre-build `combinedgraphics.sty' and
`combinedgraphics.pdf' files, you will have to choose one of the following
two ways for building them. Otherwise you can skip this section.

1) Building with make
---------------------

Running `make' will create the LaTeX package, the documentation and the test
file:
  $ make

2) Building manually
--------------------

a) Generation of package (.sty file):

Run `combinedgraphics.ins' through LaTeX:
  $ pdflatex -interaction=nonstopmode combinedgraphics.ins

b) Generation of documentation:

Run `combinedgraphics.dtx' through LaTeX:
  $ pdflatex -interaction=nonstopmode combinedgraphics.dtx

Then create the index and change history:
  $ makeindex -s gind.ist -o combinedgraphics.ind combinedgraphics.idx
  $ makeindex -s gglo.ist -o combinedgraphics.gls combinedgraphics.glo

Finally, run `combinedgraphics.dtx' three time through LaTeX:
  $ pdflatex -interaction=nonstopmode combinedgraphics.dtx
  $ pdflatex -interaction=nonstopmode combinedgraphics.dtx
  $ pdflatex -interaction=nonstopmode combinedgraphics.dtx

Optionally you can compile the test file:
  $ pdflatex -interaction=nonstopmode combinedgraphics_test.tex
  $ pdflatex -interaction=nonstopmode combinedgraphics_text.tex
  $ pdflatex -interaction=nonstopmode combinedgraphics_text.tex

INSTALLATION
============

Copy the file `combinedgraphics.sty' to a directory, where LaTeX will find it.

LICENSE
=======

Copyright 2009 Christian Schneider <software(at)chschneider(dot)eu>

ion@addto@macro: identical to l@addto@macro from koma-script
                 bundle v2.9t
Copyright 1994-2004 Markus Kohm and Frank Neukam

Thanks to Markus Kohm for permitting to use his code in this package.
Please do not bother Markus with questions or bugs concering this package!

This file is part of combinedgraphics.

combinedgraphics is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License version 3 as
published by the Free Software Foundation, not any later version.

combinedgraphics 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 combinedgraphics.  If not, see <http://www.gnu.org/licenses/>.

WARNING: THIS IS ALPHA SOFTWARE AND MAY CONTAIN SERIOUS BUGS!