Check out projects: Difference between revisions
No edit summary |
|||
| Line 17: | Line 17: | ||
Please do not waste space and retain only the files you need. When you are done with your account please be sure to delete it. | Please do not waste space and retain only the files you need. When you are done with your account please be sure to delete it. | ||
== Building a Project on Linux == | == Building a Project on Linux == | ||
| Line 28: | Line 29: | ||
Continuing the wrist project example from above, you would type: | Continuing the wrist project example from above, you would type: | ||
> cd /map/gfx0/users/ | > cd /map/gfx0/users/$USER/project/wrist | ||
> make all | > make all | ||
| Line 34: | Line 35: | ||
== Building a Project on Windows == | == Building a Project on Windows == | ||
The wrist project does not build on Windows. Instead we'll show how to build | The wrist project does not build on Windows. Instead we'll show how to build some of the common libraries. Your sandbox should be set up with the contents of the '''common/''' directory so you will not need to check anything else out. The following examples use the native Windows command shell '''"cmd.exe"'''. | ||
The '''common/utility/''' directory has some utilities used in several projects. Libraries are often configured to build on all available compilers. This way when you go to use a library a version is available for whatever compiler you choose. | |||
<pre> | <pre> | ||
> cd/d Y:\map\gfx0\users\ | > cd/d Y:\map\gfx0\users\<User Id>\common\utility | ||
> make all | > make all | ||
> make install | |||
</pre> | </pre> | ||
By convention simple projects that build a single program or library can be built just by typing "make". | By convention simple projects that build a single program or library can be built just by typing "make". | ||
Revision as of 13:47, 21 April 2010
Checking out a project
Before checking out a project, be sure that your development environment is set up for $G.
$G uses CVS for source control and you can read more about it on its official site or on Wikipedia.
After you have your Sandbox set up you can checkout a project. Even if you are working on Windows you should use Linux to perform CVS operations. Many projects will only build on certain platforms.
Project code will either be in the common/ or project/ top level CVS directories. The common/ directory has code that is shared by multiple projects in the project/ directory.
If you wanted to check out the "wrist" project, you would type:
> cd /map/gfx0/users/$USER # Go into your Sandbox. > cvs co project/wrist # Creates: /map/gfx0/users/goo/project/wrist/...
Please do not waste space and retain only the files you need. When you are done with your account please be sure to delete it.
Building a Project on Linux
Before a project can be built any dependent packages need to be in the import/ directory. The wrist project depends on Blitz.
> cp -R /map/gfx0/tools/linux/import/blitz/ /map/gfx0/users/$USER/import/blitz/
The wrist project is a large project composed of several programs and libraries. It follows the convention of using a Makefile in the top level directory to build the entire project. Each project developer decides how their projects are organized and how they are built. You'll need to look at documentation for a project to determine how to build it.
Continuing the wrist project example from above, you would type:
> cd /map/gfx0/users/$USER/project/wrist > make all
Building a Project on Windows
The wrist project does not build on Windows. Instead we'll show how to build some of the common libraries. Your sandbox should be set up with the contents of the common/ directory so you will not need to check anything else out. The following examples use the native Windows command shell "cmd.exe".
The common/utility/ directory has some utilities used in several projects. Libraries are often configured to build on all available compilers. This way when you go to use a library a version is available for whatever compiler you choose.
> cd/d Y:\map\gfx0\users\<User Id>\common\utility > make all > make install
By convention simple projects that build a single program or library can be built just by typing "make".