Information For Project Managers

The information behind the links below is mostly intended for people working on COIN-OR projects, i.e., project managers as well as contributors.
Users should follow the links on the main wiki page.

The information on this page corresponds to BuildTools 0.7. To see how the wiki looked into the good old days of BuildTools 0.5, look into the wiki history or the ​0.5 wiki pages.

Managing Project Versions and Dependencies and the COIN-OR Server

1. Understanding Subversion
2. Handling Subversion Externals
   1. Basics
   2. Externals in COIN-OR
   3. Important Considerations For Externals
   4. Manipulating Externals
   5. Preparing Externals For A Point Release
3. Suggestions for Handling Stable Versions and Releases
   1. Overview
   2. What to Tell Users
   3. Setting up your Repository
   4. Working with Stable Versions
   5. Working With Point Releases
4. COIN-OR Server Automated Procedures and Configuration
   1. Automatic creation of source and documentation archives and …
   2. Configuration files
   3. Creating and maintaining the static webpages of a project
   4. Scripts and Logs

Using the Autotools In COIN-OR

1. Working With the GNU Autotools
   1. Introduction
   2. The configure.ac Files
   3. The Makefile.am Files
   4. Running the Autotools
   5. Which Files Should be in the Subversion Repository?
   6. Working On Your Project
2. Autotools Basics
   1. autoconf
   2. automake
   3. libtool
3. Basic Structure of the configure.ac File
   1. General Concepts
   2. Beginning of a configure.ac file
   3. The Body of the configure.ac File
   4. The End of the configure.ac File
4. The Package Base Directory configure.ac File
5. The Project Directory configure.ac File
   1. Initialization of Tools and Compilers
   2. Check for other COIN-OR Components
   3. Checks for some specific System Libraries
   4. Check for User Libraries
   5. Generation of Links for Data Files
   6. Project Specific Tests
6. Configuration Header Files
   1. Private and public header files
   2. Header files for non-autotools setups
   3. Bringing them all together
   4. Example
7. Introduction of Automake Concepts
8. The Package Base Directory Makefile.am File
9. The Project Main Directory Makefile.am File
10. The Source Directories Makefile.am Files
    1. Beginning of the Makefile.am File
    2. Building a Library
    3. Building a Program
    4. Additional Flags
    5. Installation of Header Files
11. The Test Directory Makefile.am File
    1. Beginning of the File
    2. Compilation of the Unit Test Program
    3. The Test Target
    4. House Cleaning
12. The pkg-config configuration files of a project
    1. Introduction
    2. The .pc file of an installed COIN-OR project library
    3. The .pc file of an uninstalled COIN-OR project library
    4. The NO pkg-config case
13. Using the Correct Version of the Autotools
14. Brief Tutorial on Switching from BuildTools 0.5 to 0.7
    1. What Needs to be Edited
    2. Externals to Dependencies
    3. Changes to Installation Directories
    4. Changes to autotools files
    5. Changes to configuration header files
15. Hints, tricks, bugs, and suggestions
    1. Using autoreconf

Project Documentation

1. Using Doxygen in COIN-OR
   1. Setting Up
   2. Building and Installing Documentation

How Do I ... ?

Please add your questions (even if you don't have the answers [yet])!

1. How do I (projectManagerX) give svn write access to someone (personY)?
2. How do I update my project's .xml file (e.g., …
3. Does anyone have experience with building COIN-OR with Eclipse CDT on …
4. How do I build CoinAll without rpaths?

More Information

If you have questions or problems related to the usage of subversion and the Autotools, please submit a Ticket to the BuildTools project, using the "New Ticket" link on top of this page (after ​logging in).

---

Note that these project webpages are based on Wiki, which allows webusers to modify the content to correct typos, add information, or share their experience and tips with other users. You are welcome to contribute to these project webpages. To edit these pages or submit a ticket you must first ​register and login.