lab1.php

   1 <?php
   2 include "8440head.php";
   3 ?>
   4
   5
   6
   7 <center>
   8 <h1>
   9 <font color="#931515" size="+3">COMP8440: Lab1 - building a2ps</font>
  10 </h1>
  11 </center>
  12
  13 <h2>Lab Setup</h2>
  14
  15 As this is the first lab, you should carefully read
  16 the <a href="labsetup.php">Lab Setup</a> page and follow all the
  17 instructions on that page to get the FOSSD environment installed and
  18 running.
  19
  20 <p>Next, if you have not already done so, you should join
  21 the <a href="http://fossd.anu.edu.au/cgi-bin/mailman/listinfo">comp8440
  22 mailing list</a> using your ANU student email account. Note that you
  23 will need to be able to receive email to that account while in the
  24 lab. You will find that the email icon in the main menu bar of your
  25 lab system should be already setup for accessing your ANU mail
  26 account.<p>
  27
  28 <p>When you first join the list, please send a very short email to the
  29 list to make sure it is working.
  30
  31
  32 <h2>Investigating a2ps</h2>
  33
  34 The aim of this lab is to build and install the 'anything to
  35 postscript' a2ps project. The a2ps project has been chosen as it
  36 provides an illustration of the many of the types of problems you are
  37 likely to run into with your own project.<p>
  38
  39 During this lab we will be spending quite a lot of time running
  40 through the various steps below on the projector, while you follow
  41 along on your own system. If you run into trouble on your own system,
  42 then we will be able to display your screen on the projector, so we
  43 can work through the solution for the benefit of all the students.<p>
  44
  45 The lab has a number of parts:
  46
  47 <ul>
  48 <li>Investigate the project
  49   <ul>
  50   <li>Who wrote it?
  51   <li>Who supports it?
  52   <li>Where would you submit a bug report?
  53   <li>Where would you get help?
  54   <li>How do you get the source code?
  55   <li>How active is development?
  56   </ul>
  57 <li>Download the source code
  58 <li>Build and install it
  59 </ul>
  60
  61 <h2>Downloading the code</h2>
  62
  63 The source code for a2ps can be downloaded in several different ways,
  64 each of which leads to a different level of difficulty in building the
  65 project.<p>
  66
  67 If you have time in this lab, try to download and build via all 3 of
  68 the following mechanisms:
  69
  70 <ul>
  71 <li>Using the apt package manager
  72 <li>Using a release tarball
  73 <li>using a source code management system
  74 </ul>
  75
  76 You should now carefully read the <a href="building.php">build
  77 tips</a> page for instructions on each of these approaches.<p>
  78
  79 What are the advantages and disadvantages of each approach?
  80
  81 <h2>Testing a2ps</h2>
  82
  83 As the name suggests, a2ps can take ASCII text files and produce
  84 postscript. Try creating a file called 'test.txt' then run this:
  85
  86 <pre><b>
  87    a2ps -o test.ps test.txt
  88    gv test.ps
  89 </b></pre>
  90
  91 That should show you a postscript version of your text file.
  92
  93 <h2>SCM Tips</h2>
  94
  95 You may find some of the tips on the <a href="scm-tips.php">SCM
  96 Tips</a> page useful for this lab.
  97
  98 <h1>MAKE SURE YOU BACKUP</h1>
  99
 100 Make sure you do a backup at the end of the lab, or you may lose all
 101 your work.
 102
 103
 104 <p><div align="center">
 105   <?php
 106     print " Last modified: ";
 107     $last_modified = getlastmod();
 108     print(date("j/m/Y, H:i", $last_modified));
 109   ?>
 110 </div><p>
 111
 112 <?php
 113 include "8440tail.php";
 114 ?>
 115
 116
 117