Difference between revisions of "Dev:Source code"
From Synfig Studio :: Documentation
m (Text replace - '[[' to '{{l|') |
m |
||
(10 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
− | {{ | + | {{Title|Source code}} |
+ | {{Category|Code}} | ||
+ | {{Category|Permalink}} | ||
Hey you! Do you want access to bleeding-edge Synfig? Well, I have good news. We provide a way to get the code: | Hey you! Do you want access to bleeding-edge Synfig? Well, I have good news. We provide a way to get the code: | ||
*Using git (one repository) | *Using git (one repository) | ||
− | |||
− | Once you grab the code, you will need to follow the {{l|Build | + | Once you grab the code, you will need to follow the {{l|Dev:Build Instructions|build instructions}}. |
− | Commit notifications to master branch are sent to [http://cia.vc/stats/project/synfig CIA] and | + | Commit notifications to master branch are <strike>sent to [http://cia.vc/stats/project/synfig CIA] and</strike> shown up in the {{l|Contact|IRC channel}}. |
− | + | == GIT repository at Github== | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | == GIT repository at | + | |
Anonymous access: | Anonymous access: | ||
− | git clone git:// | + | git clone git://github.com/synfig/synfig.git |
People with commit access should use this command instead: | People with commit access should use this command instead: | ||
− | git clone | + | git clone git@github.com:synfig/synfig.git |
− | + | Or this one if you prefer https protocol: | |
− | + | git clone https://github.com/synfig/synfig.git | |
− | + | You can also check out the [https://github.com/synfig/synfig web interface] to that repository. | |
− | + | Check out [https://help.github.com Github help page] for further references. | |
− | + | ||
− | + | ||
− | + | ||
− | + | =Proposed git workflow= | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
* Consider the '''master''' branch the stable one. | * Consider the '''master''' branch the stable one. | ||
Line 69: | Line 38: | ||
* If it is possible, rebase & rework branches to keep history more sane, linear and atomic. | * If it is possible, rebase & rework branches to keep history more sane, linear and atomic. | ||
* Releases are tagged according to following criteria: | * Releases are tagged according to following criteria: | ||
− | ** If the release consist on a few trivial set of features or bug fixes then increase the third numeration level: 0. | + | ** If the release consist on a few trivial set of features or bug fixes then increase the third numeration level: 0.64.0 -> 0.64.1 |
− | ** If the release consist on a set of important features and/or includes non backward compatible file format, then increase the second level numeration: 0. | + | ** If the release consist on a set of important features and/or includes non backward compatible file format, then increase the second level numeration: 0.64.1 -> 0.65.0 |
+ | |||
+ | =See Also= | ||
+ | While you are browsing the code, you may wish to refer to these links: | ||
+ | |||
+ | * [http://www.synfig.org/issues/thebuggenie/synfig Bug tracker] | ||
+ | * [http://sourceforge.net/p/synfig/mailman/synfig-devl/ Synfig Dev mailing list] | ||
+ | ==Code overview== | ||
+ | * [http://download.tuxfamily.org/synfig/api/index.html API documentation] | ||
+ | * {{l|Dev:Source Outline|source code outline}} | ||
+ | * {{l|Dev:Source Glossary|source code glossary}} | ||
+ | * {{l|Dev:Layers|Mapping between layer types, classes and .cpp files}} | ||
+ | * {{l|Dev:class_ValueNode|ValueNode types}} | ||
+ | * {{l|Dev:BlendMethods|Blend Method enumeration values}} | ||
+ | ==Others== | ||
+ | * {{l|Dev:ETL_make_check|ETL make check failures}} | ||
+ | * {{l|Interesting Readings}} | ||
− | Proposed set of git repositories: | + | <!-- |
+ | Proposed set of git repositories (this section is outdated): | ||
* admin.git - gitosis admin settings - holds groups, repos and users | * admin.git - gitosis admin settings - holds groups, repos and users | ||
Line 89: | Line 75: | ||
* misc/* - various stuff needed | * misc/* - various stuff needed | ||
** misc/svn2git.git - the scripts used to convert the SVN repo to git | ** misc/svn2git.git - the scripts used to convert the SVN repo to git | ||
+ | --> |
Latest revision as of 17:55, 16 March 2017
Hey you! Do you want access to bleeding-edge Synfig? Well, I have good news. We provide a way to get the code:
- Using git (one repository)
Once you grab the code, you will need to follow the build instructions.
Commit notifications to master branch are sent to CIA and shown up in the IRC channel.
GIT repository at Github
Anonymous access:
git clone git://github.com/synfig/synfig.git
People with commit access should use this command instead:
git clone git@github.com:synfig/synfig.git
Or this one if you prefer https protocol:
git clone https://github.com/synfig/synfig.git
You can also check out the web interface to that repository.
Check out Github help page for further references.
Proposed git workflow
- Consider the master branch the stable one.
- Each coder should have a username_master branch where all the small changes are done.
- Once the username_master branch is considered stable it can be rebased/merged to master.
- Work on new non-trivial features/fixes on username_feature branches.
- Once the username_feature branch is considered stable it can be rebased/merged to master.
- Obviously commit trivial fixes straight to the master.
- If it is possible, rebase & rework branches to keep history more sane, linear and atomic.
- Releases are tagged according to following criteria:
- If the release consist on a few trivial set of features or bug fixes then increase the third numeration level: 0.64.0 -> 0.64.1
- If the release consist on a set of important features and/or includes non backward compatible file format, then increase the second level numeration: 0.64.1 -> 0.65.0
See Also
While you are browsing the code, you may wish to refer to these links:
Code overview
- API documentation
- source code outline
- source code glossary
- Mapping between layer types, classes and .cpp files
- ValueNode types
- Blend Method enumeration values
Others