1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
|
$Id$
==============================================================================
APACHE FOP - README
==============================================================================
Contents of this file:
- What is FOP?
- Legal Information
- Where to get help?
- How do I build FOP?
- How do I run FOP?
- Release Notes
==============================================================================
What is FOP?
---------------
Apache FOP is the world's first print formatter driven by XSL formatting
objects. It is a Java application that reads a formatting object tree
conforming to the XSL 1.0 Recommendation (15 October 2001) and then turns it
into a PDF document, certain other output formats or allows you to preview it
directly on screen. Some parts of the XSL 1.1 specification (work in progress!)
have also been implemented.
Apache FOP is part of Apache's XML Graphics project. The homepage of Apache
FOP is http://xmlgraphics.apache.org/fop/.
Legal Information
---------------------
Apache FOP is published under the Apache License version 2.0. For the license
text, please see the following files:
- LICENSE
- NOTICE
Legal information on libraries used by Apache FOP can be found in the
"lib/README.txt" file.
Here is a list of files included in Apache FOP but not published under Apache
License version 2.0:
- sRGB IEC61966-2.1 color profile
File: src/java/org/apache/fop/pdf/sRGB Color Space Profile.icm
Info: src/java/org/apache/fop/pdf/sRGB Color Space Profile.icm.LICENSE.txt
- K3 3 of 9 barcode font (TrueType)
File: examples/fo/advanced/K3.TTF
Info: example/fo/advanced/K3.README
Where to get help?
---------------------
http://xmlgraphics.apache.org/fop/gethelp.html
A mailing list where you can get all your questions about FOP answered is at
fop-users@xmlgraphics.apache.org. You can subscribe by sending an empty mail
to fop-users-subscribe@xmlgraphics.apache.org.
Before you post any questions, please have a look at the FAQ at
http://xmlgraphics.apache.org/fop/faq.html and FO help page at
http://xmlgraphics.apache.org/fop/fo.html.
Please report bugs to bugzilla at http://issues.apache.org/bugzilla/
How do I build FOP?
----------------------
If you've downloaded a binary distribution, you don't need to build FOP.
Otherwise, please follow the instructions found here:
http://xmlgraphics.apache.org/fop/latest/compiling.html
How do I run FOP?
--------------------
Simply by typing "fop" on the command-line. Without any parameters you
will receive a screen with instruction on how to call FOP from the
command-line.
For more details, see: http://xmlgraphics.apache.org/fop/latest/running.html
==============================================================================
RELEASE NOTES
==============================================================================
Version 0.92 beta
---------------------
We don't list all the changes since the 0.20.5 release, since the codebase
was practically rewritten in large areas as part of a big redesign effort.
This is basically a new software. But the changes since 0.90 alpha 1 can be
looked up under http://xmlgraphics.apache.org/fop/changes.html.
Upgrading from 0.20.5:
Please read http://xmlgraphics.apache.org/fop/latest/upgrading.html
The Apache FOP team asks you for your continued feedback on the new software.
We're also interested in success stories with the new release. So if the
latest version works fine for you, please tell us! And if it doesn't, you
may tell us as well, of course. ;-)
Caveats:
- This release is a beta release. If you intend to use this software
in a production environment, please perform careful testing.
- With the latest changes, the API is now considered stable. Please
note that the API has changed in a backwards-incompatible way since
the last release.
- You may experience different behaviour compared to version 0.20.5.
Please consult the "Upgrading" page indicated above for details.
Known issues:
- PCL, MIF and SVG support have not been restored, yet.
- Java2D/AWT support contains some problems, for example with
block-containers.
- Auto table layout is not implemented, yet.
- The collapsing border model on tables is not implemented, yet. Please
use border-collapse="separate" for now.
- Footnotes may overlap with text of the region-body in multi-column
documents.
- Space resolution does not work between footnote regions.
- There's a problem involving nested block-containers and
reference-orientation 180/-180 (Bugzilla #36391)
- block-containers with no height currently don't create a fence for
spaces as they should (they behave like a normal block).
- Preserved linefeeds in fo:character are not handled correctly.
- An empty block currently produces a fence for stacking constraints
which it shouldn't.
- There are several small problems around white space handling.
- Images currently don't shrink so they fit on a page when they are
too big and shrinking is allowed to happen.
- Block-level content in fo:inlines may produce unwelcome results.
- inline-container may not work as expected.
- leaders with leader-pattern="use-content" may not work as expected.
- keep-with-previous doesn't work inside tables and lists, yet.
- White space on direct inline-level children of a marker is not
handled correctly.
- If two consecutive pages don't have the same available width, the
content currently isn't properly fit into the available space on
the new page.
- background-images on page-number-citations are not placed correctly.
- Not all FO elements can be referenced by their "id", most notably:
table-body, table-header, table-footer and table-row.
- The backgrounds of table-body, table-header, table-footer and
table-column are not painted, yet.
- Border and padding conditionality are not supported on table-cells, yet.
- Copy/Paste from PDF content in Acrobat Reader is not supported for
text using embedded TrueType fonts.
- Column balancing in multi-column documents may not work as expected
(Bugzilla #36356)
- Omitting fo:table-column or having fo:table-column without a column-width
and attempting to create columns implicitly from the first
table row is not implemented, yet (Bugzilla #35656).
- Internal basic-links don't point to the exact location on a page, yet,
as they did in 0.20.5. Currently you land in the upper left corner of
the page.
Release notes for older FOP versions can be found on:
http://xmlgraphics.apache.org/fop/relnotes.html
|
