X-Git-Url: https://www.ginac.de/ginac.git//ginac.git?p=ginac.git;a=blobdiff_plain;f=README;h=e828a0eba892efa7e21ad18fd1c09bf69d057802;hp=11b2b0ac11ff3f91e13da86a8f9874f1e7107dec;hb=d4ea19a525805e98ddbc8c88a4bb229763373c04;hpb=7d5599da087670e2ce1229789a847acd73fe8e0a;ds=sidebyside

diff --git a/README b/README
index 11b2b0ac..e828a0eb 100644
--- a/README
+++ b/README
@@ -1,17 +1,56 @@
 General Information
 ===================
 
-GiNaC (which stands for "GiNaC is not a computer algebra system) is a
-C++ library for symbolic mathematical calculations. It is designed to
-allow the creation of integrated systems that embed symbolic manipulations
-together with more established areas of computer science (like computation-
-intense numeric applications, graphical interfaces, etc.) under one roof.
+GiNaC (which stands for "GiNaC is Not a CAS" (computer algebra system)) is a
+C++ library for symbolic mathematical calculations.  It is designed to allow
+the creation of integrated systems that embed symbolic manipulations together
+with more established areas of computer science (like computation-intense
+numeric applications, graphical interfaces, etc.) under one roof.
 
-The official web site it:
-  http://wwwthep.physik.uni-mainz.de/GiNaC/
+The official web site is:
+  https://www.ginac.de/
+
+A mailing list is located at:
+  ginac-list@ginac.de
+
+You need to be subscribed to be able to post to the list. To subscribe,
+please follow the instructions on
+  https://www.cebix.net/mailman/listinfo/ginac-list
+
+See https://www.ginac.de/Lists.html for the list policy.
 
 
 Installation
 ============
 
 See the file "INSTALL".
+
+
+How to report bugs
+==================
+
+If you have identified a bug in GiNaC you are welcome to send a detailed
+bug report to <ginac-list@ginac.de>.  Please think about your bug!  This
+means that you should include
+
+* Information about your system
+
+   - Which operating system and version (uname -a)
+   - Which C compiler and version (gcc --version)
+   - For Linux, which version of the C library
+
+  And anything else you think is relevant.
+
+* Information about your version of GiNaC
+
+   - Version and release number
+   - Which options GiNaC was configured with
+
+* How to reproduce the bug
+
+   - If it is a systematical bug in the library, a short test program
+     together with the output you get and the output you expect will
+     help us to reproduce it quickly.
+
+Patches are most welcome.  If possible please make them with diff -c and
+include ChangeLog entries.