*** IMPORTANT CHANGE ***

BRC v3, supporting local modification
THINK TWICE BEFORE YOU APPLY TO YOUR SYSTEM.

BRC v3 will double size of BRC v2.
BRC v3 can allow notifying changes of comment (recommend) system
BRC v3 may cause more syscall activities than v2


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

1 files changed, 17 insertions, 2 deletions

diff --git a/docs/brc.txt b/docs/brc.txt
index 315a1fbc..d64f7918 100644
--- a/docs/brc.txt
+++ b/docs/brc.txt
@@ -1,6 +1,7 @@
  
-        BRC documentation by scw      08/05/2003
+        BRC (v2) documentation by scw   08/05/2003
 					06/12/2007 revised by kcwu
+					12/02/2007 v3 by piaip
  
 源起：
      這篇文章主要是介紹 brc_* 的函式，這組函式是 pttbbs 用來紀錄文章已讀/未讀
@@ -43,8 +44,22 @@ BRC 是什麼？如何運作？
  個人看的板太多，讓 .brc2 大小超過 BRC_MAXSIZE 有些板的紀錄就會不見（ 24576
  bytes 最少可以存 73 個板的資料，這還是用全部板 brc_num 都是 80 計算的）。但這
  三個小缺點影響應該不大吧？
+
+v3 說明
+
+     Dec 2007 開始 ptt brc 引入 v3 格式，與前板不相容。所謂的 v3 是由於 BBS
+ 「推文」系統被濫用而產生的需求。推文的形式是在原文後附加新的一行文，但舊
+ BRC 系統無法分辨此類更動；若想讓人分辨是否有新推文各家作法不一，常見的是比
+ 照 edit_post 把檔案改名。這種方式除了效率不彰外，還有並非每個人都想看新推文
+ 的問題。
+     考量許久後，從 BRC 下手還是正解。 在每個 BRC 記錄上多新增一個 modified
+ time 即可。 此方法可同時適用於分離檔案與原文附加的推文系統。代價是 BRC 大小
+ 加倍成長，不過這似乎不是什麼大問題。
+     由於 v2 v3 實際差異並不大，這裡的說明保留以 v2 為主。 麻煩自己查 svn
+ 就知道 v3 改了哪邊了。
+
  
-BRC 實作
+BRC v2 實作
  
  interface: (in proto.h)