aboutsummaryrefslogtreecommitdiffstats
path: root/src/documentation/content/xdocs/download.xml
blob: bb736d7760da603e8bb0cce4d0a2791c7886cebb (plain)
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
166
167
168
169
170
<?xml version="1.0" standalone="no"?>
<!--
  Licensed to the Apache Software Foundation (ASF) under one or more
  contributor license agreements.  See the NOTICE file distributed with
  this work for additional information regarding copyright ownership.
  The ASF licenses this file to You under the Apache License, Version 2.0
  (the "License"); you may not use this file except in compliance with
  the License.  You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.
-->
<!-- $Id$ -->
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "http://forrest.apache.org/dtd/document-v13.dtd">
<document>
  <header>
    <title>Apache FOP: Downloading A Distribution</title>
    <version>$Revision$</version>
  </header>
  <body>
    <section id="dist-type">
      <title>Binary or Source?</title>
      <p>
        Most FOP users will want to download the latest binary distribution, 
        which is ready to run "out of the box." However, a source distribution 
        will be preferable if you fall into one of the following categories:
      </p>
      <ul>
        <li>
          You wish to modify FOP.
        </li>
        <li>
          You wish to use a version more recent than the latest release. For 
          example, if you have read on the user mailing list that a bug has 
          been fixed or a feature added that you are eager to try, you might 
          download a source distribution from the CVS repository so that you 
          don't have to wait for the next release.
        </li>
        <li>
          You wish to build a local copy of the API documentation (javadocs).
        </li>
      </ul>
    </section>
    <section id="binary">
      <title>Binary Download</title>
      <p>
        Binary distributions include "-bin" in their names, and can be downloaded from a
        <link href="http://www.apache.org/dyn/closer.cgi/xmlgraphics/fop">FOP Distribution mirror</link>.
      </p>
    </section>
    <section id="source">
      <title>Source Download</title>
      <p>
        You must first determine which of the two main development branches you wish 
        to download, "maintenance" or "redesign". See 
        <link href="dev/index.html">Development Introduction</link> for more details 
        on the choices, and for the CVS tags to use when downloading the "maintenance" 
        branch.
      </p>
      <p>
        There are several ways to obtain a source distribution. Please note that they 
        are listed from least current to most current:
      </p>
      <ul>
        <li>
          Download a released version from a 
          <link href="http://www.apache.org/dyn/closer.cgi/xmlgraphics/fop">FOP Distribution mirror</link>.
          Source distributions include "-src" in their names. Please note that official 
          releases currently are <em>only</em> made from the "maintenance" branch.
        </li>
        <!--li>
          Download a CVS snapshot from the cvs files 
          <link href="http://xml.apache.org/from-cvs/xml-fop/">here</link>. 
          These snapshots are built approximately every six hours, and have the GMT of 
          their creation time embedded in their names. Please note that CVS snapshots 
          are made only for the "redesign" branch.
        </li-->
        <li>
          Download directly from the SVN repository.
          Anyone can do this using the 
          <link href="http://xmlgraphics.apache.org/repo.html">Anonymous SVN Server</link>.
          By default, the code in SVN is up-to-the-minute, the same code that the developers 
          are modifying. See the <link href="dev/tools.html#svn">SVN section of Developer Tools</link>
          for more information on using SVN.
        </li>
      </ul>
      <p/>
      <table>
        <tr>
          <th colspan="2">Old Maintenance Branch (for 0.20.5)</th>
        </tr>
        <tr>
          <td>Repository URL</td>
          <td>
            <link href="http://svn.apache.org/repos/asf/xmlgraphics/fop/branches/fop-0_20_2-maintain/">
              <code>http://svn.apache.org/repos/asf/xmlgraphics/fop/branches/fop-0_20_2-maintain/</code>
            </link>
          </td>
        </tr>
        <tr>
          <td>Web view</td>
          <td>
            <link href="http://svn.apache.org/viewvc/xmlgraphics/fop/branches/fop-0_20_2-maintain/">
              <code>http://svn.apache.org/viewvc/xmlgraphics/fop/branches/fop-0_20_2-maintain/</code>
            </link>
          </td>
        </tr>
        <tr>
          <th colspan="2">Latest Release Branch</th>
        </tr>
        <tr>
          <td>Repository URL</td>
          <td>
            <link href="http://svn.apache.org/repos/asf/xmlgraphics/fop/branches/fop-0_93/">
              <code>http://svn.apache.org/repos/asf/xmlgraphics/fop/branches/fop-0_93/</code>
            </link>
          </td>
        </tr>
        <tr>
          <td>Web view</td>
          <td>
            <link href="http://svn.apache.org/viewvc/xmlgraphics/fop/branches/fop-0_93/">
              <code>http://svn.apache.org/viewvc/xmlgraphics/fop/branches/fop-0_93/</code>
            </link>
          </td>
        </tr>
        <tr>
          <th colspan="2">Trunk</th>
        </tr>
        <tr>
          <td>Repository URL</td>
          <td>
            <link href="http://svn.apache.org/repos/asf/xmlgraphics/fop/trunk/">
              <code>http://svn.apache.org/repos/asf/xmlgraphics/fop/trunk/</code>
            </link>
          </td>
        </tr>
        <tr>
          <td>Web view</td>
          <td>
            <link href="http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/">
              <code>http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/</code>
            </link>
          </td>
        </tr>
      </table>
      <p>
        With any source distribution, you will need to 
        build FOP from the source files. For details please see the "Build" page on the documentation tab
        for the version you've downloaded.
      </p>
      <fixme author="jeremias">Reenable the link to the SVN snapshots once they are available.</fixme>
    </section>
    <section id="archives">
      <title>Archive Download</title>
      <p>
        FOP Archive distributions are linked from the upper portion of the Apache FOP 
        Download Mirror Page and can be downloaded from the FOP Archives 
        <link href="http://archive.apache.org/dist/xmlgraphics/fop/binaries/">binaries</link> &amp; 
        <link href="http://archive.apache.org/dist/xmlgraphics/fop/source/">source</link> links.
      </p>
    </section>
  </body>
</document>
<!-- Last Line of $RCSfile$ -->