| 1 | .TH UNCOLLECT 1 "October 25, 1990" |
|---|
| 2 | .SH NAME |
|---|
| 3 | uncollect \- restore collected files |
|---|
| 4 | .SH SYNOPSIS |
|---|
| 5 | uncollect [ options ] [ +n ] [ -n ] [ assignment ] [ student ... ] |
|---|
| 6 | .SH DESCRIPTION |
|---|
| 7 | This is a grader command in the Educational On-Line System. It is |
|---|
| 8 | useful when a grader has accidentally collected more files than |
|---|
| 9 | necessary, marking them TAKEN on the file exchange server and thus |
|---|
| 10 | making it difficult for other graders to collect them. |
|---|
| 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 uncollect files at least |
|---|
| 16 | .B n |
|---|
| 17 | days old. A minus sign followed by a number |
|---|
| 18 | .B n |
|---|
| 19 | means only uncollect 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 | uncollect files for all assignments by leaving out the assignment |
|---|
| 27 | number. Any other argument is a username. If no usernames are |
|---|
| 28 | specified on the command line, all students' files will be |
|---|
| 29 | uncollected. |
|---|
| 30 | |
|---|
| 31 | .B Uncollect |
|---|
| 32 | does not remove the local files which collect placed in the |
|---|
| 33 | destination directory. It merely corrects the state on the file |
|---|
| 34 | exchange server to allow other graders to work normally. The |
|---|
| 35 | collected copies of the files should be removed with delete(1) or |
|---|
| 36 | rm(1). |
|---|
| 37 | |
|---|
| 38 | .SH OPTIONS |
|---|
| 39 | All options are recognized by their first letter. For example, |
|---|
| 40 | -course is usually abbreviated -c, but -class or -co would also be |
|---|
| 41 | recognized, because each starts with the letter c. |
|---|
| 42 | |
|---|
| 43 | Only the most commonly-used options are listed here. See fxoptions(1) |
|---|
| 44 | for a complete list of options. |
|---|
| 45 | .TP |
|---|
| 46 | .B -course <course name> |
|---|
| 47 | Overrides the environmental variable COURSE. Files will be uncollected |
|---|
| 48 | for this course until the end of the command line or until another -c |
|---|
| 49 | option is found. |
|---|
| 50 | .TP |
|---|
| 51 | .B -list |
|---|
| 52 | Only list the files; do not uncollect them. |
|---|
| 53 | .TP |
|---|
| 54 | .B -quiet |
|---|
| 55 | Turns off printing of status information. |
|---|
| 56 | .TP |
|---|
| 57 | .B -verbose |
|---|
| 58 | Turns on printing of status information. This is the default. |
|---|
| 59 | .SH "ENVIRONMENT" |
|---|
| 60 | .TP |
|---|
| 61 | .B COURSE |
|---|
| 62 | Specify the default course file exchange. |
|---|
| 63 | .TP |
|---|
| 64 | .B FXPATH |
|---|
| 65 | Specify a colon-separated list of hosts to try as file-exchange |
|---|
| 66 | servers, overriding information in hesiod. |
|---|
| 67 | .SH "NOTES" |
|---|
| 68 | Sometimes a large number of files may be marked as taken by you. Use |
|---|
| 69 | uncollect -l first to see these files, and use fxpurge -t to get rid |
|---|
| 70 | of these before uncollecting the ones you want. |
|---|
| 71 | |
|---|
| 72 | Be sure to use the same options for uncollect that you used for |
|---|
| 73 | collect. |
|---|
| 74 | .SH SEE ALSO |
|---|
| 75 | collect(1), return(1), fxpurge(1), fxoptions(1) |
|---|
| 76 | .SH AUTHOR |
|---|
| 77 | Bruce R. Lewis (brlewis@ATHENA.MIT.EDU) |
|---|
