| 1 | .TH RETURN 1 "October 25, 1990" |
|---|
| 2 | .SH NAME |
|---|
| 3 | return \- return graded files |
|---|
| 4 | .SH SYNOPSIS |
|---|
| 5 | return [ options ] [ +n ] [ -n ] [ assignment ] [ student ... ] |
|---|
| 6 | .SH DESCRIPTION |
|---|
| 7 | This is a grader command in the Educational On-Line System. It will |
|---|
| 8 | send graded files to the file exchange for the appropriate course, |
|---|
| 9 | assignment and student. The student may then use pickup(1) to pick |
|---|
| 10 | them up. |
|---|
| 11 | |
|---|
| 12 | Arguments are parsed in the order they appear on the command line. A |
|---|
| 13 | plus sign followed by a number |
|---|
| 14 | .B n |
|---|
| 15 | means only return files at least |
|---|
| 16 | .B n |
|---|
| 17 | days old. A minus sign followed by a number |
|---|
| 18 | .B n |
|---|
| 19 | means only return files |
|---|
| 20 | at most |
|---|
| 21 | .B n |
|---|
| 22 | days old. These may be combined to specify a range. |
|---|
| 23 | |
|---|
| 24 | An argument that starts with a hyphen is an option. The first |
|---|
| 25 | argument that starts with a digit is an assignment number. You may |
|---|
| 26 | return files for all assignments by leaving out the assignment number. |
|---|
| 27 | Any other argument is a username. If no usernames are specified on |
|---|
| 28 | the command line, all students' files will be returned. |
|---|
| 29 | |
|---|
| 30 | .B Return |
|---|
| 31 | does not remove the local files which collect placed in the |
|---|
| 32 | destination directory. The collected copies of the files may be |
|---|
| 33 | removed with delete(1) or rm(1) if no longer needed. |
|---|
| 34 | |
|---|
| 35 | .SH OPTIONS |
|---|
| 36 | All options are recognized by their first letter. For example, |
|---|
| 37 | -course is usually abbreviated -c, but -class or -co would also be |
|---|
| 38 | recognized, because each starts with the letter c. |
|---|
| 39 | |
|---|
| 40 | Only the most commonly-used options are listed here. See fxoptions(1) |
|---|
| 41 | for a complete list of options. |
|---|
| 42 | .TP |
|---|
| 43 | .B -course <course name> |
|---|
| 44 | Overrides the environmental variable COURSE. Files will be returned |
|---|
| 45 | for this course until the end of the command line or until another -c |
|---|
| 46 | option is found. |
|---|
| 47 | .TP |
|---|
| 48 | .B -list |
|---|
| 49 | Only list the files; do not return them. |
|---|
| 50 | .TP |
|---|
| 51 | .B -quiet |
|---|
| 52 | Turns off printing of status information. |
|---|
| 53 | .TP |
|---|
| 54 | .B -dest <directory> |
|---|
| 55 | This should be the same directory as that given to collect(1). |
|---|
| 56 | .SH "ENVIRONMENT" |
|---|
| 57 | .TP |
|---|
| 58 | .B COURSE |
|---|
| 59 | Specify the default course file exchange. |
|---|
| 60 | .TP |
|---|
| 61 | .B FXPATH |
|---|
| 62 | Specify a colon-separated list of hosts to try as file-exchange |
|---|
| 63 | servers, overriding information in hesiod. |
|---|
| 64 | .SH "NOTES" |
|---|
| 65 | Sometimes a large number of files may be marked as taken by you. This |
|---|
| 66 | will result in a lot of "No such file or directory" errors, which you |
|---|
| 67 | can ignore. |
|---|
| 68 | |
|---|
| 69 | Be sure to use the same options for return that you used for |
|---|
| 70 | collect. |
|---|
| 71 | .SH SEE ALSO |
|---|
| 72 | collect(1), pickup(1), fxoptions(1) |
|---|
| 73 | .SH AUTHOR |
|---|
| 74 | Bruce R. Lewis (brlewis@ATHENA.MIT.EDU) |
|---|
