FAQ
schof 2005/04/15 13:46:22

Modified: src/documentation/content/xdocs site.xml
Added: src/documentation/content/xdocs binary.xml source.xml
Removed: src/documentation/content/xdocs binary.ihtml source.ihtml
src/documentation/conf cli.xconf
Log:
additional changes to get mirror download page up and running

Revision Changes Path
1.17 +17 -13 incubator-myfaces/src/documentation/content/xdocs/site.xml

Index: site.xml
===================================================================
RCS file: /home/cvs/incubator-myfaces/src/documentation/content/xdocs/site.xml,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- site.xml 15 Apr 2005 13:53:48 -0000 1.16
+++ site.xml 15 Apr 2005 20:46:21 -0000 1.17
@@ -3,19 +3,14 @@

<project-information href="" label="Project" tab="project">
<index_pm href="index.html" label="Welcome"/>
- <license label="License" href="license.html" />
-
- <!--
- Commented out by schof. I think we should move this link to a different tab later.
- <livesites label="Web apps using MyFaces" href="livesites.html"/>
- -->
+ <license label="License" href="license.html" />
+ <downloads label="Downloads">
+ <bindownload label="Binary" href="http://myfaces.apache.org/binary.cgi"/>
+ <srcdownload label="Source" href="http://myfaces.apache.org/src.cgi"/>
+ <bindownload_html href="binary.html"/> <!-- these dummy links are necessary -->
+ <srcdownload_html href="source.html"/> <!-- these dummy links are necessary -->
+ </downloads>
</project-information>
- <downloads label="Downloads" tab="project">
- <bindownload label="Binary" href="http://myfaces.apache.org/binary.cgi"/>
- <bindownload_html href="binary.html"/><!-- so the page is part of a tab -->
- <srcdownload label="Source" href="http://myfaces.apache.org/src.cgi"/>
- <srcdownload_html href="source.html"/><!-- so the page is part of a tab -->
- </downloads>
<components href="components/" label="Components" tab="components">
<overview label="Overview" href="overview.html"/>
<jscookmenu label="JSCook Menu" href="jscookmenu.html"/>
@@ -52,5 +47,14 @@
<wiki label="Wiki" href="http://wiki.apache.org/myfaces"/>
<getinvolved label="Get Involved" href="http://jakarta.apache.org/site/getinvolved.html"/>
</community>
-
+ <!--
+ NOTE: foo tab doesn't really exist (its label is empty String.) This allows us to create bogus
+ links for the binary.xml and source.xml files. These bogus links are necessary to trick
+ Forrest into converting them into html even though they are not linked anywhere. The real
+ links are the cgi scripts tha will eventually make use of these html templates.
+ -->
+ <foo href="" label="" tab="foo">
+ <bindownload_html label="" href="binary.html"/>
+ <srcdownload_html label="" href="source.html"/>
+ </foo>
</site>



1.1 incubator-myfaces/src/documentation/content/xdocs/binary.xml

Index: binary.xml
===================================================================
<!--
Copyright 2005 The Apache Software Foundation or its licensors,
as applicable.

Licensed 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.
-->
<!-- Note: To understand how this template is used, see the documentation
at http://forrest.apache.org/howto/howto-asf-mirror.html
-->
<document>
<header>
<title>Obtaining the Apache MyFaces distribution</title>
</header>
<body>
<section>
<title><a name="how" />How to download</title>
<p>
Use the links below to download a distribution of Apache Forrest from
one of our mirrors. It is good practice to verify the integrity of the
distribution files.
</p>

