LON-CAPA Software Developer Instructions

  1. Using CVS
  2. Viewing the software (make HTML)
  3. Compiling the software (make build)
  4. Adding/removing files from the LON-CAPA installation (doc/loncapafiles/loncapafiles.html)
  5. Configurable files versus non-configurable files
  6. Updating the non-configurable files on your machine (make install)
  7. Updating the configurable files on your machine (make configinstall)
  8. Building RPMs (make RPM)
  1. Using CVS

  2. Viewing the software (make HTML)

    Commands
    cd loncom/build
    rm -Rf HTML
    make HTML
    cd HTML
    (look at the index.html file with a web browser such as Netscape)
    
    General description of what happens

    This is the actual make target code.

    
    HTML:
            install -d HTML
            cp ../../doc/loncapafiles/*.gif HTML
            perl parse.pl ../../doc/loncapafiles/loncapafiles.html HTML > HTML/index.html
    
    
    What basically happens is that specially marked-up data in the LON-CAPA cvs repository file doc/loncapafiles.html is parsed into a more viewable format by loncom/build/parse.pl. The resulting file gives a very well organized view of all the files, directories, links, ownerships, permissions, and brief documentation of what each file does.

  3. Compiling the software (make build)

  4. Adding/removing files from the LON-CAPA installation (doc/loncapafiles/loncapafiles.html)

  5. Configurable files versus non-configurable files

  6. Updating the non-configurable files on your machine (make install)

  7. Updating the configurable files on your machine (make configinstall)

  8. Building RPMs (make RPM)