Rob Allen 22744dde7c Update copyright year to 2014. 12 éve
..
.svnignore 59ede1801c Creating 1.12 release branch 13 éve
ar 22744dde7c Update copyright year to 2014. 12 éve
bg 22744dde7c Update copyright year to 2014. 12 éve
cs 22744dde7c Update copyright year to 2014. 12 éve
de 22744dde7c Update copyright year to 2014. 12 éve
en 22744dde7c Update copyright year to 2014. 12 éve
es 22744dde7c Update copyright year to 2014. 12 éve
fa 22744dde7c Update copyright year to 2014. 12 éve
fr 22744dde7c Update copyright year to 2014. 12 éve
he 22744dde7c Update copyright year to 2014. 12 éve
hu 22744dde7c Update copyright year to 2014. 12 éve
id 22744dde7c Update copyright year to 2014. 12 éve
it 22744dde7c Update copyright year to 2014. 12 éve
ja 22744dde7c Update copyright year to 2014. 12 éve
ko 22744dde7c Update copyright year to 2014. 12 éve
nl 22744dde7c Update copyright year to 2014. 12 éve
pl 22744dde7c Update copyright year to 2014. 12 éve
pt-br 22744dde7c Update copyright year to 2014. 12 éve
ro 22744dde7c Update copyright year to 2014. 12 éve
ru 22744dde7c Update copyright year to 2014. 12 éve
sk 22744dde7c Update copyright year to 2014. 12 éve
sl 22744dde7c Update copyright year to 2014. 12 éve
sr 22744dde7c Update copyright year to 2014. 12 éve
tr 22744dde7c Update copyright year to 2014. 12 éve
uk 22744dde7c Update copyright year to 2014. 12 éve
zh 22744dde7c Update copyright year to 2014. 12 éve
Makefile 22744dde7c Update copyright year to 2014. 12 éve
README.txt 59ede1801c Creating 1.12 release branch 13 éve

README.txt

INTRODUCTION

The manual is written in Docbook XML and requires a Unix-like
operating system with the standard GNU toolchain and xsltproc
or a similar XSLT processor to build the source XML into the
HTML that is shipped with the Zend Framework distributions.

On Windows, you can compile the docbook using Cygwin. See:
http://www.cygwin.com



INSTALLATION FOR WINDOWS USERS

Installation steps for Cygwin:
1. Choose "Install from Internet", click [Next]
2. Choose the directory where you want to install Cygwin. Leave the other
options on their "RECOMMENDED" selection. Click [Next]
3. Select a directory where you want downloaded files to be stored. Click
[Next]
4. Select your way of connecting to the Internet. Click [Next]
5. Choose the most suitable mirror in the mirrorlist. Click [Next]
6. Select the following packages from Devel or Libs to install:
* automake1.9
* libxslt
* make
All dependent packages will automatically be selected for you.
Click [Next]
7. Sit back and relax while Cygwin and the selected packages are being
downloaded and installed. This may take a while.
8. Check the option "Create icon on Desktop" and "Add icon to Start Menu" to
your liking. Click [Finish].



BUILDING THE DOCUMENTATION (*NIX AND CYGWIN)

To build the documentation into HTML:
1. Go to a shell prompt, or Windows users will run Cygwin (you can double-click
the icon on the Desktop or in the Start menu if you've chosen any of these
options at install-time)
2. Navigate to the directory where the documentation files are stored using
the traditional Unix commands. For Cygwin users, drives are stored under
"/cygdrive". So if your documentation files are stored under
"c:\ZF\documentation", you'll need to run the command "cd c:/ZF/documentation/".
You're under a Unix environment, so don't forget all paths are case sensitive!
3. To compile the doc, go to the directory in which manual.xml is located and run:
$ autoconf
$ ./configure
$ make



TROUBLESHOOTING

If you're encountering errors while trying the build instructions above...
1. Remove all files from the html/ subdir except dbstyle.css

2. Remove all files from the root dir except manual.xml, configure.in,
Makefile.in and README. The important one here is entities.ent.

3. You can optionally remove the "/autom4te.cache" directory and the
"/build/docbook-xsl" directory

4. Try to build again following the instructions given above. If it still
throws errors, post a message to the fw-docs@lists.zend.com list.