D 2012-05-11T19:11:36.708 L Getting\sStarted\swith\sWoof P 4324f146e4d99f1fb1d5a0aa29be0bc80f534bc4 U BarryK W 4403 Woof2 is hosted in a Fossil Version Control System repository, which is what you are looking at now. Fossil is a remarkably simple system to use. The entire Woof repository, that is, the entire Woof project, is in a single file. Basically, to get started, you download that file and then extract the Woof files from it.
# fossil clone --admin-user MrSmith http://bkhome.org/fossil/woof2.cgi woof2.fossilStep 4: Very important, Fossil v1.20 has a "bug", does not inherit some needed properties from the online Fossil repository, you have to manually turn them on...
# ln -s defaultbrowser /usr/local/bin/firefox (if no Firefox installed) # fossil ui woof2.fossil...go to 'Admin/Settings' and tick "allow-symlinks" checkbox. Also, the default applications are not inherited. In the 'editor' box type "defaulttexteditor", in 'web-browser' box type "defaultbrowser". Then click "Apply Changes" button. Close web browser, ctrl-c to kill "fossil ui" Step 5: Checkout the Woof project files...
# mkdir woof2 # cd woof2 # fossil open ../woof2.fossilYou can leave it open, you don't have to run "fossil close". That is, you will never have to run that "fossil open ../woof2.fossil" ever again.
woofproject woof2And you have a terminal open inside 'woof2'. You then run this script to create a working project:
# ./merge2outThis will create a working directory that is configured for the Puppy that you wish to build. For example, if you are running on an x86 PC, and want to build a Puppy for ARM architecture, based on Ubuntu Lucid binary packages, you would get a new working directory 'woof-out_x86_arm_ubuntu_lucid':
woofproject woof2 woof-out_x86_arm_ubuntu_lucidYou open a terminal window in 'woof-out_x86_arm_ubuntu_lucid' and off you go, and build your pup. There is a README in the working directory also.
# fossil update # ./merge2outThis will download the latest changes to Woof and update your local Woof repository. The second 'merge2out' step is to update your working directory. However, you might want to think carefully before executing 'merge2out', as it will over-write all of the Woof files in your working directory. You may have changed some files, such as (using 'woof-out_x86_arm_ubuntu_lucid' as the example): DISTRO_SPECS, DISTRO_PKGS_SPECS-ubuntu-lucid, Packages-puppy-lucid-official. You might want to copy those somewhere else first. You then copy them back in after having run 'merge2out'. Or, if you have modified many things and not sure what to backup, you could do it like this:
# fossil update # mv ../woof-out_x86_arm_ubuntu_lucid ../woof-out_x86_arm_ubuntu_lucid-BACKUP1 # ./merge2out...this will create a brand-new 'woof-out_x86_arm_ubuntu_lucid' directory, then you can copy in anything from the old directory as needed. If you need any more explanation about updating, 01micko, the coordinator of Slacko Puppy, has a tutorial on this topic: [http://www.smokey01.com/01micko/woof2/fossil-update.html] Z 67bd712b94f54ddb343036f9238fdbbc