path: root/README.old

This is Scribus Version 1.3.5.

CHANGES 1.3.3.x to 1.3.5
========================

1) Because of the new file format features, Scribus documents saved in 1.3.5
   are *not* backward compatible with 1.3.3.x or 1.2.x .

2) You *can* install both versions in parallel and run them at the same time.
   The only caveat is to install them using different prefix/ directories e.g
   1.3.3.x in /usr/local and 1.3.5 in /opt or $home/bin. You can use the
      -DCMAKE_INSTALL_PREFIX=/path/to/install/dir
   argument to CMake to set where Scribus should be installed.

3) In some cases Scribus 1.3.3 uses wrong character sizes when layouting text. 
   This might cause differences in linebreaking if you open a 1.3.3.x
   document in 1.3.5.

CHANGES 1.2.x to 1.3.x
======================

Important notes on the differences between 1.2.x and 1.3.x:

1) Because of the new file format features, Scribus documents saved in 1.3.x
   are *not* backwardly compatible.

2) Because of the new enhanced menu/keyboard shortcuts code, 1.2.x  keyboard
   short cuts are not migrated and will need to be recreated once on the first
   launch 1.3.x.

3) On initial launch, 1.3.x will offer to convert preferences to the new 1.3.x
   format. This is recommended. Scribus 1.3.x will store its preferences
   separately from 1.2.x. Moreover, 1.3.2 caches available fonts. The first 
   startup may take longer than anticipated. 


4) You *can* install both versions in parallel and run them at the same time.
   The only caveat is to install them using different prefix/ directories e.g
   1.2 in /usr/local and 1.3 in /opt or $home/bin. You can use the --prefix
   argument to configure to set where Scribus should be installed.

CONVERTING 1.1.x DOCUMENTS
==========================

Newer versions of Scribus use a different way to find fonts from Scribus 1.1.1.
To convert older( =< 1.1.1) documents follow the procedure below:

1) Create a document with the old Version of Scribus containing all your Fonts.
2) Open the new Scribus and go to the Font Substitution List.
3) Clear out all current substitutions.
4) Open the Document created in 1) and substitute all the fonts with the
   correct new fonts.

When you now open old documents Scribus will convert all font names
automatically.

For detailed changes please see the ChangeLog.

LANGUAGE SUPPORT
================

To use Scribus in your native language be sure that the environment variable
LC_ALL, LC_MESSAGES, LANG, Qt locale, OR the command line option of -l/--lang
<lang> is set correctly. This is also can be changed in the preferences and
takes effect immediately.

REQUIRED TOOLS, LIBRARIES AND OTHER FILES
=========================================

GhostScript
-----------

One of the more crucial tools Scribus depends on is Ghostscript. While it is
not required for compilation, Scribus must be able to find a recent version of
Ghostscript at runtime for all features to be present and fully working. In
particular, printing, print preview, and PDF/EPS import will not be fully
functional without Ghostscript. Ghostscript 8.x is STRONGLY recommended.
Support for versions older than 8.x is untested and Scribus may not operate
reliably using such an old version of gs.

You can find out which version of GhostScript Scribus is using in the about
dialog. If you have a newer version installed somewhere else you can
specify its' location in the preferences.

You can get a new version of Ghostscript from http://www.ghostscript.com/ .
There is documentation on how to install a new version of Ghostscript on the
Scribus website:
    http://docs.scribus.net/index.php?lang=en&sm=dtptoolbox&page=toolbox7
or you can just download it and install it in /usr/local, then set your PATH.

