No commit message

CHANGELOG

@@ -0,0 +1,3 @@
+Version 1.0a October 1, 2008
+=============================
+Initial release

COPYRIGHT

@@ -0,0 +1,31 @@
+The Yii framework is free software. It is released under the terms of
+the following BSD License.
+
+Copyright 2008, Yii Software LLC (http://www.yiisoft.com)
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+- Redistributions of source code must retain the above copyright notice,
+this list of conditions and the following disclaimer.
+
+- Redistributions in binary form must reproduce the above copyright notice,
+this list of conditions and the following disclaimer in the documentation
+and/or other materials provided with the distribution.
+
+- Neither the name of Yii Software LLC nor the names of its contributors
+may be used to endorse or promote products derived from this software
+without specific prior written permission.
+
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

LICENSE

@@ -0,0 +1,31 @@
+The Yii framework is free software. It is released under the terms of
+the following BSD License.
+
+Copyright © 2008 by Yii Software LLC (http://www.yiisoft.com)
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+ * Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+ * Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in
+   the documentation and/or other materials provided with the
+   distribution.
+ * Neither the name of Yii Software LLC nor the names of its
+   contributors may be used to endorse or promote products derived
+   from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.

README

@@ -0,0 +1,61 @@
+
+             Yii Web Programming Framework
+             =============================
+
+Thank you for choosing Yii - a high-performance programming framework
+for developing Web applications in PHP 5.
+
+
+INSTALLATION
+------------
+Please make sure the release file is unpacked under a Web-accessible
+directory. You shall see the following files and directories:
+
+      framework/           containing the Yii framework source files
+      requirements/        containing the Yii requirement checker
+      CHANGELOG            describing changes in every Yii release
+      LICENSE              license of Yii
+      README               this file
+      UPGRADE              upgrading instructions
+
+
+REQUIREMENTS
+------------
+The minimum requirement by Yii is that your Web server supports
+PHP 5.2.1 or above. Yii has been tested with Apache HTTP server
+on Windows and Linux operating systems.
+
+Please access the following URL to check if your Web server reaches
+the requirements by Yii, assuming "YiiPath" is where Yii is installed:
+
+      http://hostname/YiiPath/requirements/index.php
+
+
+QUICK START
+-----------
+Yii comes with a command line tool called "yiic" that can create
+a skeleton Yii application for you to start with.
+
+On command line, type in the following commands:
+
+        $ cd YiiPath/framework                (Linux)
+        cd YiiPath\framework                  (Windows)
+
+        $ ./yiic webapp ../testdrive          (Linux)
+        yiic webapp ..\testdrive              (Windows)
+
+The new Yii application will be created at "YiiPath/testdrive".
+You can access it with the following URL:
+
+        http://hostname/YiiPath/testdrive/index.php
+
+
+WHAT's NEXT
+-----------
+Please visit the project website for tutorials, class reference
+and join discussions with other Yii users.
+
+
+
+The Yii Team
+http://www.yiiframework.com

UPGRADE

@@ -0,0 +1,14 @@
+
+         Upgrading Instructions for Yii Framework v1.0a
+         ==============================================
+
+!!!IMPORTANT!!!
+
+The following upgrading instructions are cumulative. That is,
+if you want to upgrade from version A to version C and there is
+version B between A and C, you need to following the instructions
+for both A and B.
+
+
+Upgrading from v1.0a
+--------------------

build/build

@@ -0,0 +1,21 @@
+#!/usr/bin/env php
+<?php
+/**
+ * build script file.
+ *
+ * This is a command line script that provides various commands
+ * for building an Yii release.
+ *
+ * @author Qiang Xue <[email protected]>
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright &copy; 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ * @version $Id$
+ */
+
+defined('YII_DEBUG') or define('YII_DEBUG',true);
+
+$root=dirname(__FILE__);
+require_once($root.'/../framework/yii.php');
+$config=array('basePath'=>$root);
+Yii::createConsoleApplication($config)->run();

build/build.bat

@@ -0,0 +1,23 @@
+@echo off
+
+rem -------------------------------------------------------------
+rem  build script for Windows.
+rem
+rem  This is the bootstrap script for running build on Windows.
+rem
+rem  @author Qiang Xue <[email protected]>
+rem  @link http://www.yiiframework.com/
+rem  @copyright Copyright &copy; 2008 Yii Software LLC
+rem  @license http://www.yiiframework.com/license/
+rem  @version $Id$
+rem -------------------------------------------------------------
+
+@setlocal
+
+set BUILD_PATH=%~dp0
+
+if "%PHP_COMMAND%" == "" set PHP_COMMAND=php.exe
+
+%PHP_COMMAND% "%BUILD_PATH%build" %*
+
+@endlocal

build/build.xml

@@ -0,0 +1,157 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+/**
+ * Phing build file for Yii.
+ *
+ * @author Qiang Xue <[email protected]>
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright &copy; 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ * @version $Id$
+ */
+-->
+<project name="yii" basedir="." default="help">
+  <!-- task definitions -->
+  <taskdef name="yii-init-build" classname="YiiInitTask" classpath="tasks" />
+
+  <!-- init yii.version, yii.revision and yii.winbuild -->
+  <yii-init-build />
+
+  <!-- these are required external commands -->
+  <property name="php" value="php" /> <!-- PHP parser -->
+  <property name="hhc" value="hhc" /> <!-- compile phpdoc into CHM -->
+  <property name="pdflatex" value="pdflatex" />  <!-- generates PDF from LaTex -->
+  <property name="zip" value="zip" />  <!-- zip compression -->
+
+  <property name="pkgname" value="${phing.project.name}-${yii.version}.r${yii.revision}"/>
+  <property name="docname" value="${phing.project.name}-docs-${yii.version}.r${yii.revision}"/>
+
+  <!-- directory definitions -->
+  <property name="build.base.dir" value="release"/>
+  <property name="build.dist.dir" value="${build.base.dir}/dist"/>
+  <property name="build.src.dir" value="${build.base.dir}/${pkgname}"/>
+  <property name="build.doc.dir" value="${build.base.dir}/${docname}"/>
+  <property name="build.web.dir" value="${build.base.dir}/web"/>
+
+  <!-- source files in the framework -->
+  <fileset dir=".." id="framework">
+    <exclude name="**/.svn"/>
+    <exclude name="**/*.bak"/>
+    <exclude name="**/*~"/>
+    <include name="framework/**/*"/>
+    <include name="requirements/*"/>
+    <include name="COPYRIGHT"/>
+    <include name="CHANGELOG"/>
+    <include name="UPGRADE"/>
+    <include name="LICENSE"/>
+    <include name="README"/>
+  </fileset>
+
+  <target name="build" depends="prebuild">
+    <echo>Building package ${pkgname}...</echo>
+    <echo>Copying files to build directory...</echo>
+    <copy todir="${build.src.dir}">
+      <fileset refid="framework"/>
+    </copy>
+  </target>
+
+  <target name="docs" depends="prebuild">
+    <echo>Building documentation...</echo>
+
+    <echo>Building API...</echo>
+    <mkdir dir="${build.doc.dir}" />
+    <exec command="build api ${build.doc.dir}" dir="." passthru="true" />
+
+    <echo>Building API CHM...</echo>
+    <exec command="${hhc} ${build.doc.dir}/api/manual.hhp" />
+    <move file="${build.doc.dir}/api/manual.chm" tofile="${build.doc.dir}/yii-api-${yii.version}.chm" />
+    <delete>
+      <fileset dir="${build.doc.dir}/api">
+        <include name="manual.*" />
+      </fileset>
+    </delete>
+  </target>
+
+  <target name="web" depends="prebuild">
+    <echo>Building online API...</echo>
+    <mkdir dir="${build.web.dir}/views/doc" />
+    <mkdir dir="${build.web.dir}/controllers/doc" />
+    <exec command="build api ${build.web.dir}/views/doc online" dir="." passthru="true" />
+    <move file="${build.web.dir}/views/doc/apiKeywords.txt" tofile="${build.web.dir}/controllers/doc/apiKeywords.txt" />
+  </target>
+
+  <target name="prebuild">
+    <echo>Preparing build ${pkgname}...</echo>
+
+    <echo>Building autoload map...</echo>
+    <exec command="build autoload" dir="." passthru="true"/>
+
+    <echo>Building yiilite.php...</echo>
+    <exec command="build lite" dir="." passthru="true"/>
+  </target>
+
+  <target name="rebuild" depends="clean,build">
+  </target>
+
+  <target name="dist" depends="clean,build,docs,web">
+    <echo>Generating release distributions...</echo>
+    <mkdir dir="${build.dist.dir}" />
+    <tar destfile="${build.dist.dir}/${pkgname}.tar.gz" compression="gzip">
+      <fileset dir="${build.base.dir}">
+        <include name="${pkgname}/**/*"/>
+      </fileset>
+    </tar>
+    <tar destfile="${build.dist.dir}/web.tar.gz" compression="gzip">
+      <fileset dir="${build.base.dir}">
+        <include name="web/**/*"/>
+      </fileset>
+    </tar>
+    <tar destfile="${build.dist.dir}/${docname}.tar.gz" compression="gzip">
+      <fileset dir="${build.base.dir}">
+        <include name="${docname}/**/*"/>
+      </fileset>
+    </tar>
+    <zip destfile="${build.dist.dir}/${pkgname}.zip">
+      <fileset dir="${build.base.dir}">
+        <include name="${pkgname}/**/*"/>
+      </fileset>
+    </zip>
+    <zip destfile="${build.dist.dir}/web.zip">
+      <fileset dir="${build.base.dir}">
+        <include name="web/**/*"/>
+      </fileset>
+    </zip>
+    <zip destfile="${build.dist.dir}/${docname}.zip">
+      <fileset dir="${build.base.dir}">
+        <include name="${docname}/**/*"/>
+      </fileset>
+    </zip>
+  </target>
+
+  <target name="clean">
+    <echo>Cleaning up the build...</echo>
+    <delete dir="${build.base.dir}"/>
+  </target>
+
+  <target name="help">
+    <echo>
+
+    Welcome to use Yii build script!
+    --------------------------------
+    You may use the following command format to build a target:
+
+              phing   &lt;target name&gt;
+
+    where &lt;target name&gt; can be one of the following:
+
+    - dist     : create a release;
+    - build    : prepare a directory for distribution;
+    - clean    : clean up the build directory;
+    - rebuild  : clean first and then build;
+    - docs     : generate documentation;
+    - pear     : generate PEAR packages;
+    - snapshot : generate nightly snapshot;
+
+    </echo>
+  </target>
+</project>