History of bitweaverCVS

Differences from version 56 to 67



@@ -1,208 +1,120 @@

-Our CVS is hosted at [http://cvs.sourceforge.net/viewcvs.py/bitweaver/|SourceForge]
-
-Check out our groovy [/cvs|CVS Stats]
-
 {maketoc}
 
-!CVS Introduction
-An introduction to CVS use on SourceForge is [http://sourceforge.net/docman/display_doc.php?docid=14033&group_id=1|Basic Introduction to CVS and SourceForge.net Project CVS Services].
-Information on usage of SourceForge CVS is in Section F of the [http://sourceforge.net/docman/?group_id=1|SourceForge Docs] page.
+Our CVS is hosted at Sourceforge. Usage information is in Section F of their [http://sourceforge.net/docman/?group_id=1|documentation page]. If you like, take a look at our [/cvs|groovy stats]. And now, ++yellow: how Bitweaver CVS is organized:++
 
-!Setting up Tortoise
-# right click on your desktop (or your html root directory) and select
-+ ++yellow:CVS checkout...++
-# in the CVSROOT line, type:
-+ ++yellow::pserver:anonymous@cvs.sf.net:/cvsroot/bitweaver++
-# in the Module line, type:
-+ ++yellow:bitweaver++ (or the module you want to get)
-# select the appropriate revision from the corresponding tab. this will usually be R plus the appropriate release version. e.g.:
-+ ++yellow:R1++
+Our CVS tree has one ++yellow: module++ for each package. However, a virtual module is use to create three primary distributions: __bitweaver__, __bitweaverdev__ and __bitweavercore__. Every ((Roadmap|bitweaver release)) has a CVS ++yellow: branch++ named after it. The branch is created ''after'' we have gone into schema freeze for the project. For details on __how to get code__ (checkout modules, branches, packages) please refer to ((GetCode|this page: GetCode)).
 
-!How is the ))bitweaverCVS(( organized
 
-!!Modules
-Our CVS tree has a cvs module for each package. However, a virtual CVS module is use to create our two primary distributions: __bitweaver__, __bitweaverdev__ and __bitweavercore__. Every ((bitweaverRoadMap|bitweaver release)) has a CVS branch named after it. The branch is create AFTER we have gone into schema freeze for the project.
+! CVS Modules
 
-!!!CVS Modules
-;bitweaver:Release material. these are the packages that are ready for general distribution.
-;bitweaverdev:all bitweaver packages that are currently available in CVS. contains dangerously explosive stuff and some packages are in serious flux and are not considered ready for general consumption. gives you an idea of what great stuff is going to be available in the near future!
-;bitweavercore:contains all core modules without any clutter. basically the minimum required to get a fully working version of bitweaver without any additional functionality.
+!! Main modules
+* __bitweaver__ - release material. These are the packages that are ready for general distribution.
+* __bitweaverdev__ - all bitweaver packages that are currently available in CVS. Contains dangerously explosive stuff. Some packages are in serious flux and are not considered ready for general consumption. Gives you an idea of what great stuff is going to be available in the near future!
+* __bitweavercore__ - contains all core modules without any clutter. Basically the minimum required to get a fully working version of bitweaver without any additional functionality.
+* __packages__ - packages that were developed specifically for bitweaver are prepended with _bit_. For instance, the wiki package is called ))_bit_wiki(( in cvs. Third party applications such as [http://www.phpbb.com/|phpBB] are only prepended with an underscore, so to check out phpBB you check out _phpbb.
 
-!!!CVS Branches
-;R#:R1 is equivalent to Release 1 and symbolises a stable release branch that will not undergo any API changes or database schema changes.
-;HEAD:No guarantees for stability provided. might break at any time and no real support provided. please only use this if you are a developer and know what you are doing.
+!! Other modules
+*__ _adodb__ - the latest import and merge of the adodb library supported by bitweaver
+*__ _smarty__ - the latest import and merge of the smarty library supported by bitweaver
 
-to get a reliable list of all available modules and things that are available in CVS, please check out CVSROOT and view the modules file. there you can find the various modules and what virtual modules we have available and what exaclty they contain.
+To get a reliable list of all available modules and things that are available in CVS, please check out CVSROOT and view the modules file. There you can find the various modules and what virtual modules we have available and what exaclty they contain. To get the latest and greatest code from cvs HEAD, don't use any tags at all. For details, please refer to ((GetCode|this page: GetCode)).
 
-To get code for ReleaseOne, you want to check out the code from Sourceforge.
-__Developer Access:__ If you are you a [http://sourceforge.net/project/memberlist.php?group_id=101599|member of the bitweaver project] then you should (~~#FF0000:NOTE!!~~ __Make sure__ you "export CVS_RSH=ssh" in your /etc/profile or CVS shell first):
-{code in="Bash"} cvs -d :ext:yourusername@cvs.sf.net:/cvsroot/bitweaver co -r R1 bitweaver{code}
-__General Access:__ If not, you can get anonymous access. Note this method users a mirrored CVS and has a 24+ code delay with the :ext: method indicated above.
-{code in="Bash"} cvs -d :pserver:anonymous@cvs.sf.net:/cvsroot/bitweaver co -r R1 bitweaver{code}
 
+! CVS Branches
+* __R#__ - R1 is equivalent to Release 1 and symbolises a stable release branch that will not undergo any API changes or database schema changes.
+* __ HEAD__ - no guarantees for stability provided. Might break at any time. There's no official support for this branch (still, you're welcome to ((ConnectingToIrc|join us on IRC)) if you have questions). Use this branch only if you are a developer.
 
-To get the latest and greatest code from cvs HEAD ( currently ReleaseTwo ), don't use any tags at all:
-{code in="Bash"} cvs -d :ext:yourusername@cvs.sf.net:/cvsroot/bitweaver co bitweaver {code}
+(__NOTE__: As of 2007-11-19, HEAD is considered stable as we have released ReleaseTwo, but have not yet created an R2 branch)
 
+As discussed in ((ReleaseProcess)) there are three active branches in CVS: STABLE, TESTING, and DEVELOPMENT. See ((ReleaseProcess)) for which branch is currently in which state.
 
-!!Other modules:
-
-_adodb - the latest import and merge of the adodb library supported by bitweaver
-_smarty - the latest import and merge of the smarty library supported by bitweaver
-
-!Branches
-As discussed in ((ReleaseProcess)) there are three active branches in cvs: STABLE, TESTING, and DEVELOPMENT. See ((ReleaseProcess)) for which branch is currently in which state.
-
-!!Development/HEAD
-DEVELOPMENT is the cvs trunk also known as HEAD.
-Fixes in STABLE get merged into TESTING as needed.
-Fixes in TESTING, including those from STABLE, get merged into HEAD as needed.
-Several tags are maintained on DEVELOPMENT, TESTING, and STABLE to manage the merge process. In general you should simple checkout the latest version of the brach you are working on. See ((ReleaseProcess)) for what should be done where.
+!! Development/HEAD
+DEVELOPMENT is the CVS trunk also known as HEAD. Fixes in STABLE get merged into TESTING as needed. Fixes in TESTING, including those from STABLE, get merged into HEAD as needed. Several tags are maintained on DEVELOPMENT, TESTING, and STABLE to manage the merge process. In general you should simple checkout the latest version of the brach you are working on. See ((ReleaseProcess)) for what should be done where.
 
 Format:
 *Branch - Comment
 **Tag - Comment
 **Tag - Comment
 
-!!HEAD - Current Mainline
+!! HEAD - Current Mainline
 This is the leading edge of development.
 
 !! ReleaseOne R1
-This is the version running on serveral sites and is considered stable. no database changes are made to this version and we try and maintain a stable environment.
+This is the version running on serveral sites and is considered stable. No database changes are made to this version and we try and maintain a stable environment.
 
-!! Version Merging
-^How merge to HEAD is done:
-__In R1/bitweaver directory:__
-cvs update -dP
-cvs tag -cF R1_NEXTMERGE
-__In merge/HEAD directory:__
-cvs -d :ext:btodoroff@cvs.sourceforge.net:/cvsroot/bitweaver co bitweaver
-cd bitweaver
-cvs update -j R1_LASTMERGE -j R1_NEXTMERGE
-cvs commit -m "Merge recent changes from R1 into HEAD"
-cd ..
-rm -rf bitweaver
-__Back in R1/bitweaver directory:__
-cvs tag -r R1_NEXTMERGE -F R1_LASTMERGE
-^
 
-__NOTE__ about [https://www.cvshome.org/docs/manual/cvs-1.11.20/cvs_5.html#SEC64|the -kk option]: There is one major caveat with using `-kk' on merges. Namely, it overrides whatever keyword expansion mode CVS would normally have used. In particular, this is a problem if the mode had been `-kb' for a binary file. Therefore, if your repository contains binary files, you will need to deal with the conflicts rather than using `-kk'
+! Notes
 
+!! Checkout bitweaver code
+Pleaser refer to ((GetCode|this page: GetCode)).
 
-!!! Merging using Meld
-make sure you have Meld installed:
-Fedora Core: # yum -y install meld
 
-and then get R1 and HEAD into seperate directories:
-cvs -d :ext:btodoroff@cvs.sourceforge.net:/cvsroot/bitweaver co -d biteaver_R1 -r R1 bitweaver
-cvs -d :ext:btodoroff@cvs.sourceforge.net:/cvsroot/bitweaver co -d biteaver_HEAD bitweaver
+!! Adding a package to R#
+{code format="bash"}
+ cvs rtag -b R# <package>
+ e.g.: cvs rtag -b R1 _bit_calendar
+{/code}
 
-open meld, activate the CVS text filter in the preferences window, click on the __new__ icon and select the 2 dirs:
-in the ''compare directories'' tab select bitweaver_R1 as the __Mine__ directory and the bitweaver_HEAD directory as the __Original__ directory.
+!! Including 3rd party code in CVS
+Please refer to ((UsingLibrariesInCVS)). There you find an example (adoDB) for including 3rd party code in CVS.
 
-merge the two, and commit to CVS
+!! Importing new packages into CVS Modules
+If you you are reworking a module from or ((Features Boneyard)) to be included in bitweaver, you are importing a new package into CVS Modules:
+# delete all ''CVS'' directories from the package.
+# __cd__ into the package directory you wish to import
+# import the package: {CODE}$ cvs -qz5 -d:ext:bitweaver@bitweaver.cvs.sf.net:/cvsroot/bitweaver import -m'IMPORT TikiPro CLYDE FINAL' _bit_sample BITWEAVER HEAD{/CODE}
+# add the module and alias to CVSROOT/modules and append to modules alias __bitweaverdev__
 
-i don't think any tags are needed in CVS if this method is used, but i might be mistaken.
+!! Changing branch for specific CVS modules
+If you move a package from HEAD into release module, you need to change branch for a specific CVS module:
+# modify CVSROOT/modules that the package is in the release module __bitweaver__
+# __cd__ to the module for which you want to change the branch tag
+# cvs tag -R -b <branch>
+# cvs up -r <branch>
+# cvs commit
+# to make sure it worked, you can remove the package dir and checkout the package again:
+# optional: cvs co -r <branch> <cvs module>
 
 
-^How a release branch is created
-__In <Release> directory:__
+!! How a release branch is created
+{code source=bash title="In <Release> directory:"}
 cvs -d:ext:..... co bitweaver
-__In <Release>/bitweaver directory:__
+{/code}
+{code source=bash title="In <Release>/bitweaver directory:"}
 cvs update -dP
 cvs rtag -b -D <Today's Date Plus 1 Year: YYYY-MM-DD> <Release> bitweaver
 cvs rtag -r <Release> <Release>_LASTMERGE bitweaver
-^
+{/code}
 
 
+!! Version Merging
 
-!!Including 3rd party code in CVS
-Is this the same stuff from ((UsingLibrariesInCVS))? - wolff_borg
-^How merge to HEAD is done:
+!!! How merge to HEAD is done
 
-Let's say we want to import the excellent database abstraction layer
-ADOdb version 4.60 into our CVS repository:
+{code format=bash title="In R1/bitweaver directory" num=true}
+cvs update -dP
+cvs tag -cF R1_NEXTMERGE
+{/code}
 
-{code in="Bash"}
-$ wget http://phplens.com/lens/dl/adodb360.tgz
-$ tar xvzf adodb360.tgz
-$ rm adodb360.tgz
-$ cd adodb
-$ cvs import -m 'Imported ADOdb 4.60' _adodb PHPLENS_COM R4_60
-$ cd ..
-$ rm -fr adodb
-{code}
+{code format=bash title="In merge/HEAD directory:" num=true}
+cvs -d :ext:btodoroff@bitweaver.cvs.sourceforge.net:/cvsroot/bitweaver co bitweaver
+cd bitweaver
+cvs update -j R1_LASTMERGE -j R1_NEXTMERGE
+cvs commit -m "Merge recent changes from R1 into HEAD"
+cd ..
+rm -rf bitweaver
+__Back in R1/bitweaver directory:__
+cvs tag -r R1_NEXTMERGE -F R1_LASTMERGE
+{/code}
 
-Now, we're going to check it out from CVS and fix a bug we found:
-
-{code in="Bash"}
-$ cvs checkout _adodb
-$ cd _adodb
-...hack, chop, whittle...
-$ cvs commit -m "Fixed bug #12345: Replace doesn't use native REPLACE command, if available"
-$ cd ..
-$ rm -fr _adodb
-{code}
+__NOTE__ about [https://www.cvshome.org/docs/manual/cvs-1.11.20/cvs_5.html#SEC64|the -kk option]: There is one major caveat with using `-kk' on merges. Namely, it overrides whatever keyword expansion mode CVS would normally have used. In particular, this is a problem if the mode had been `-kb' for a binary file. Therefore, if your repository contains binary files, you will need to deal with the conflicts rather than using `-kk'
 
-Now, we want to upgrade to version 4.62:
 
-{code in="Bash"}
-$ wget http://phplens.com/lens/dl/adodb462.tgz
-$ tar xvzf adodb462.tgz
-$ rm adodb462.tgz
-$ cd adodb
-$ cvs import -m 'Imported ADOdb 4.62' _adodb PHPLENS_COM R4_62
-{code}
-
-This command completed successfully, but reported the following:
-
-1 conflicts created by this import.
-Use the following command to help the merge:
-
-{code in="Bash"}
-cvs checkout -j -jR4_62 _adodb
-{code}
-
-So, let's delete the imported directory:
-{code in="Bash"}
-$ cd ..
-$ rm -fr adodb
-{code}
-And checkout as instructed above.
-
-{code in="Bash"}
-$ cvs checkout -jR4_60 -jR4_62 _adodb
-{code}
-
-Manually resolve any conflicts that were reported.
-
-Now, let's commit our 4.60 changes into 4.62:
-
-{code in="Bash"}
-$ cvs commit -m 'Merged our 4.60 changes into 4.62'
-{code}
-
-And finally remove our directory:
-
-{code in="Bash"}
-$ rm -fr _adodb
-{code}
-
-(Source: http://tikiwiki.org/tiki-index.php?page=UsingLibrariesInCVS)
-^
-!Importing New Packages into CVS Modules
-# If you are importing a module from TikiPro, firstly delete all ''CVS'' directories from the package.
-# __cd__ into the package directory you wish to import.
-# Use the following to import the package {CODE()}$ cvs -qz5 -d:ext:bitweaver@cvs.sf.net:/cvsroot/bitweaver import -m'IMPORT TikiPro CLYDE FINAL' _bit_sample BITWEAVER HEAD{CODE}
-# Add the module and alias to CVSROOT/modules and append to modules alias __bitweaverdev__
-
-!Changing Branch for specific CVS modules
-needed to move a package from HEAD into release module.
-# modify CVSROOT/modules that the package is in the release module __bitweaver__
-# cd to the module for which you want to change the branch tag
-# cvs tag -R -b <branch>
-# cvs up -r <branch>
-# cvs commit
-# to make sure it worked, you can remove the package dir and checkout the package again:
-## cvs co -r <branch> <cvs module>
+!!! Merging using Meld
+Make sure you have Meld installed: __Fedora Core: # yum -y install meld__ and then get R1 and HEAD into seperate directories:
 
+{CODE format=bash}
+cvs -d :ext:<username>@bitweaver.cvs.sourceforge.net:/cvsroot/bitweaver co -d biteaver_R1 -r R1 bitweaver
+cvs -d :ext:<username>@bitweaver.cvs.sourceforge.net:/cvsroot/bitweaver co -d biteaver_HEAD bitweaver
+{/CODE}
+Open meld, activate the CVS text filter in the preferences window, click on the __new__ icon and select the 2 dirs: in the ''compare directories'' tab select bitweaver_R1 as the __Mine__ directory and the bitweaver_HEAD directory as the __Original__ directory. Merge the two, and commit to CVS. I don't think any tags are needed in CVS if this method is used, but i might be mistaken.
Page History
Date/CommentUserIPVersion
26 Mar 2008 (15:37 UTC)
spiderr66.194.217.22167
Current • Source
spiderr69.134.148.4065
View • Compare • Difference • Source
Jerry Russell66.25.205.23264
View • Compare • Difference • Source
laetzer217.83.93.21163
View • Compare • Difference • Source
xing81.223.107.22361
View • Compare • Difference • Source
dspt217.21.50.16760
View • Compare • Difference • Source
xing194.152.164.4559
View • Compare • Difference • Source
xing194.152.164.4558
View • Compare • Difference • Source
xing194.152.164.4557
View • Compare • Difference • Source
xing194.152.164.4556
View • Compare • Difference • Source
xing194.152.164.4555
View • Compare • Difference • Source
Stephan Borg218.214.1.11354
View • Compare • Difference • Source
xing194.152.164.4553
View • Compare • Difference • Source
xing194.152.164.4552
View • Compare • Difference • Source
Stephan Borg218.214.1.11351
View • Compare • Difference • Source
xing194.152.164.4549
View • Compare • Difference • Source
laetzer84.191.93.21948
View • Compare • Difference • Source
Stephan Borg218.214.1.11347
View • Compare • Difference • Source
Stephan Borg218.214.1.11346
View • Compare • Difference • Source
spiderr68.125.207.11345
View • Compare • Difference • Source
spiderr66.93.240.20444
View • Compare • Difference • Source
spiderr66.93.240.20443
View • Compare • Difference • Source
spiderr66.93.240.20442
View • Compare • Difference • Source
spiderr66.93.240.20440
View • Compare • Difference • Source
spiderr66.93.240.20439
View • Compare • Difference • Source
spiderr66.93.240.20438
View • Compare • Difference • Source