Xdvips V1.0 - Little frontend to dvips (dvi to postscript converter) using the Xforms library.
Copyright (C) 1996 Christoph Neerfeld (Christoph.Neerfeld@mail.bonn.netsurf.de).

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., 675 Mass Ave, Cambridge, MA 02139, USA.

--------------------------------------------------------------------------

NEW: Version 1.0.1 (patch level 1)
----------------------------------
- now uses autoconf and configure to build and install
- improved the code to parse the /etc/printcap
- more error messages, when something goes wrong


DESCRIPTION
-----------

Xdvips is a small frontend to dvips the dvi to postscript converter. It is for those
of you who can't remember, or don't want to remember the various options to dvips.
There is no extra functionality, but it makes life a little bit easier.
For example, you can use it as a replacement to dvips in lyx (lyx is a nearly WYSIWYG
frontend to LaTeX). Now you can print from pages 4 to 15 and give X- and Y-offset (features 
of dvips that are not supported by lyx).
But you may use xdvips as a standalone program as well.

WHAT YOU NEED
-------------

You need X11, of course.
Xforms V0.81 - it may work with older versions of Xforms, but this is not tested.
dvips        - this program was tested with dvips from the teTeX distribution
properly configured /etc/printcap ( Email me, if you have any problems with this;
                                    if my program has problems reading your printcap,
                                    not if you have problems setting up your printcap
                                    for printing!)

INSTALL
-------

First run './configure', then
'make' should do; 'make install' copies the executable 'xdvips' into /usr/local/bin.
If you don't like this, put it somewhere else in your path. 'xdvips' is the only file
you have to install.

For lyx users: change the line '\print_command dvips' to '\print_command xdvips'
               in your .lyxrc file.

DOCUMENTATION
-------------

ONLY HERE ! There is no man file, or other documentation.

xdvips [filename]

Xdvips recognices the following options of dvips:
	 -A -B -r -O% -t% -X% -Y% -P% -p%
For a description of these options read the man page for dvips. They are not
specific to xdvips.

If you don't specify a file name, a file chooser pops up and let you select a file.

It follows a short description of the input fields:

Filename:     The file name of your dvi file. If it ends on .dvi, .dvi will be
	      replaced by .ps when creating a postscript file.
	      If you want to select another file, press the 'O' button next to 
	      the input field.

First page:   The first page you like to print. '*' means, start with first page
	      what ever that is.

Last page:    The last page you like to print. If you want to print only the fifth
	      page, insert 'First page: 5' 'Last page: 5'. 

X-Resolution: The resolution in dpi, that dvips should use. The default value of 
	      360 dpi is hardcoded into xdvips. Normaly you don't have to specify
	      this option at all. So it will only be sent to dvips, if the button
	      next to the input field is pressed.
	      For those of you printing with 300 dpi: Don't press the button and 
	      dvips will use whatever is its default.
	      You will need this option only in very rare cases.

Y-Resolution: The same as above for vertical resolution.

X-Offset:     Shift the hole page horizontally. Valid dimensions are mm, cm, inch,
	      pt. For short: all that is valid for dvips, too.

Y-Offset:     Shift the hole page vertically. Remember, even negativ offsets are 
	      allowed (-3mm).

Paper-format: This is a list of valid paper formats. This list is hardcoded into
	      xdvips. ( Sorry ;-) ).

Printer:      This is a list of print queues on your computer. The list is taken
              out of your /etc/printcap. You may activate or deactivate this 
	      option by pressing the button next to the input field.
	      NOTE: If you activate this option you need a config file for this 
	      particular printer. For example: If you have a queue called 'remote',
	      then you need a config file called 'config.remote' in your config
	      directory of dvips. This 'config.remote' may be a copy or a link to
	      'config.ps' or a file of its own, if you need another configuration
	      than the default one in 'config.ps'.
	      Imagin you have two print queues on your setup: One called 'lp' for
	      the printer attached to your printer port (this printer uses 360 dpi)
	      and one called 'remote' for a printer somewhere in your network (this
	      printer uses 600 dpi). Then you need two files 'config.lp' and 
	      'config.remote' with different configuration, one for 360 dpi and 
	      600 dpi. If your setup is configured properly, you select 'lp' or 
	      'remote' within xdvips and all should work well.
	      If you don't know what I'm talking about, just don't press the button
	      next to the input field ;-).

The buttons All, Even, Odd and reverse order should be selfexplanatory.

VERSION
-------
This is the first release. But I called it version 1.0 because it is quite usable and 
so small that there should be only a few bugs left. ( All right this was not true. I had
a lot of trubble with different Linux distributions. Sorry.)
(if anyone is offended by then name 'xdvips' tell me).

REPORTING BUGS and SUGGESTIONS
------------------------------
send bugreports concerning xdvips to Christoph.Neerfeld@mail.bonn.netsurf.de

TODO
----
?? - tell me

BUGS
----
no man page


