Source Browser ?

1\startcomponent ma-cb-en-errors
2
3\enablemode[**en-us]
4
5\project ma-cb
6
7\startchapter[reference=trouble,title=Problems during processing]
8
9\index{errors}
10\index{problems}
11
12If processing is not succesful ---for example because you typed \type{\stptext}
13instead of \type{\stoptext}--- \CONTEXT\ produces a \type{ ? } on your screen
14and tells you it has just processed an error. It will give you some basic
15information on the type of error and the line number where the error becomes
16effective.
17
18At the instant of \type{ ? } you can type:
19
20\starttabulate[|||]
21\NC \type{H} \NC for help information on your error \NC\NR
22\NC \type{I} \NC for inserting the correct \CONTEXT\ command \NC\NR
23\NC \type{Q} \NC for quiting and entering batch mode \NC\NR
24\NC \type{X} \NC for exiting the running mode \NC\NR
25\NC \Enter   \NC for ignoring the error \NC\NR
26\stoptabulate
27
28Most of the time you will type \Enter\ and processing will continue. Then you can
29edit the input file and fix the error.
30
31Some errors will produce a~\type{ * } on your screen and processing will stop.
32This error is due to a fatal error in your input file. You can't ignore this
33error and the only option you have is to type \type{\stop} or {\sc Ctrl}~Z. The
34program will be halted and you can fix the error in your text editor.
35
36\startframedtext[width=\hsize]
37A well known error is:
38
39\starttyping
40! I can't write on file 'myfile.pdf'.
41Please type another filename for output:
42\stoptyping
43
44This error is due to the fact that the file \type{myfile.pdf} is stil open
45in \READER.
46
47\blank
48
49The best way to proceed is:
50
51\startitemize[packed]
52\item close the file in \READER
53\item type \Enter\ at the console
54\stopitemize
55\stopframedtext
56
57Sometimes the error messages are very obscure. Finding the location of the error
58in an extensive document can then be a tedious job. You could try to isolate
59the error:
60
61\startitemize[packed]
62\item open the file in your text editor
63\item save a copy of your file (to be on the safe side)
64\item isolate the error
65      \startitemize[n,packed]
66      \item place a \type{\stoptext} command higher up in your text
67      \item process the file
68      \item repeat step 1 and 2 until the file processes correctly
69      \stopitemize
70\item study the content that produces the error
71\item fix the error
72\item place the \type{\stoptext} command after the corrected error
73\item process your file
74\item etc.
75\stopitemize
76
77\stopchapter
78
79\stopcomponent
80