summaryrefslogtreecommitdiff
path: root/static/v10/man7/submit.7
blob: 87fe1ccb77c7c133caa453225a8d5646f9857f99 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
.TH SUBMIT 7
.CT 1 writing_output
.SH NAME
submit \- install document in database
.SH SYNOPSIS
.B submit
.I name
[
.I option ...
]
.SH DESCRIPTION
.I Submit
ships a paper to
.FR /n/bowell/pap/spool ,
from whence the paper will be installed under the given
.I name
in a database of locally-authored papers.
The paper then becomes available for printing with
.IR makepaper
(see
.IR papers (7))
or for on-line inspection with
.IR reader (9.7).
.PP
.I Submit
expects to be run from a directory that
contains the files for the paper.
If only the
.I  name 
argument is given, 
.I submit
assumes that the paper is maintained by
.IR make (1)
and follows instructions in the makefile, which must be present.
The options are
.TP
.B -mk
Use
.IR mk (1)
instead of
.I make.
.TP
.BI -M " makefile
Use the given makefile.
.TP
.BI -m " target
Make the given target.
.TP
.BI -s " script arg ..."
Use a shell
.I script
instead of a makefile.
.TP
.BI -i " file ..."
Format the paper with
.IR troff (1)
from the listed files, using macro packages and preprocessors as 
determined by
.IR doctype (1).
Do not use a makefile or a shell script.
.TP
.BI -t " file ...
Format the paper with
.IR tex (1)
from the listed files.
Do not use a makefile or a shell script.
Only the basenames of the files need be given.
.TP
.B -tatex
The paper uses
.IR tatex 
(see
.IR latex (7)).
This option is used only in conjunction with
.BR -t .
.SH FILES
.F /n/bowell/pap/spool/*
.SH DIAGNOSTICS
.I Submit
complains if it can't find input or if it encounters a
.I troff
.L .sy
command.
.SH "SEE ALSO"
.IR reader (9.7), 
.IR troff (1), 
.IR papers (7)
.SH BUGS
.I Submit
fails if the
.I troff
preprocessors are run in a `hidden' way
by calling a program (or shell script).
.br
When
.I troff
preprocessor output (i.e. 
.IR "pic, grap, tbl, tped, ideal" )
is included directly in the paper or with 
.B .so
commands,
an attempt is made to find the preprocessor input file.
If this attempt fails,
.I submit
refuses to ship the paper.
.br
Automatic installation fails if the system can't find
the author's name or the author is not in the file containing
the center organization.
.br
Doesn't work with 
.IR monk (1).