home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / useful / text / tex / pastex / macros / latex2e / inputs / latexbug.tex < prev    next >
Text File  |  1994-06-10  |  13KB  |  518 lines
  1. % \iffalse meta-comment
  2. %
  3. % Copyright 1994 the LaTeX3 project and the individual authors.
  4. % All rights reserved. For further copyright information see the file
  5. % legal.txt, and any other copyright indicated in this file.
  6. % 
  7. % This file is part of the LaTeX2e system.
  8. % ----------------------------------------
  9. % 
  10. %  This system is distributed in the hope that it will be useful,
  11. %  but WITHOUT ANY WARRANTY; without even the implied warranty of
  12. %  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  13. % 
  14. % 
  15. % IMPORTANT NOTICE:
  16. % 
  17. % For error reports in case of UNCHANGED versions see bugs.txt.
  18. % 
  19. % Please do not request updates from us directly.  Distribution is
  20. % done through Mail-Servers and TeX organizations.
  21. % 
  22. % You are not allowed to change this file.
  23. % 
  24. % You are allowed to distribute this file under the condition that
  25. % it is distributed together with all files mentioned in manifest.txt.
  26. % 
  27. % If you receive only some of these files from someone, complain!
  28. % 
  29. % You are NOT ALLOWED to distribute this file alone.  You are NOT
  30. % ALLOWED to take money for the distribution or use of either this
  31. % file or a changed version, except for a nominal charge for copying
  32. % etc.
  33. % \fi
  34.  
  35. %%% ====================================================================
  36. %%%  @LaTeX-file{
  37. %%%     author          = "David Carlisle",
  38. %%%     version         = "1.08",
  39. %%%     date            = "08 June 1994",
  40. %%%     filename        = "latexbug.tex",
  41. %%%     email           = "latex-bugs@uni-mainz.de",
  42. %%%     codetable       = "ISO/ASCII",
  43. %%%     keywords        = "LaTeX, bugs, reporting",
  44. %%%     supported       = "yes",
  45. %%%     docstring       = "
  46. %%%
  47. %%%     LaTeX bug report generator.
  48. %%%     %%%%%%%%%%%%%%%%%%%%%%%%%%
  49. %%%
  50. %%%     Processing this file with LaTeX should produce
  51. %%%     a file latexbug.msg in the current directory.
  52. %%%
  53. %%%     latexbug.msg may be used as a template for submitting bug
  54. %%%     reports concerning files in the standard LaTeX distribution.
  55. %%%
  56. %%%     Any bug report should include a small LaTeX test file
  57. %%%     that shows the bug, and the log that LaTeX produces on the
  58. %%%     test file.
  59. %%%
  60. %%%     Please check before submitting a bug report that your format is
  61. %%%     not more than one year old. New LaTeX releases occur at 6
  62. %%%     monthly intervals, and so your bug may be fixed in a later
  63. %%%     release.
  64. %%%
  65. %%%     Completed bug report forms should be submitted to:
  66. %%%     latex-bugs@uni-mainz.de
  67. %%%
  68. %%%  }
  69. %%% ====================================================================
  70.  
  71. \ifcat{=
  72.  
  73. \catcode`\{=1 \let\bgroup{
  74. \catcode`\}=2 \let\egroup}
  75. \catcode`\#=6 
  76. \catcode`\^=7
  77. \catcode`\@=11
  78.  
  79. \newlinechar`\^^J
  80. \def\m@ne{-1 }
  81. \countdef\count@255
  82.  
  83. \def\fmtname{INITEX}
  84. \def\fmtversion{9999/00/00}
  85. \def\space{ }
  86. \def\@spaces{\space\space\space\space}
  87. \let\@@end\end
  88.  
  89. \chardef\msg15
  90. \immediate\openout\msg=\jobname.msg
  91.  
  92. \expandafter\edef\csname newif\endcsname#1#2{%
  93.   \let\noexpand\ifinteractive
  94.     \expandafter\noexpand\csname iffalse\endcsname}
  95.  
  96. \def\typeout{\immediate\write17}
  97.  
  98. \def\two@digits#1{\ifnum#1<10 0\fi\number#1}
  99.  
  100. \def\wmsg#1#{\bgroup\@wmsg}
  101.  
  102. \else
  103. %%
  104. %% @ is a letter
  105. %%
  106. \catcode`\@=11
  107.  
  108. %%
  109. %% Output stream to produce the bug report template.
  110. %%
  111. \newwrite\msg
  112. \immediate\openout\msg=\jobname.msg
  113.  
  114.  
  115. %%
  116. %% Check that LaTeX2e is being used.
  117. %%
  118. \ifx\undefined\newcommand
  119.  \newlinechar`\^^J%
  120.  \immediate\write17{^^J%
  121.     You must use LaTeX2e to generate the bug report!^^J^^J%
  122.     If there is a bug in the installation procedure,^^J%
  123.     and you can not create LaTeX2e, you may use initex^^J%
  124.     to generate the report}%
  125.  
  126.  \let\relax\end
  127. \else
  128. \def\@tempa{LaTeX2e}\ifx\@tempa\fmtname\else
  129.  \immediate\write17{^^J%
  130.   Older Versions of LaTeX are no longer supported.^^J%
  131.   You must use LaTeX2e to generate the bug report!^^J^^J%
  132.   If there is a bug in the installation procedure,^^J%
  133.   and you can not create LaTeX2e, you may use initex^^J%
  134.   to generate the report}%
  135.  \let\relax\@@end
  136. \fi\fi
  137.  
  138. %%
  139. %% \wmsg writes to the terminal, and the .msg file
  140. %% \wmsg* just writes to the .msg file
  141. %% \typeout just writes to the terminal
  142. %%
  143.  
  144. \def\wmsg{\bgroup\@ifstar{\interactivefalse\@wmsg}\@wmsg}
  145.  
  146. \fi
  147.  
  148. \relax
  149.  
  150.  
  151. \def\@wmsg#1{%
  152.   \ifinteractive\immediate\write17{#1}\fi
  153.   \immediate\write\msg{#1}%
  154.   \egroup}
  155.  
  156.  
  157. %%
  158. %% if \interactivefalse just make a blank template.
  159. %%
  160. \newif\ifinteractive
  161. \interactivetrue
  162.  
  163.  
  164. %%%
  165. %%% For testing for blank lines.
  166. %%%
  167. \def\xpar{\par}
  168.  
  169.  
  170. %%
  171. %% Opening Banner.
  172. %%
  173. \typeout{^^J%
  174. ============================================================^^J%
  175. ^^J%
  176. LaTeX bug report generator^^J%
  177. ==========================^^J%
  178. Processing this file with LaTeX will produce a template \jobname.msg^^J%
  179. for submitting bug reports for the LaTeX distribution.^^J%
  180. Please do not report bugs in other, non-standard, files to the^^J%
  181. latex-bugs address.^^J}
  182.  
  183. \count@=0
  184. \ifinteractive
  185. \typeout{%
  186. Several categories of files are supported,^^J%
  187. corresponding to directories in the standard LaTeX distribution:^^J^^J
  188. 0) base: \@spaces
  189.          The format itself, and the main classes such as `article'.^^J
  190. 1) tools:\@spaces
  191.          Packages supported by the LaTeX3 project team.^^J
  192. 2) graphics: 
  193.          The color and graphics packages.^^J
  194. 3) mfnfss: \space\space
  195.          Packages for using MetaFont fonts with NFSS (ie LaTeX2e).^^J
  196. 4) psnfss: \space\space
  197.          Packages for using PostScript fonts with NFSS (ie LaTeX2e).^^J
  198. 5) amslatex:
  199.          Classes and Packages supported by the AMS.^^J
  200. 6) babel:\@spaces
  201.          Packages supporting many different languages.^^J%
  202. }
  203. \message{Please select a category 0--6:  }
  204. \read\m@ne to \answer
  205. \count@=\answer
  206. \else
  207. \typeout{As you are using INITEX, I will assume category 0}
  208. \fi
  209.  
  210. \ifcase\count@
  211. \wmsg{^^J>Category: latex}\or
  212. \wmsg{^^J>Category: tools}\or
  213. \wmsg{^^J>Category: graphics}\or
  214. \wmsg{^^J>Category: mfnfss}\or
  215. \wmsg{^^J>Category: psnfss}\or
  216. \wmsg{^^J>Category: amslatex}\or
  217. \wmsg{^^J>Category: babel}\else
  218. \errhelp{Quit with `x' and then re-start latexbug}
  219. \def\badcategory{Only categories 0,...,6 are supported at this time}
  220. \errmessage{\badcategory}
  221. \fi
  222.  
  223.  
  224. \typeout{%
  225. ^^J%
  226. \ifinteractive
  227. This report generator may be used in one of two ways.^^J%
  228. If you choose the interactive option, you will be prompted to answer^^J%
  229. several questions. Otherwise a blank template will be created for^^J%
  230. you to fill in using your editor.^^J%
  231. \else
  232. INITEX should only be used for reporting bugs with the LaTeX2e^^J%
  233. installation procedure. If you have a working copy of LaTeX2e,^^J%
  234. please use that to generate the report.
  235. \fi}
  236.  
  237. \ifinteractive
  238. \message{Interactive session (y/n) ? }
  239. \read\m@ne to \answer
  240.  
  241. \ifx\answer\xpar
  242.    \def\answer{n}
  243. \fi
  244.  
  245. %%
  246. %% Allow anything begining with `y' or `Y' for yes.
  247. %%
  248. \edef\answer{\uccode`\expandafter\@car\answer\@nil}
  249. \ifnum \answer=`Y \else\interactivefalse\fi
  250. \else
  251. \def\answer{`\N}
  252. \fi
  253.  
  254. %%
  255. %% Header in the msg file.
  256. %%
  257. \wmsg*{^^J%
  258.  LaTeX2e bug report.^^J%
  259. \ifnum \answer=`Y Generated \else Template generated \fi
  260.  by latexbug.tex on \number\year/\two@digits\month/\two@digits\day^^J%
  261.  ============================================================}
  262.  
  263. \ifinteractive
  264. %%
  265. %% if interactive, \wread reads a line (verbatim) and write it to the
  266. %% .msg file, until a blank line is entered.
  267. %%
  268.   \typeout{^^J%
  269.     The answer to each question may take several lines.^^J%
  270.     (Each line will be prompted by =>.)^^J%
  271.     Typing a blank line terminates the current answer.}
  272.   \def\wread{{\catcode`\^^I=12
  273.   \let\do\@makeother\dospecials
  274.   \message{=> }\read\m@ne to \answer
  275.   \ifx\answer\xpar\else
  276.     \immediate\write\msg{\answer}
  277.     \expandafter\wread
  278.   \fi}}
  279. \else
  280. %%
  281. %% If non-interactive, \wread just writes a blank line to the .msg file,
  282. %% and \wmsg does not write to the terminal.
  283. %%
  284.   \def\wread{\wmsg{}}
  285. \fi
  286.  
  287. %%
  288. %% \copytomsg copies the contents of a file into the .msg file.
  289. %% (at least it does it as well as TeX can, so there may be
  290. %% transcription problems with 8-bit characters).
  291. %%
  292.  
  293. \chardef\inputfile=15
  294.  
  295. \def\copytomsg#1{{%
  296.    \def\do##1{\catcode`##1=11}%
  297.    \dospecials
  298.    \openin\inputfile#1
  299.    \@copytomsg
  300.    \closein\inputfile
  301. }}
  302.  
  303. \def\@copytomsg{%
  304.    \ifeof\inputfile
  305.    \else
  306.       \read\inputfile to \inputline
  307.       \ifx\inputline\xpar
  308.