Changes between Version 22 and Version 23 of pm-howdoi


Ignore:
Timestamp:
Feb 20, 2011 1:53:24 PM (9 years ago)
Author:
stefan
Comment:

minor changes in style

Legend:

Unmodified
Added
Removed
Modified
  • pm-howdoi

    v22 v23  
    77  1. The system requires a CSRO on file for everyone with write-access. Check to see if personY has a CSRO on file by looking at the [http://www.coin-or.org/management/contributors.html list of people with CSROs on file].  If personY is not on the list, ask personY to fill out the [http://www.coin-or.org/management/forms/csro.pdf CSRO form] and send it to secretary@coin-or.org. The secretary will update the web list.
    88  1. If personY just submitted an CSRO, their uid needs to be manually added to the file on the server of people with CSROs. (This file is how we automatically ensure only people with CSRO's on file are making commits to the repository). Currently, only Laci Ladanyi and Matthew Saltzman have permissions to edit this file. Send a request to Laci or Matt with the uid.
    9   1. Edit the [https://projects.coin-or.org/BuildTools/wiki/pm-svn-server#Configurationfiles "perms.txt" configuration file]
     9  1. Edit the [wiki:pm-svn-server#Configurationfiles "perms.txt" configuration file].
    1010
    11 == How do I update my project's .xml (e.g., http://www.coin-or.org/projects/Cgl.xml) ? ==
     11== How do I update my project's .xml file (e.g., http://www.coin-or.org/projects/Cgl.xml) ? ==
    1212A: You don't! It's automatic. You don't need to do anything other than commit the new stable/release version of your project. It works as follows:
    1313
    14   1. Your  Cgl/conf/projDesc.xml file is the same as the source code http://www.coin-or.org/projects/Cgl.xml (Cgl.xml is not generated it is just a copy of projDesc.xml) and this xml file is what the browser downloads.
     14  1. Your {{{Cgl/conf/projDesc.xml}}} file is the same as the source code http://www.coin-or.org/projects/Cgl.xml (Cgl.xml is not generated it is just a copy of projDesc.xml) and this xml file is what the browser downloads.
    1515  1. The browser also simultaneously downloads http://www.coin-or.org/projects/autoGen.xsl/
    16   1. The autoGen.xsl is code I wrote in XSLT - Exstensible Style Sheet Language Translation. The autoGen.xsl code is read by the browser. Modern browsers have XSLT engines that generates the html you actually view based on the xml file. 
    17   1. In the autoGen.xsl there is code that looks for your project name. Based on your program name it automatically downloads to the browser the png file http://www.coin-or.org/LatestRelease/Cgl-latest-stable.png . This file is updated daily on the COIN-OR server based on Laci's  scripts. Note: The project name needs to be the exact match for the project name so the png file can be found. For exmample, if the !CoinUtils.xml file filled out as
     16  1. The {{{autoGen.xsl}}} is code I wrote in XSLT - Extensible Style Sheet Language Translation. The {{{autoGen.xsl}}} code is read by the browser. Modern browsers have XSLT engines that generates the html you actually view based on the xml file. 
     17  1. In the {{{autoGen.xsl}}} there is code that looks for your project name. Based on your program name it automatically downloads to the browser the png file http://www.coin-or.org/LatestRelease/Cgl-latest-stable.png . This file is updated daily on the COIN-OR server based on Laci's  scripts. Note: The project name needs to be the exact match for the project name so the png file can be found. For example, if the {{{CoinUtils.xml}}} file filled out as
    1818{{{
    1919<projectName>COIN-OR Utilities</projectName>
    2020}}}
    21 this would cause a problem, becuase the "official" project name is "!CoinUtils" and !CoinUtils is what needs to be in the <projectName> tag.
     21this would cause a problem, because the "official" project name is "!CoinUtils" and {{{CoinUtils}}} is what needs to be in the {{{<projectName>}}} tag.
    2222
    23 == Does anyone have experience with building Coin with Eclipse CDT on Cygwin? ==
     23== Does anyone have experience with building COIN-OR with Eclipse CDT on Cygwin? ==
    2424A: Here is what I have done so far.  It is a long list, so I (kingaj) am writing it here.  Please feel free to edit:
    2525
    2626  1. Download and Install
    2727     a. Install Cygwin from http://www.cygwin.org.
    28         i. Obtain the fixed version of Cygwin make 3.81 to get past the "multiple targets" bug. See https://projects.coin-or.org/BuildTools/wiki/current-issues for this issue.
    29         i. Put the directory <cygwin_root>/bin into your Windows PATH environment variable.
     28        i. Obtain the fixed version of Cygwin make 3.81 to get past the "multiple targets" bug. See [wiki:current-issues the current issues page] for this.
     29        i. Put the directory {{{<cygwin_root>/bin}}} into your Windows PATH environment variable.
    3030     a. Install Eclipse IDE for C/C++ Developers from http://www.eclipse.org.
    3131  1. Set up Eclipse
     
    3535     a. Go through the "C/C++ Getting started" exercises, all the way through to "debugging".
    3636        i.  If you find that some Cygwin libraries or exe's are missing you may have to copy them to a location in your Windows PATH.
    37   1. Set up Coin
    38      a. Create the subversion repository (eg. https://projects.coin-or.org/svn/Smi) in the Subclipse view.
    39      a. Checkout your project (eg. trunk) as a "normal project" into a directory in your Eclipse workspace.
    40      a. Open a Cygwin window, cd to the checkout directory, and run configure/make/make test/make install as usual.
    41   1. Create a C++ Project for your library. 
     37  1. Set up COIN-OR
     38     a. Create the subversion repository (''e.g.'', https://projects.coin-or.org/svn/Smi) in the Subclipse view.
     39     a. Check out your project (''e.g.'', trunk) as a "normal project" into a directory in your Eclipse workspace.
     40     a. Open a Cygwin window, {{{cd}}} to the checkout directory, and run {{{configure/make/make test/make install}}} as usual.
     41  1. Create a C++ Project for your library.
    4242     a. Choose "Makefile Project".
    43      a. Uncheck "default location" and browse to the location of the project root (for example, trunk/Smi).
     43     a. Uncheck "default location" and browse to the location of the project root (''e.g.'', {{{trunk/Smi}}}).
    4444     a. Right click the project and create Make targets ("all" and "test" are good choices) and try to build.  This worked the first time for me (surprise!).
    4545  1. Create a C++ Project for an example.
    4646     a. Choose "Executable".  This will be a CDT "Managed Makefile" project. 
    47      a. Uncheck "default location" and browse to the location of the project root (for example, trunk/Smi/examples).
     47     a. Uncheck "default location" and browse to the location of the project root (''e.g.'', {{{trunk/Smi/examples}}}).
    4848     a. Right click the project and select "Properties->C/C++ Build->Settings". In here you can add includes for the C++ Compiler and libraries for the Linker.
    4949       i. If there are multiple main programs in this directory it will complain.  Just delete the ones you don't need for now.  In your next release you can reorganize your examples into subdirectories.
    5050
    51 A final note.  The CDT project perspective looks very good.  CDT has matured greatly since I last looked a few years ago, and it looks like it could be a fine replacement for MSVC++ for Coin development -- especially since now the CDT picks up all project information directly from Makefiles, so there is no need to maintain separate project files. 
     51A final note.  The CDT project perspective looks very good.  CDT has matured greatly since I last looked a few years ago, and it looks like it could be a fine replacement for MSVC++ for COIN-OR development -- especially since now the CDT picks up all project information directly from Makefiles, so there is no need to maintain separate project files. 
    5252
    5353== How do I build !CoinAll without rpaths? ==
    5454
    55  1. get rid of all -rpath occurrences in Makefile.am by running [https://projects.coin-or.org/svn/CoinBinary/rpm/trunk/noRpathsPatch.sh this script].
    56  1. re-run autotools [wiki:pm-comments with the right versions of automake, autoconf, and libtool.]
    57  1. configure with --prefix pointing to a standard place
     55 1. get rid of all {{{-rpath}}} occurrences in Makefile.am by running [https://projects.coin-or.org/svn/CoinBinary/rpm/trunk/noRpathsPatch.sh this script].
     56 1. re-run autotools [wiki:pm-get-autotools with the right versions of automake, autoconf, and libtool.]
     57 1. configure with {{{--prefix}}} pointing to a standard place
    5858 1. make
    5959 1. add all .libs with libraries in them to {{{LD_LIBRARY_PATH}}} so that tests have a chance. For example, from the !CoinAll base directory do:
     
    6767 1. make test
    6868 1. make install
    69