Difference between revisions of "Source code"

From CrawlWiki
Jump to: navigation, search
(link to current release)
(Updated for GitHub)
Line 1: Line 1:
The '''source code''' for [[Crawl]] is the complete set of programming instructions and data that are compiled into a playable game. Unlike most commercial programs, ''Crawl'' is released under an open source license, meaning the source code is freely accessible by anyone. Crawl is written in [http://en.wikipedia.org/wiki/C%2B%2B C++].
+
The '''source code''' for [[Crawl]] is the complete set of programming instructions and data that are compiled into a playable game. Unlike most commercial programs, ''Crawl'' is released under an open source license, meaning the source code is freely accessible by anyone. Crawl is written in [http://en.wikipedia.org/wiki/C%2B%2B C++].
  
Crawl is actively in development, with new code changes being introduced daily. [[Trunk]] is the version of the code containing the latest changes. Periodically these changes are gathered up into a [[Current release|release version]] which has been tested to minimize bugs and other problems.
+
Crawl is actively in development, with new code changes being introduced daily. [[Trunk]] is the version of the code containing the latest changes. Periodically these changes are gathered up into a [[Current release|release version]] which has been tested to minimize bugs and other problems.
  
The Crawl source code can be accessed at [http://gitorious.org/crawl/ http://gitorious.org/crawl/]; a more accessible (and searchable) mirror of the source is at [http://git.develz.org/?p=crawl.git;a=summary http://git.develz.org/?p=crawl.git;a=summary]. The default view is of [[trunk]]; to view source code from prior release versions, visit [http://git.develz.org/?p=crawl.git;a=tags http://git.develz.org/?p=crawl.git;a=tags], click on "commit" next to the version you want, then "tree".
+
The Crawl source code can be accessed at [http://github.com/crawl/crawl http://github.com/crawl/crawl]. The default view is of [[trunk]]; to view source code from prior release versions, click on the dropdown that says "branch: master", choose "tags," and then select the version you want.
  
To search through the code, make sure you are viewing the entire tree (or at least the /source subdirectory), and select "grep" in the dropdown box. The search is case-sensitive: "kiku" will return different results from "KIKU".
+
To search through the code, type a search term in the box at the top of the page. Note that search is case-insensitive and only searches the trunk version.
  
Prospective developers should read [https://crawl.develz.org/wiki/doku.php?id=dcss:help:start the introductory pages on the Crawl dev wiki]. The [http://gitorious.org/crawl/crawl/blobs/master/crawl-ref/docs/develop/patch_guide.txt patch guide] is also a good introduction to getting your feet wet. Others may simply enjoy source diving to tease out many of the game's secrets.
+
Prospective developers should read [https://crawl.develz.org/wiki/doku.php?id=dcss:help:start the introductory pages on the Crawl dev wiki]. The [https://github.com/crawl/crawl/blob/master/crawl-ref/docs/develop/patch_guide.txt patch guide] is also a good introduction to getting your feet wet. Others may simply enjoy source diving to tease out many of the game's secrets.
  
 
==Source diving==
 
==Source diving==
"Source diving" is the act of reading/searching through the source code of a program. Source diving is usually done when someone wants to know how something really works in the game. Source divers may also program their own [[patch]]es to the game.
+
"Source diving" is the act of reading/searching through the source code of a program. Source diving is usually done when someone wants to know how something really works in the game. Source divers may also program their own [[patch]]es to the game.
  
Even those who do not understand C++ may be able to do source diving to discover Easter eggs or interesting comments in the source, or to look up basic data or text (such in-game flavour messages).
+
Even those who do not understand C++ may be able to source dive to discover Easter eggs or interesting comments in the source, or to look up basic data or text (such in-game flavour messages).
  
 
[[Category:Crawl]]
 
[[Category:Crawl]]

Revision as of 22:16, 29 April 2015

The source code for Crawl is the complete set of programming instructions and data that are compiled into a playable game. Unlike most commercial programs, Crawl is released under an open source license, meaning the source code is freely accessible by anyone. Crawl is written in C++.

Crawl is actively in development, with new code changes being introduced daily. Trunk is the version of the code containing the latest changes. Periodically these changes are gathered up into a release version which has been tested to minimize bugs and other problems.

The Crawl source code can be accessed at http://github.com/crawl/crawl. The default view is of trunk; to view source code from prior release versions, click on the dropdown that says "branch: master", choose "tags," and then select the version you want.

To search through the code, type a search term in the box at the top of the page. Note that search is case-insensitive and only searches the trunk version.

Prospective developers should read the introductory pages on the Crawl dev wiki. The patch guide is also a good introduction to getting your feet wet. Others may simply enjoy source diving to tease out many of the game's secrets.

Source diving

"Source diving" is the act of reading/searching through the source code of a program. Source diving is usually done when someone wants to know how something really works in the game. Source divers may also program their own patches to the game.

Even those who do not understand C++ may be able to source dive to discover Easter eggs or interesting comments in the source, or to look up basic data or text (such in-game flavour messages).