chiark / gitweb /
Merge various clang-inspired fixes
[disorder] / doc / disorder_actions.5.head
CommitLineData
5c1ae3bc
RK
1.\"
2.\" Copyright (C) 2008 Richard Kettlewell
3.\"
e7eb3a27 4.\" This program is free software: you can redistribute it and/or modify
5c1ae3bc 5.\" it under the terms of the GNU General Public License as published by
e7eb3a27 6.\" the Free Software Foundation, either version 3 of the License, or
5c1ae3bc 7.\" (at your option) any later version.
e7eb3a27
RK
8.\"
9.\" This program is distributed in the hope that it will be useful,
10.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
11.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12.\" GNU General Public License for more details.
13.\"
5c1ae3bc 14.\" You should have received a copy of the GNU General Public License
e7eb3a27 15.\" along with this program. If not, see <http://www.gnu.org/licenses/>.
5c1ae3bc
RK
16.\"
17.TH disorder_actions 5
18.SH NAME
19disorder_actions - DisOrder CGI actions
20.SH DESCRIPTION
21The primary CGI parameter to the DisOrder web interface is \fBaction\fR.
22This determines which of a set of actions from the list below it carries out.
23.PP
24For any action \fIACTION\fR not in the list, the CGI expands the template
25\fIACTION\fB.tmpl\fR.
26.PP
27If no action is set, then the default is \fBplaying\fR, unless the argument
28\fBc\fR is present, in which case it is \fBconfirm\fR.
29This is a hack to keep confirmation URLs short.
30.SS Redirection
c6e44487
RK
31Actions in the list below that do not documented what template they expand
32issue an HTTP redirect according to the value of the \fBback\fR argument.
5c1ae3bc
RK
33There are three possibilities:
34.TP
35.BR 1 )
36\fBback\fR is a URL.
37The browser is redirected to that URL.
38.TP
39.BR 2 )
40\fBback\fR is an action name.
41The browser is redirected to a URL which uses that action.
42.TP
43.BR 3 )
44\fBback\fR is not set.
45The browser is redirected to the front page.
46.PP
47If an action needs more rights than the logged-in user has then they are
48redirected to \fBlogin\fR with \fBback\fR set to retry the action they wanted.
49.PP
50Certain errors cause a redirection to \fBerror\fR with \fB@error\fR set.
51.SH ACTIONS
52.\" Local Variables:
53.\" mode:nroff
54.\" fill-column:79
55.\" End: