Don't print an error message for empty courses
[nci.git] / nci-create-assignment-group.1
blobe5b9f5a4c3cd371dc612fbd6745740de94d32321
1 .Dd 2016-06-12
2 .Dt NCI-CREATE-ASSIGNMENT-GROUP 1
3 .Os
4 .Sh NAME
5 .Nm nci-create-assignment-group
6 .Nd Create a new group in a Canvas installation, to which assignments can be associated
7 .Sh SYNOPSIS
8 .Nm
9 .Fl c
10 .Ar course-id
11 .Fl n
12 .Ar name
13 .Fl w
14 .Ar weight
15 .Oo
16 .Fl d
17 .Ar number-of-lowest
18 .Oc
19 .Oo
20 .Fl D
21 .Ar number-of-highest
22 .Oc
23 .Sh DESCRIPTION
24 .Nm
25 connects to a Canvas installation as described at
26 .Xr nci 1
27 and creates an assignment group with the given parameters. If
28 successful, the id of the created assignment group will be printed.
29 .Sh OPTIONS
30 .Bl -tag -width Ds
31 .It Fl c
32 The
33 .Ar course-id ,
34 as returned by
35 .Xr nci-list-courses 1 .
36 .It Fl n
37 Set the name of the new assignment group.
38 .It Fl w
39 Set the percentage of the total course grade that this assignment
40 group will represent when Canvas calculates a student's total
41 score. If this doesn't add up to 100% with the other groups in place,
42 it is up to Canvas to interpret it.
43 .It Fl d | D
44 Set a grading rule for the group. When calculating a student's score,
45 Canvas can be instructed to drop a set number of lowest and/or highest
46 scores from this group.
47 .El
48 .Sh EXAMPLES
49 .Dl % nci-create-assignment-group -c 1187637 -n Homework -w 10.0 -d 2
50 .Dl 1560872
51 .Sh SEE ALSO
52 .Xr nci 1
53 .Xr nci-create-assignment-group 1
54 .Xr nci-delete-assignment-group 1
55 .Xr nci-list-courses 1
56 .Sh AUTHORS
57 .An S. Gilles Aq Mt sgilles@math.umd.edu