<p>
Apache MyFaces is distributed as a <code>zip</code> archive (for Windows) and
as a <code>tar.gz</code> archive (for UNIX). The contents are the same. Please note
that the tar.gz archives contain file names longer than 100 characters and have been
created using GNU tar extensions. Thus they must be untarred with a GNU compatible
version of tar.
</p>
</section>
<section>
<title><a name="closest" />Current milestone release (closest mirror site selected automatically)</title>
<p>
You are currently using <b>[preferred]</b>. If you encounter a
problem with this mirror, then please select another. If all
mirrors are failing, there are backup mirrors at the end of the list.
See <a href="http://www.apache.org/mirrors/">status</a> of mirrors.
</p>

<form action="[location]" method="get" id="SelectMirror">
Other mirrors: <select name="Preferred">
<!--[if-any http] [for http]-->
<option value="[http]">[http]</option>
<!--[end] [end]-->
<!--[if-any ftp] [for ftp]-->
<option value="[ftp]">[ftp]</option>
<!--[end] [end]-->
<!--[if-any backup] [for backup]-->
<option value="[backup]">[backup] (backup)</option>
<!--[end] [end]-->
</select>
<input type="submit" value="Change" />
</form>

<p>The current release is Apache MyFaces 1.0.9m9 (see the
<a href="[preferred]/forrest/RELEASE-NOTES-0.6.txt">release notes</a>).
</p>
<ul>
<li>For UNIX operating systems:</li>
<ul>
<li><a href="[preferred]/myfaces/binaries/myfaces-1.0.9.tgz">myfaces-1.0.9.tgz</a></li>
<li>[<a href="http://www.apache.org/dist/myfaces/binaries/myfaces-1.0.9.tgz.asc">PGP</a>]</li>
<li>[<a href="http://www.apache.org/dist/myfaces/binaries/myfaces-1.0.9.tgz.md5">MD5</a>]</li>
</ul>
<li>For Windows operating systems:</li>
<ul>
<li><a href="[preferred]/myfaces/binaries/myfaces-1.0.9.zip">myfaces-1.0.9.zip</a></li>
<li>[<a href="http://www.apache.org/dist/myfaces/binaries/myfaces-1.0.9.zip.asc">PGP</a>]</li>
<li>[<a href="http://www.apache.org/dist/myfaces/binaries/myfaces-1.0.9.zip.md5">MD5</a>]</li>
</ul>
</ul>

<p>There is also a binary distribution of the various webapp examples available.</p>
<ul>
<li>For UNIX operating systems:</li>
<ul>
<li><a href="[preferred]/myfaces/binaries/myfaces-1.0.9-app.tgz">myfaces-1.0.9-app.tgz</a></li>
<li>[<a href="http://www.apache.org/dist/myfaces/binaries/myfaces-1.0.9-app.tgz.asc">PGP</a>]</li>
<li>[<a href="http://www.apache.org/dist/myfaces/binaries/myfaces-1.0.9-app.tgz.md5">MD5</a>]</li>
</ul>
<li>For Windows operating systems:</li>
<ul>
<li><a href="[preferred]/myfaces/binaries/myfaces-1.0.9-app.zip">myfaces-1.0.9-app.zip</a></li>
<li>[<a href="http://www.apache.org/dist/myfaces/binaries/myfaces-1.0.9-app.zip.asc">PGP</a>]</li>
<li>[<a href="http://www.apache.org/dist/myfaces/binaries/myfaces-1.0.9-app.zip.md5">MD5</a>]</li>
</ul>
</ul>

</section>
<section>
<title><a name="svn" />Latest source code and nightly builds from CVS repository</title>

<p>
If you want to use the latest Apache MyFaces features, the source code is under
version control with CVS. Click <link href="http://apache.org/dev/version-control.html">here</link>
for information on how to use the ASF CVS Repository. There are also
<a href="http://cvs.apache.org/builds/myfaces/nightly">nightly</a>
builds available every 24 hours (11:00 PM EST).
</p>
</section>
<section>
<a name="archive" />Archive of old releases
<p>
Older releases are available in the <a
href="http://archive.apache.org/dist/myfaces/">archive</a>. Those
releases are only provided as historical artefacts. We strongly
recommend to not use those releases, but upgrade to the most recent release.
</p>
</section>
<section>
<title><link name="verify" />Verify releases</title>
<p>
It is essential that you verify the integrity of the downloaded
files using the PGP and MD5 signatures. MD5 verification ensures the
file was not corrupted during the download process. PGP verification
ensures that the file came from a certain person.
</p>

