for stable branch

git-svn-id: http://opensvn.csie.org/pttbbs/trunk/pttbbs@2365 63ad8ddf-47c3-0310-b6dd-a9e9d9715204

1 files changed, 39 insertions, 21 deletions

diff --git a/docs/INSTALL b/docs/INSTALL
index 51f3d6bc..cca79c4d 100644
--- a/docs/INSTALL
+++ b/docs/INSTALL
@@ -23,29 +23,42 @@ $Id$
 以下用 bbsadm 的身份
 ====================
 
- 7. 先切到所要放置源碼的目錄下 (一般在 /home/bbs) ,
-    您可以透過下列任一方式取得 pttbbs 的源碼:
-
-    1)至 ftp://ptt2.cc 抓得每日自動製作的 snapshot ,
-      通常檔名長的會像是 pttbbs-DATE-SNAP.tar.gz
-      再解開該檔即可: tar zxvf pttbbs-DATE-SNAP.tar.gz
-
-    2)直接抓取 http://OpenSVN.csie.org/pttbbs/trunk/pttbbs下的所有資料.
-      如 wget -r -np http://OpenSVN.csie.org/pttbbs/trunk/pttbbs
-
-    3)透過 subversion 聯繫 pttbbs version control repository
-      您必須先安裝 subversion (請參考官方網站 http://subversion.tigris.org/ )
-      在 FreeBSD底下, 直接使用 ports 安裝即可:
-      		cd /usr/ports/devel/subversion/; make all install
-      其他作業系統請參考 http://subversion.tigris.org/project_packages.html
-      或相關文件.
-
-      再執行 svn checkout http://OpenSVN.csie.org/pttbbs/trunk/pttbbs
-
-    其中不論您以方式 1或 3取得源碼, 您都可以在該目錄下直接透過 svn update
+ 7. 自從 2004/12開始,  PttBBS 分成兩個開發線, 您需要先決定要使用哪個版本:
+    a.置於 https://OpenSVN.csie.org/pttbbs/trunk/
+      這是目前主要開發的版本, 也是批踢踢實業坊和批踢踢兔兩個站台
+      所使用的版本. 在這個版本中含有最新的程式, 但是可能會不穩定,
+      有 bug, 甚至和之前的版本不相容. 除非您有很多時間, 有自己撰
+      寫以及修改程式的能力, 否則我們不建議您使用這個版本. 若您使
+      用這個版本, 請隨時注意在 telnet://ptt.cc的 PttCurrent 看板
+      的最新公告. 取得這個版本的方式:
+      a)至 ftp://ptt2.cc 抓得每日自動製作的 snapshot ,
+        通常檔名長的會像是 pttbbs-DATE-SNAP.tar.gz
+        再解開該檔即可: tar zxvf pttbbs-DATE-SNAP.tar.gz
+
+      b)直接抓取 http://OpenSVN.csie.org/pttbbs/trunk/pttbbs下的所有資料.
+        如 wget -r -np http://OpenSVN.csie.org/pttbbs/trunk/pttbbs
+
+      c)透過 subversion 聯繫 pttbbs version control repository(註4)
+        再執行 svn checkout http://OpenSVN.csie.org/pttbbs/trunk/pttbbs
+
+    b.置於 https://OpenSVN.csie.org/pttbbs/stable/
+      這是經過一陣子測試結果的程式, 我們大約每個月會將 trunk/ 的
+      程式整合進來一次, 這個版本相較於 trunk/ 會比較穩定. 同時,
+      如果程式有重大更新 (尤其是和之前版本不相容, 如檔案的結構修
+      改或是 SHM結構修改) 會明列於 UPDATING 這個檔案內. 您應該可
+      以每個月更新到 stable/的最新版本, 同時, 我們建議您在更新程
+      式碼後安裝前, 先閱讀 UPDATING 這個檔案.
+      取得這個版本的方式有:
+      d)直接抓取 http://OpenSVN.csie.org/pttbbs/stable/pttbbs下的所有資料.
+        如 wget -r -np http://OpenSVN.csie.org/pttbbs/stable/pttbbs
+
+      e)透過 subversion 聯繫 pttbbs version control repository(註4)
+        再執行 svn checkout http://OpenSVN.csie.org/pttbbs/stable/pttbbs
+
+    其中不論您以方式 a, c 或 e取得源碼, 您都可以在該目錄下直接透過 svn update
     更新至 pttbbs 最新的源碼. 如:
 	cd /home/bbs/pttbbs; svn update
-     (須先安裝 subversion)
+     (須先安裝 subversion, 見註4)
 
  8. 切換到 pttbbs 的目錄下 ( cd ~bbs/pttbbs )
  9. 如果您的 pttbbs.conf並不存在, 可以拷一份預設的來用:
@@ -121,3 +134,8 @@ $Id$
    請參考 docs/ADVANCE , 安裝好 bbsctl ,
    之後您就可以透過 bbsctl 直接在其他權限下 (如 bbsadm )
    來啟動可以 bind port 23 的 mbbsd.
+4. 您必須先安裝 subversion (請參考官方網站 http://subversion.tigris.org/ )
+   在 FreeBSD底下, 直接使用 ports 安裝即可:
+       cd /usr/ports/devel/subversion/; make all install
+   其他作業系統請參考 http://subversion.tigris.org/project_packages.html
+   或相關文件.