Quote: "No, I do not, sadly.
I followed the links and could not download the SVN.
Please assist me with this...
(Oh, yeah... Happy St. Paddy's Day! )"
1) GET SOURCEFORGE ACCOUNT
The DarkGDK Open Source Project uses SVN (subversion) http://subversion.tigris.org/ version control system hosted by
http://sourceforge.net to keep track of all work and all changes to Project Files. It allows Contributors to collaborate File updates with greater ease. A SourceForge Username & Password will be required to use SVN. If you don't already have a SourceForge Account it can be obtained
https://sourceforge.net/account/registration/. Once you're registered on SourceForge, provide me your SourceForge username so I can add it to the project list here -->
https://sourceforge.net/project/admin/project_membership.php?group_id=276067
SVN Basics:
There are two parts to SVN:
SVN Server - to store and share files over the internet. It tracks
updates to files and who working on them. It sends files and tracking info to Clients.
SVN Client - you install on your local computer to communicate with
SVN Server, storing files in a Windows Directory and displaying the
status of the files based on Tracking info.
There are two SVN Client main operations:
Update - this means download the files from the server, and replace
any files you did NOT modify with the newer ones from the server.
Commit - this uploads any files you DID modify since your last
commit to the server, so everyone else can download the new files.
Note: Every time someone commits something new or modified, the
revision number goes up. This means you can always know how up to date your files are, from what revision they are at compared to that on the server.
You can view SVN files online via SourceForge
http://darkgdkosp.svn.sourceforge.net/viewvc/darkgdkosp/ To communicate with the SVN Server you will need a SVN Client. TortoiseSVN and AnkhSVN (optional) come highly recommended, but, you can also use your own.
TortoiseSVN Setup
1. Download tortoiseSVN from
http://tortoisesvn.net/ , for free.
2. Install it.
3. Create DOSP Directory and [Right Click]. (DOSP SVN Directory Structure is aligned to that of the Dark GDK Directory)
4. You should now see an option "SVN Checkout"
5a. In "URL of repository", paste this: [img]https://darkgdkosp.svn.sourceforge.net/svnroot/darkgdkosp [/img]. In "Checkout directory", paste the path of the Dark GDK directory. Example: C:\Program Files\The Game Creators\DOSP
6. You are done!
For anyone who wants to use your own client, here is what you need:
svn co https://darkgdkosp.svn.sourceforge.net/svnroot/darkgdkosp
How to use TortoiseSVN:
Warning: It is highly recommended that Contributors, [Right Click]
and choose SVN Update in the root SVN Directory before starting any
work.
SVN will add and update matching files. The "Projects" Directory
contains the VC++ Project Trio: S3GE (Engine), S3GEd (Editor), &
S3GW (Super 3D Game World: The Game). All associated Libs, Includes, Media etc for the project, etc are filed in the
applicable directories.
Project Directories
In a effort to 1) Reorganize the project in a more intuitive fashion; 2) Stablize Open Source distribution via SVN for all contributors; 3) Minimize Version conflicts. For self-containment, the DOSP contains its own version of DGDK and other 3rd Party Libraries. The Project File structure is based on the Directory
Structure recommendations from the Core Team Members.
0. DOSP – Root Directory
1. Documentation – 3rd Party Libraries, Plugins, and Tool
Documentation.
2. Include – 3rd Party C++ Header and Source Files. All #include
directives use relative paths to locate header files.
3. Lib – 3rd Party Static Library Files. All Libs are stored in a
single directory. VC++ IDE requires you specify the absolute path
for *.libs on your local PC in order to properly locate the Lib Directories for DOSP. To achieve this, you may need to add a entry with VC++ IDE: Tools ? Options... ? Project and Solutions ? VC++ Directories ? Show directories for: Library files ? [Absolute Path
of DOSP]\DOSP\Lib\vs9
Note: Due to this requirement, Contributors will have to manually add this entry. This may appear simple enough, but, it can cause
conflicts if other Entries use same root directory because VC++ will search these directories based on order.
4. Dll – 3rd Party Dynamic Link Libraries.
5. Projects – DOSP Projects. In this stage of development, the
project is compiled in debug mode and should generate object and executable files in Projects\S3GE\S3GE\Debug\
Note: The Debug/Release Directories represents the Root Directory
for S3GE.exe and associated files. To ensure DOSP compiles and run
from VC++ with Debugging make the following entry: S3GE
Properties ? Configuration Properties ? Debugging ? Working
Directory ? $(TargetDir)
6. Tools – Utility Executable(s).
7. Content – S3GE Application/Game Media, Data, and Logic Files.The
Content Directory (currently located in the Debug Folder)
represents an Application/Game's cached content {media, auxiliary
data, markup & script} files for use by S3GE. This directory contains the cached Content Files for Application / Game. Note: S3GE Host Server will provide a centralized repository for all Content Files downloaded S3GE upon requirement.
You can create Directories and Files like you normally do. A
question mark ? overlays their icons. A Directory with this ? means
that the Directory itself or some files within it have not been
Added for commitment to SVN Server. Files with the ? have not been
added. You will need to Add these directories & files in order to
commit them to the SVN Server for everyone else to see. In some
cases, you may not want to commit the directory/file to this SVN
Server, leaving it in this state is harmless but its recommended
that it be added to the ignore list (see details below).
To Add Directories and Files, [Right Click] and select TortoiseSVN ? Add. You can select one more directories and files to
add at once. Warning: Tortoise will only display file extensions without names, thus its tricky to know what files are being added.
I'm not sure if this is bug or a setting I failed to turned on.
Once files have been Added, a plus sign + overlays the icon. If you
modify files a exclamation mark ! overlays the icon. Both icons
mean the directory/file are ready to be committed. To commit,
[Right Click] anywhere in the view and select SVN Commit to update
the SVN server. When you commit changes please a short log message
so people know what has been committed. This is in the top box
when you commit. You will also be prompted for a username and password, this is you sourceforge username and password.
There will be local and Directories/Files that you don't desire to
commit to SVN server. To omit these Directories/Files highlight them and [Right Click], select TortoiseSVN ? Add to Ignore List.
