"SfR Fresh" - the SfR Freeware/Shareware Archive 
As a special service "SfR Fresh" has tried to format the requested source page into HTML format using source code syntax highlighting with prefixed line numbers.
Alternatively you can here view or download the uninterpreted source code file.
That can be also achieved for any archive member file by clicking within an archive contents listing on the first character of the file(path) respectively on the according byte size field.
1 This is Scribus Version 1.3.3.12, the fifteenth release of the 1.3.x development
2 series. We have stablized 1.3.3.x and now consider his our stable release.
3 Scribus 1.2.x is deprecated.
4
5 CHANGES 1.2.x to 1.3.x
6 ======================
7
8 Important notes on the differences between 1.2.x and 1.3.x:
9
10 1) Because of the new file format features, Scribus documents saved in 1.3.x
11 are *not* backwardly compatible.
12
13 2) Because of the new enhanced menu/keyboard shortcuts code, 1.2.x keyboard
14 short cuts are not migrated and will need to be recreated once on the first
15 launch 1.3.x.
16
17 3) On initial launch, 1.3.x will offer to convert preferences to the new 1.3.x
18 format. This is recommended. Scribus 1.3.x will store its preferences
19 separately from 1.2.x. Moreover, 1.3.2 caches available fonts. The first
20 startup may take longer than anticipated.
21
22
23
24 Additionally, Scribus uses a different way to find fonts from Scribus 1.1.1.
25 To convert older( =< 1.1.1) documents follow the procedure below:
26
27 1) Create a document with the old Version of Scribus containing all your Fonts.
28 2) Open the new Scribus and go to the Font Substitution List.
29 3) Clear out all current substitutions.
30 4) Open the Document created in 1) and substitute all the fonts with the
31 correct new fonts.
32
33 When you now open old documents Scribus will convert all font names
34 automatically.
35
36 Scribus 1.3.3.8+ includes support for building via CMake, a replacement
37 for traditional autotools.
38 Please see:http://docs.scribus.net/index.php?lang=en&page=install4 for details.
39
40 For detailed changes please see the ChangeLog.
41
42 To use Scribus in your native language be sure that the environment variable
43 LC_ALL, LC_MESSAGES, LANG, Qt locale, OR the command line option
44 of -l/--lang <lang> is set correctly. This is also can be changed in the preferences
45 and takes effect immediately.
46
47 The EPS/PS import feature again improved in 1.3.3 uses advanced features of Ghostscript. We
48 recommend ALL users update to the newest version of Ghostscript available for
49 your distribution. In addition, if you still have GS 7.0x, there are detailed hints on
50 docs.scribus.net for installing GS 8.x in parallel to the GS installed by your
51 distribution.
52
53 The current importer will now import raster images within an EPS file provided you have at
54 least GS 8.15, with the current limitations:
55
56 * imagemask doesn't work correctly
57 * clip path is ignored
58 * creates one file for each bitmap, which can be a lot
59
60 Activating Color Management *requires* installation of CMYK and RGB ICC
61 profiles. Please see the included help files, FAQ's on www.scribus.net and
62 http://docs.scribus.net for details. As of the 1.3.1 release, Scribus ships with
63 2 icc profiles, which are installed only to enable color management functionality.
64 The profiles *do not* provide meaningful color management for printing. Additional
65 profiles are downloadable from www.scribus.net and depend on your hardware and
66 printing environment.
67
68 Other notes/known issues at the time of release:
69
70 There is a bug in font outline handling for some fonts in the freetype
71 libraries. It's being worked on upstream. Don't file a bug report. Instead
72 change the font used if you need the outlines. This is not a Scribus bug.
73 Some testing has shown that this bug is not present in freetype 2.1.10+, but
74 we counsel caution trying to upgrade freetype2. Upgrading freetype2 on some
75 distributions can be quite difficult.
76
77 PSD/CMYK TIFF Support
78
79 1.3.3+ now has support for CMYK PSD and 8-bit CMYK TIFF support. RGB PSD and
80 16-bit TIFF support is being developed. PSD and TIFF support includes layers, ICC
81 profiles and embedding clipping paths. CMYKA is not yet supported as there is a
82 limitation in the Qimage class. RGBA is supported. Current Scribus 1.3.4cvs does
83 handle a much larger variety of CMYKA files along with advanced PSD features.
84
85 Issue with gradients:
86
87 If you have gradient (e.g. with black color) with 50% shade in both beginning
88 and end of gradient, you end up with darker center than edges. One expects
89 the gradient to have equal shading from beginning to end, especially if there
90 is no other color-stops in-between them. This we believe is a libart issue
91 and not fixable by us. The gradient will export and print properly.
92 The optional cairo build is a compile time option. The is enabled by:
93 ./configure --enable-cairo
94 The cairo build option is optional, has not received all the needed
95 regression tests and requires cairo 1.2.x+ or greater.
96 Cario 1.2.x+ is strongly recommended.
97
98 Our experimental Cairo build does not have these issues. We encourage those
99 willing to test the Cairo backend builds and report issues to the mailing
100 list and/IRC. We *know* the Cairo enabled build is slower, but are encouraged
101 by the on-going development by the Cairo team.
102
103 FONT ISSUES
104 ===========
105
106 There are extensive notes and detailed on documentation on fonts and trouble
107 shooting of font issues in the help documentation and online at
108 http://docs.scribus.net Please read these carefully before filing bugs.
109
110 There are issues with the postscript naming conventions with the Computer Modern
111 Type 1 fonts, depending on distribution. In some cases, not all fonts from the
112 same family are visible in Scribus. We are working on a more complete solution
113 for the next release.
114
115
116
117 BUILDING AND INSTALLING FROM SOURCE
118 ===================================
119
120 Please see the files `BUILDING' and `INSTALL' for details on how to compile and
121 install Scribus, library requirements, etc.
122
123 GHOSTSCRIPT
124 ===========
125
126 One of the more crucial tools Scribus depends on is Ghostscript. While it is
127 not required for compilation, Scribus must be able to find a recent version of
128 Ghostscript at runtime for all features to be present and fully working. In
129 particular, printing, print preview, and PDF/EPS import will not be fully
130 functional without Ghostscript. Ghostscript 8.5x is STRONGLY recommended.
131 Support for versions older than 7.07 is untested and Scribus may not operate
132 reliably using such an old version of gs.
133
134 You can get a new version of Ghostscript from http://www.ghostscript.com/ .
135 There is documentation on how to install a new version of Ghostscript on the
136 Scribus website:
137 http://docs.scribus.net/index.php?lang=en&sm=dtptoolbox&page=toolbox7
138 or you can just download it and install it in /usr/local, then set your PATH.
139
140 If you're compiling Scribus yourself, it will whine at you during configure if
141 it notices an older version of Ghostscript, or can't find it at all. If you
142 know you have a newer version installed, run `gs --version' and (on bash)
143 `which gs' to check what version is being used and where it's installed. You
144 may need to tweak your PATH environment variable to find the newer version
145 instead. Note that you can set which version of Ghostscript Scribus uses, and
146 where to find it, in the Scribus preferences.
147
148 Debian users who haven't installed their own newer version of Ghostscript may
149 want to install gs-afpl then use:
150 `update-alternatives --config gs'
151 as root to select gs-afpl as the default version of Ghostscript to use.
152
153 DISTRIBUTION AND OS SPECIFIC NOTES
154 =====================
155
156 For MacOSX, OS/2 and Windows Please also see the specific platform notes as
157 well.
158
159 Debian
160 ======
161
162 If Scribus does not start while complaining about the absence of
163 Postscript fonts please install either xfonts-scalable or gsfonts-x11.
164 They are in the "Recommends" and will be installed by all sensible apt
165 front-ends.
166
167 Also see the section entitled `GHOSTSCRIPT'.
168
169 SuSE 9.x/10.0
170 ========
171
172 1)The littlecms libs 1.10, which shipped with 9.0 does not offer complete
173 support for all the the latest CMS features in Scribus 1.2+. There are updated
174 SuSE 9.x RPM's available on the Scribus.net site. We also recommend using the
175 latest version of lcms.
176
177 2)If you are using Qt 3.3.x, please ensure you are using the latest Qt 3.3.x
178 rpms.
179
180 3)To enable direct CUPS support which recommended, make sure both cups-devel
181 and openssl-devel are installed. Suse enables ssl support in CUPS. The
182 current Scribus config checks do not test for this. See the BUILDING file
183 for details.
184
185
186 Red Hat / Fedora
187 ================
188
189 Fedora/RH users are recommended to have at least Qt 3.3.2-6. These have
190 important fixes for Scribus. The Scribus RPMS in Fedora Extras are of very high
191 quality and have been created with close cooperation from Fedora maintainers
192 and the Scribus Team. We recommend them for most users as they will ensure
193 correct integration with the menuing system and mime types.
194
195 Please see the included help files and http://docs.scribus.net for details.
196
197 Grey scale icc profiles in images are not supported in this release..
198
199 There is a separate file, PACKAGING for detailed hints and notes on building
200 packages for Scribus.
201
202 On Fedora, if you report a crash bug, it would be extremely handy if you could
203 build a debug version of Scribus (--enable-debug to configure) and get a stack
204 trace. This is not required, but does help us diagnose the problem more quickly
205 and reliably. Some information on stack traces can be found here:
206
207 http://fedora.linux.duke.edu/wiki/StackTraces
208
209 Mac OS X
210 ========
211
212 There is also information about building and using Scribus on Mac OS X on the
213 Scribus wiki: http://wiki.scribus.net/ .
214
215 A Mac OS X native Aqua port is in early testing. More information can be found
216 on http://aqua.scribus.net/ .
217
218 Microsoft Windows
219 =================
220
221 There is a separate readme for Windows, please see readme-win32.html
222
223 Additional information
224 ======================
225
226 More hints and other information are on the www.scribus.net and docs.scribus.net
227 sites. Full compile, install and FAQ's are available there.
228
229 There is a lively on-line community, both on IRC @ #scribus on irc.freenode.net
230 and the mailing list. Mailing list info can be found at:
231 http://nashi.altmuehlnet.de/mailman/listinfo/scribus
232
233 Thanks to the many translators, testers, packagers and contributors who make
234 the Scribus community so special.
235
236 For the Scribus Team,
237 Craig Ringer
238 Peter Linnell
239 in June 8 2008