Suppose that you've just finished working on a programming assignment for a computer science class. You now need to submit something to your instructor, so that she can grade the assignment.
If she happened to be with you (say, in the lab), you do the following steps:
Before going any further, note that you only do this when you are ready to submit something for grading. You should not do this while your are developing the program. Moreover, photo does not deal well with graphics, and so you should never run any commands (such as emacs) that produce graphics while you're within a photo session.
So here's what you do, in more detail.
A photo session is already in progress. Use "exit" to stop it.then you are most likely already in the middle of a photo session. You should type ``exit'', which will terminate same.
You now have a file named typescript, which contains a transcript of your photo session. Unfortunately, the typescript file contains a lot of strange control characters, which you will want to supress. This task is handled by the photo-clean program, which takes one command line parameter (the name of the file that needs the cleanup). The output of photo-clean (i.e., the contents of the cleaned-up version of your transcript file) goes to standard output, which means that you'll probably want to redirect the output to a new file. If your login shell is tcsh (this is almost everybody), then issue the command
photo-clean typescript >! proj4.out(this assumes that you're doing Project 4 and that you want the name of the clean version of typescript to reflect same). If you are one of the few people whose login shell is bash, then the command should be
photo-clean typescript >| proj4.outThe greater-than sign means ``output direction''; the extra character (either an exclamation mark or a vertical bar) means that if a file named proj4.out exists, it should be overwritten. Of course if you really wanted the file proj4.out to stick around, you should use a different file name for the redirection.
The next step is simple, but often omitted: look at the cleaned-up transcript. Make sure that its contents are what you expect. (The most common errors are for the cleaned-up transcript to be empty, or to be the transcript of a previous session.)
Finally, you should submit the clean typescript. You can do one of two things:
enscript -2r proj4.out
mail -s "Project 4" -r firstname.lastname@example.org email@example.com < proj4.outwill do the trick. (The -r flag makes it easier for your instructor to send an acknowledgement message.) If this mail command produces no output, then everything is probably okay. However, if it produces a warning message, then you should pay attention to what the what the warning is trying to tell you. The most common case is
Null message body; hope that's okThis means that you sent your instructor an empty file. You should investigate why the file is empty, fix the problem, and try again.