| 1 | .TH PICKUP 1 "October 25, 1990" |
|---|
| 2 | .SH NAME |
|---|
| 3 | pickup \- retrieve graded assignment files |
|---|
| 4 | .SH SYNOPSIS |
|---|
| 5 | pickup [ options ] [ +n ] [ -n ] [ assignment ] [ filename ... ] |
|---|
| 6 | .SH DESCRIPTION |
|---|
| 7 | This is a student command in the Educational On-Line System. It will |
|---|
| 8 | retrieve files from the file exchange for the appropriate course and |
|---|
| 9 | assignment. Some courses may choose not to return graded assignments |
|---|
| 10 | electronically; ask your TA how to get graded assignments for your |
|---|
| 11 | course. |
|---|
| 12 | |
|---|
| 13 | Arguments are parsed in the order they appear on the command line. A |
|---|
| 14 | plus sign followed by a number |
|---|
| 15 | .B n |
|---|
| 16 | means only pick up files at least |
|---|
| 17 | .B n |
|---|
| 18 | days old. A minus sign followed by a number |
|---|
| 19 | .B n |
|---|
| 20 | means only pick up files |
|---|
| 21 | at most |
|---|
| 22 | .B n |
|---|
| 23 | days old. These may be combined to specify a range. |
|---|
| 24 | |
|---|
| 25 | A hyphen followed by a letter is an option. The first argument that |
|---|
| 26 | starts with a digit is an assignment number. You may retrieve files |
|---|
| 27 | for all assignments by leaving out the assignment number. Any other |
|---|
| 28 | argument is a filename. If no filenames are specified on the command |
|---|
| 29 | line, all students' files will be retrieved. The file exchange server |
|---|
| 30 | marks files as PICKEDUP. |
|---|
| 31 | |
|---|
| 32 | .SH OPTIONS |
|---|
| 33 | All options are recognized by their first letter. For example, |
|---|
| 34 | -course is usually abbreviated -c, but -class or -co would also be |
|---|
| 35 | recognized, because each starts with the letter c. |
|---|
| 36 | |
|---|
| 37 | Only the most commonly-used options are listed here. See fxoptions(1) |
|---|
| 38 | for a complete list of options. |
|---|
| 39 | .TP |
|---|
| 40 | .B -course <course name> |
|---|
| 41 | Overrides the environmental variable COURSE. Files will be retrieved |
|---|
| 42 | for this course until the end of the command line or until another -c |
|---|
| 43 | option is found. |
|---|
| 44 | .TP |
|---|
| 45 | .B -list |
|---|
| 46 | Only list the files; do not retrieve them. |
|---|
| 47 | .TP |
|---|
| 48 | .B -preserve |
|---|
| 49 | Will not mark files as PICKEDUP after copying them. This is the |
|---|
| 50 | default if -e or -h is used. |
|---|
| 51 | .TP |
|---|
| 52 | .B -dest <directory> |
|---|
| 53 | Files are to be placed in the named directory rather than the current |
|---|
| 54 | working directory. |
|---|
| 55 | .TP |
|---|
| 56 | .B -quiet |
|---|
| 57 | Turns off printing of status information. |
|---|
| 58 | .TP |
|---|
| 59 | .B -verbose |
|---|
| 60 | Turns on printing of status information. This is the default. |
|---|
| 61 | .SH "ENVIRONMENT" |
|---|
| 62 | .TP |
|---|
| 63 | .B COURSE |
|---|
| 64 | Specify the default course file exchange. |
|---|
| 65 | .TP |
|---|
| 66 | .B FXPATH |
|---|
| 67 | Specify a colon-separated list of hosts to try as file-exchange |
|---|
| 68 | servers, overriding information in hesiod. |
|---|
| 69 | .SH "NOTES" |
|---|
| 70 | .PP |
|---|
| 71 | |
|---|
| 72 | It is advisable to make the destination directory be an empty |
|---|
| 73 | directory. |
|---|
| 74 | |
|---|
| 75 | File modify times are set to be the time the file was returned. |
|---|
| 76 | .SH SEE ALSO |
|---|
| 77 | turnin(1), collect(1), return(1), fxoptions(1) |
|---|
| 78 | .SH AUTHOR |
|---|
| 79 | Bruce R. Lewis (brlewis@ATHENA.MIT.EDU) |
|---|