Debian users who haven't installed their own newer version of Ghostscript may
want to install gs-gpl then use
    `update-alternatives --config gs'
as root to select gs-gpl as the default version of Ghostscript to use. The ESP
GhostScript used by many Debian systems by default will not work as well as gs-gpl.

ICC Profiles for Colour Management
----------------------------------

Activating Color Management *requires* installation of CMYK and RGB ICC
profiles. Please see the included help files, FAQ's on www.scribus.net and
http://docs.scribus.net for details. As of the 1.3.1 release,  Scribus ships
with 2 icc profiles, which are installed only to enable color management
functionality.  (This is not true for some distribution packages, where
licensing rules prevent the inclusion of a full set of profiles).  The profiles
*do not* provide meaningful color management for printing. Additional profiles
are downloadable from www.scribus.net and depend on your hardware and printing
environment.

KNOWN ISSUES
============

Please see bugs.scribus.net for a more comprehensive list of known issues.

PSD/CMYK TIFF Support
---------------------

1.3.2+ now has support for CMYK PSD and 8-bit CMYK TIFF support. RGB PSD and
16-bit TIFF support is being developed. PSD and TIFF support includes layers, ICC
profiles and embedding clipping paths. CMYKA is supported in Scribus 1.3.4+

FONT ISSUES
-----------

There are extensive notes and detailed on documentation on fonts and trouble
shooting of font issues in the help documentation and online at
http://docs.scribus.net  Please read these carefully before filing bugs.

There are issues with the postscript naming conventions with the Computer Modern
Type 1 fonts, depending on distribution.  In some cases, not all fonts from the
same family are visible in Scribus. We are working on a more complete solution
during a future release.



BUILDING AND INSTALLING FROM SOURCE
===================================

Please see the `BUILDING' file for details on how to compile and install
Scribus, library requirements, etc.




DISTRIBUTION AND OS SPECIFIC NOTES
=====================

Debian
------

If Scribus does not start while complaining about the absence of
Postscript fonts please install either xfonts-scalable or gsfonts-x11.
They are in the "Recommends" and will be installed by all sensible apt
front-ends.

You may not see an entry for colour management in the Scribus preferences. If
you do not, you must install the icc-profiles package from non-free to get a core
set of ICC profiles. This will not provide enough for you to get effective colour
managemnet, but will provide better RGB<->CMYK conversions than the unmanaged mode.
See the "ICC Profiles for colour management" section above for details.

Also see the section entitled `GHOSTSCRIPT' above.

SuSE 
--------

To enable direct CUPS support which recommended, make sure both cups-devel and
openssl-devel are installed. Suse enables ssl support in CUPS. The current
Scribus config checks do not test for this. See the BUILDING file for details.

The Scribus Team builds rpms for all current releases and recommends their use
over self compiling.

Red Hat / Fedora
----------------

The Scribus RPMS in Fedora Extras are of very high quality and have been
created with close cooperation from Fedora maintainers and the Scribus Team. We
recommend them for most users as they will ensure correct integration with the
menuing system and mime types. Alternately, you can use the Fedora Core
repositories maintained on the build server - see the downloads section on
www.scribus.info for details.

There is a separate file, PACKAGING for detailed hints and notes on building
packages for Scribus.

On Fedora, if you report a crash bug, it would be extremely handy if you could
build a debug version of Scribus (-DCMAKE_BUILD_TYPE=debug argument to cmake)
and get a stack trace. This is not required, but does help us diagnose the
problem more quickly and reliably. Some information on stack traces can be
found here:

http://fedora.linux.duke.edu/wiki/StackTraces

Mac OS X
--------

A Mac OS X native Aqua port is available. More information can be found on
http://aqua.scribus.net/ .

Microsoft Windows
-----------------

There is a separate readme for Windows, please see readme-win32.html in
scribus/doc .

Additional information
======================

More hints and other information are on the www.scribus.net and docs.scribus.net
sites. Full compile, install and FAQ's are available there.

There is a lively on-line community, both on IRC @ #scribus on irc.freenode.net
and the mailing list. Mailing list info can be found at:
 http://nashi.altmuehlnet.de/mailman/listinfo/scribus

Thanks to the many translators, testers, packagers and contributors who make
the Scribus community so special.