Documentation: Add a @pspp macro

[pspp] / doc / bugs.texi

diff --git a/doc/bugs.texi b/doc/bugs.texi
index 1df01284df83e86a0424d597843288d73fc35974..96c1ed2227d0fd3d657cc6a41c9898669e4de7d6 100644 (file)
--- a/doc/bugs.texi
+++ b/doc/bugs.texi
@@ -1,85 +1,36 @@
-@node Bugs, Function Index, Not Implemented, Top
+@node Bugs
 @chapter Bugs
 
-@menu
-* Known bugs::                  Pointers to other files.
-* Contacting the Author::       Where to send the bug reports.
-@end menu
-
-@node Known bugs, Contacting the Author, Bugs, Bugs
-@section Known bugs
-
-This is the list of known bugs in PSPP.  In addition, @xref{Not
-Implemented}, and @xref{Functions Not Implemented}, for lists of bugs
-due to features not implemented.  For known bugs in individual language
-features, see the documentation for that feature.
+@cindex bugs
 
+Occasionally users encounter problems with @pspp{}.
+When such problems arise we do our best to fix them, but our limited
+resources mean that certain issues may remain for some time.
+If you discover a bug, please first:
 @itemize @bullet
-@item
-Nothing has yet been tested exhaustively. Be cautious using PSPP to
-make important decisions.
-
-@item
-@code{make check} fails on some systems that don't like the syntax.  I'm
-not sure why.  If someone could make an attempt to track this down, it
-would be appreciated.
-
-@item
-PostScript driver bugs:
-
-@itemize @minus
-@item
-Does not support driver arguments `max-fonts-simult' or
-`optimize-text-size'.
-
-@item
-Minor problems with font-encodings.
-
-@item
-Fails to align fonts along their baselines.
-
-@item
-Does not support certain bizarre line intersections--should
-never crop up in practice.
-
-@item
-Does not gracefully substitute for existing fonts whose
-encodings are missing.
-
-@item
-Does not perform italic correction or left italic correction
-on font changes.
-
-@item
-Encapsulated PostScript is unimplemented.
+@item Try an up to date version of @pspp{}; it may be that the problem 
+ has recently been fixed.
+@item If the problem persists in the up to date version; check to see
+ if it has already been reported.
+@item If the problem exists in a recent version and it has not already 
+ been reported, please file a report.
 @end itemize
 
-@item
-ASCII driver bugs:
+To see a list of reported bugs, visit @pspp{}'s project webpage at
+@uref{http://savannah.gnu.org/bugs/?group=pspp}
+Alternatively, bug reports may be sent by email
+to @email{bug-gnu-pspp@@gnu.org}.
 
-@itemize @minus
-Does not support `infinite length' or `infinite width' paper.
-@end itemize
+In your bug report please include:
+@itemize @bullet
+@item The version of @pspp{} which you are using.
+@item The operating system and type of computer on which it is running.
+@item A sample of the syntax which causes the problem or, if it is a user
+ interface problem, the sequence of steps required to reproduce it.
+@item A description of what you think is wrong: What happened that you 
+  didn't expect, and what did you expect to happen?
 @end itemize
 
-See below for information on reporting bugs not listed here.
-
-@node Contacting the Author,  , Known bugs, Bugs
-@section Contacting the Author
-
-The author can be contacted at e-mail address
-@ifinfo
-<blp@@gnu.org>.
-@end ifinfo
-@iftex
-@code{<blp@@gnu.org>}.
-@end iftex
+For known bugs in individual language features, see the documentation
+for that feature.
 
-PSPP bug reports should be sent to 
-@ifinfo
-<bug-gnu-pspp@@gnu.org>.
-@end ifinfo
-@iftex
-@code{<bug-gnu-pspp@@gnu.org>}.
-@end iftex
-@setfilename ignored