<p>
The PGP signatures can be verified using
<a href="http://www.pgpi.org/">PGP</a> or
<a href="http://www.gnupg.org/">GPG</a>.
First download the Apache MyFaces
<a href="http://cvs.apache.org/repos/asf/myfaces/KEYS">KEYS</a>
as well as the <code>asc</code> signature file for the particular
distribution. It is important that you get these files from the ultimate
trusted source - the main ASF distribution site, rather than from a mirror.
Then verify the signatures using ...
</p>

<source>
% pgpk -a KEYS
% pgpv myfaces-X.Y.tgz.asc

<em>or</em>

% pgp -ka KEYS
% pgp myfaces-X.Y.tgz.asc

<em>or</em>

% gpg --import KEYS
% gpg --verify myfaces-X.Y.tgz.asc
</source>

<p>
To verify the MD5 signature on the files, you need to use a program
called <code>md5</code> or <code>md5sum</code>, which is
included in many unix distributions. It is also available as part of
<a href="http://www.gnu.org/software/textutils/textutils.html">GNU
Textutils</a>. Windows users can get binary md5 programs from
<a href="http://www.fourmilab.ch/md5/">here</a>,
<a href="http://www.pc-tools.net/win32/freeware/console/">here</a>, or
<a href="http://www.slavasoft.com/fsum/">here</a>.
</p>
<p>We strongly recommend you verify your downloads with both PGP and MD5.</p>
</section>
</body>
</document>



1.1 incubator-myfaces/src/documentation/content/xdocs/source.xml

Index: source.xml
===================================================================
<!--
Copyright 2005 The Apache Software Foundation or its licensors,
as applicable.

Licensed 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.
-->
<!-- Note: To understand how this template is used, see the documentation
at http://forrest.apache.org/howto/howto-asf-mirror.html
-->
<document>
<header>
<title>Obtaining the Apache MyFaces distribution</title>
</header>
<body>
<section>
<title><a name="how" />How to download</title>
<p>
Use the links below to download a distribution of Apache Forrest from
one of our mirrors. It is good practice to verify the integrity of the
distribution files.
</p>

<p>
Apache MyFaces is distributed as a <code>zip</code> archive (for Windows) and
as a <code>tar.gz</code> archive (for UNIX). The contents are the same. Please note
that the tar.gz archives contain file names longer than 100 characters and have been
created using GNU tar extensions. Thus they must be untarred with a GNU compatible
version of tar.
</p>
</section>
<section>
<title><a name="closest" />Current milestone release (closest mirror site selected automatically)</title>
<p>
You are currently using <b>[preferred]</b>. If you encounter a
problem with this mirror, then please select another. If all
mirrors are failing, there are backup mirrors at the end of the list.
See <a href="http://www.apache.org/mirrors/">status</a> of mirrors.
</p>

<form action="[location]" method="get" id="SelectMirror">
Other mirrors: <select name="Preferred">
<!--[if-any http] [for http]-->
<option value="[http]">[http]</option>
<!--[end] [end]-->
<!--[if-any ftp] [for ftp]-->
<option value="[ftp]">[ftp]</option>
<!--[end] [end]-->
<!--[if-any backup] [for backup]-->
<option value="[backup]">[backup] (backup)</option>
<!--[end] [end]-->
</select>
<input type="submit" value="Change" />
</form>

