Lab2 now includes example code for diff and diffstat commands to create and work...
[tridge/comp8440.git] / 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 can be setup for accessing your ANU mail account.<p>
26
27 <p>When you first join the list, please send a very short email to the
28 list to make sure it is working.
29
30
31 <h2>Investigating a2ps</h2>
32
33 The aim of this lab is to build and install the 'anything to
34 postscript' a2ps project. The a2ps project has been chosen as it
35 provides an illustration of many of the types of problems you are
36 likely to run into with your own project.<p>
37
38 During this lab we will be spending quite a lot of time running
39 through the various steps below on the projector, while you follow
40 along on your own system. If you run into trouble on your own system,
41 then we will be able to display your screen on the projector, so we
42 can work through the solution for the benefit of all the students.<p>
43
44 The lab has a number of parts:
45
46 <ul>
47 <li>Investigate the project
48   <ul>
49   <li>Who wrote it?
50   <li>Who supports it?
51   <li>Where would you submit a bug report?
52   <li>Where would you get help?
53   <li>How do you get the source code?
54   <li>How active is development?
55   </ul>
56 <li>Download the source code
57 <li>Build and install it
58 </ul>
59
60 <h2>Downloading the code</h2>
61
62 The source code for a2ps can be downloaded in several different ways,
63 each of which leads to a different level of difficulty in building the
64 project.<p>
65
66 If you have time in this lab, try to download and build via all 3 of
67 the following mechanisms:
68
69 <ul>
70 <li>Using the apt package manager
71 <li>Using a release tarball
72 <li>using a source code management system
73 </ul>
74
75 You should now carefully read the <a href="building.php">build
76 tips</a> page for instructions on each of these approaches.<p>
77
78 What are the advantages and disadvantages of each approach?
79
80 <h2>Testing a2ps</h2>
81
82 As the name suggests, a2ps can take ASCII text files and produce
83 postscript. Try creating a file called 'test.txt' then run this:
84
85 <pre><b>
86    a2ps -o test.ps test.txt
87    evince test.ps  
88 </b></pre>
89
90 That should show you a postscript version of your text file.
91
92 <h2>Source Code Management (SCM) Tips</h2>
93
94 You may find some of the tips on the <a href="scm-tips.php">SCM
95 Tips</a> page useful for this lab.
96
97 <h1>MAKE SURE YOU BACKUP</h1>
98
99 Make sure you do a backup at the end of the lab, or you may lose all
100 your work.
101
102
103 <p><div align="center">
104   <?php
105     print " Last modified: ";
106     $last_modified = getlastmod();
107     print(date("j/m/Y, H:i", $last_modified));
108   ?>
109 </div><p>
110
111 <?php
112 include "8440tail.php";
113 ?>
114
115
116