<p>The current release is Apache MyFaces 1.0.9m9 (see the
<a href="[preferred]/forrest/RELEASE-NOTES-0.6.txt">release notes</a>).
</p>
<ul>
<li>For UNIX operating systems:</li>
<ul>
<li><a href="[preferred]/myfaces/source/myfaces-1.0.9-src.tgz">myfaces-1.0.9-src.tgz</a></li>
<li>[<a href="http://www.apache.org/myfaces/source/myfaces-1.0.9-src.tgz.asc">PGP</a>]</li>
<li>[<a href="http://www.apache.org/myfaces/source/myfaces-1.0.9-src.tgz.md5">MD5</a>]</li>
</ul>
<li>For Windows operating systems:</li>
<ul>
<li><a href="[preferred]/myfaces/source/myfaces-1.0.9-src.zip">myfaces-1.0.9-src.zip</a></li>
<li>[<a href="http://www.apache.org/dist/myfaces/source/myfaces-1.0.9-src.zip.asc">PGP</a>]</li>
<li>[<a href="http://www.apache.org/dist/myfaces/source/myfaces-1.0.9-src.zip.md5">MD5</a>]</li>
</ul>
</ul>

</section>
<section>
<title><a name="svn" />Latest source code and nightly builds from CVS repository</title>

<p>
If you want to use the latest Apache MyFaces features, the source code is under
version control with CVS. Click <link href="http://apache.org/dev/version-control.html">here</link>
for information on how to use the ASF CVS Repository. There are also
<a href="http://cvs.apache.org/builds/myfaces/nightly">nightly</a>
builds available every 24 hours (11:00 PM EST).
</p>
</section>
<section>
<a name="archive" />Archive of old releases
<p>
Older releases are available in the <a
href="http://archive.apache.org/dist/myfaces/">archive</a>. Those
releases are only provided as historical artefacts. We strongly
recommend to not use those releases, but upgrade to the most recent release.
</p>
</section>
<section>
<title><link name="verify" />Verify releases</title>
<p>
It is essential that you verify the integrity of the downloaded
files using the PGP and MD5 signatures. MD5 verification ensures the
file was not corrupted during the download process. PGP verification
ensures that the file came from a certain person.
</p>

<p>
The PGP signatures can be verified using
<a href="http://www.pgpi.org/">PGP</a> or
<a href="http://www.gnupg.org/">GPG</a>.
First download the Apache MyFaces
<a href="http://cvs.apache.org/repos/asf/myfaces/KEYS">KEYS</a>
as well as the <code>asc</code> signature file for the particular
distribution. It is important that you get these files from the ultimate
trusted source - the main ASF distribution site, rather than from a mirror.
Then verify the signatures using ...
</p>

<source>
% pgpk -a KEYS
% pgpv myfaces-X.Y.Z-src.tgz.asc

<em>or</em>

% pgp -ka KEYS
% pgp myfaces-X.Y.Z-src.tgz.asc

<em>or</em>

% gpg --import KEYS
% gpg --verify myfaces-X.Y.Z-src.tgz.asc
</source>

<p>
To verify the MD5 signature on the files, you need to use a program
called <code>md5</code> or <code>md5sum</code>, which is
included in many unix distributions. It is also available as part of
<a href="http://www.gnu.org/software/textutils/textutils.html">GNU
Textutils</a>. Windows users can get binary md5 programs from
<a href="http://www.fourmilab.ch/md5/">here</a>,
<a href="http://www.pc-tools.net/win32/freeware/console/">here</a>, or
<a href="http://www.slavasoft.com/fsum/">here</a>.
</p>
<p>We strongly recommend you verify your downloads with both PGP and MD5.</p>
</section>
</body>
</document>

Search Discussions

Related Discussions

Discussion Navigation
viewthread | post
Discussion Overview
groupcommits @
categoriesmyfaces
postedApr 15, '05 at 8:46p
activeApr 15, '05 at 8:46p
posts1
users1
websitemyfaces.apache.org

1 user in discussion

Schof: 1 post

People

Translate

site design / logo © 2019 Grokbase