Update documentation about bugs reporting and new releases notification

(Cherry-pick commit 1bacdb3 from 'release-7_4' branch.)

* doc/README (Download): Add link to BDWGC Download page on GitHub.
* doc/README (Overview): Change link (for the further information) from
hboehm.info/gc to doc/overview.html.
* configure.ac (AC_INIT): Change URI for reporting bugs.
* doc/README: Likewise.
* doc/gc.man (SEE ALSO): Add link to the BDWGC main page on GitHub.
* doc/gcdescr.html: Remove information how to provide feedback.
* doc/overview.html (Contacts and Mailing List): Update information
(recommend use of GitHub and Stack Overflow, provide links to the
archives of the former mailing lists).

diff --git a/configure.ac b/configure.ac
index f2f8a2dfd8718981556eb0384bea0db41ef423f2..fff9f7d3a3851b574540df9adc8da99a69f3cd24 100644 (file)
--- a/configure.ac
+++ b/configure.ac
@@ -17,7 +17,7 @@ dnl Process this file with autoconf to produce configure.
 # Initialization
 # ==============
 
-AC_INIT(gc,7.2,bdwgc@lists.opendylan.org)
+AC_INIT(gc,7.2,https://github.com/ivmai/bdwgc/issues)
     ## version must conform to [0-9]+[.][0-9]+(alpha[0-9]+)?
 AC_CONFIG_SRCDIR(gcj_mlc.c)
 AC_CONFIG_MACRO_DIR([m4])

diff --git a/doc/README b/doc/README
index 0bcfc79a996ced3d8fc9eb92c292bc0f9221bf76..aa4b8133c120675648fa7e1d8ba911641670a59a 100644 (file)
--- a/doc/README
+++ b/doc/README
@@ -40,6 +40,10 @@ This is version 7.2g of a conservative garbage collector for C and C++.
 
 You might find a more recent version of this at
 
+https://github.com/ivmai/bdwgc/wiki/Download
+
+or
+
 http://www.hboehm.info/gc/
 
 OVERVIEW
@@ -100,9 +104,7 @@ collector.  (See doc/README.cords and H.-J. Boehm, R. Atkinson, and M. Plass,
 (December 1995), pp. 1315-1330.  This is very similar to the "rope" package
 in Xerox Cedar, or the "rope" package in the SGI STL or the g++ distribution.)
 
-Further collector documentation can be found at
-
-http://www.hboehm.info/gc/
+Further collector documentation can be found in overview.html
 
 
 GENERAL DESCRIPTION
@@ -538,7 +540,7 @@ reclaimed.  Exclusive-or'ing forward and backward links in a list
 doesn't cut it.
   Some C optimizers may lose the last undisguised pointer to a memory
 object as a consequence of clever optimizations.  This has almost
-never been observed in practice.  Send mail to bdwgc@lists.opendylan.org
+never been observed in practice.  Use https://github.com/ivmai/bdwgc/issues
 for suggestions on how to fix your compiler.
   This is not a real-time collector.  In the standard configuration,
 percentage of time required for collection should be constant across
@@ -549,6 +551,7 @@ is enabled.
 per MB of accessible memory that needs to be scanned and processor.
 Your mileage may vary.)  The incremental/generational collection facility
 may help in some cases.
-  Please address bug reports to bdwgc@lists.opendylan.org.  If you are
+  Please address bug reports to https://github.com/ivmai/bdwgc/issues.
+If you are
 contemplating a major addition, you might also send mail to ask whether
 it's already been done (or whether we tried and discarded it).

diff --git a/doc/gc.man b/doc/gc.man
index 4553737608a1879cfabaf674c0dedf58a0f73287..201729f832b2f49aa4fa45f3cf60db542a106695 100644 (file)
--- a/doc/gc.man
+++ b/doc/gc.man
@@ -91,7 +91,7 @@ Other facilities not discussed here include limited facilities to support increm
 .SH "SEE ALSO"
 The README and gc.h files in the distribution.  More detailed definitions of the functions exported by the collector are given there.  (The above list is not complete.)
 .LP
-The web site at http://www.hboehm.info/gc/ .
+The web site at http://www.hboehm.info/gc/ (or https://github.com/ivmai/bdwgc/).
 .LP
 Boehm, H., and M. Weiser, "Garbage Collection in an Uncooperative Environment",
 "Software Practice & Experience", September 1988, pp. 807-820.

diff --git a/doc/gcdescr.html b/doc/gcdescr.html
index 671342b734452919da65ce29d9b35b0c43d7f33e..40585188bd5f17ef44c2ec3ac9b5325bf953cecc 100644 (file)
--- a/doc/gcdescr.html
+++ b/doc/gcdescr.html
@@ -617,12 +617,5 @@ For some more details see <A HREF="scale.html">here</a>, and the
 technical report entitled
 <A HREF="http://www.hpl.hp.com/techreports/2000/HPL-2000-165.html">
 "Fast Multiprocessor Memory Allocation and Garbage Collection"</a>
-<P>
-<HR>
-<P>
-Comments are appreciated.  Please send mail to
-<A HREF="mailto:bdwgc@lists.opendylan.org"><tt>bdwgc@lists.opendylan.org</tt></a>
-(GC mailing list) or
-<A HREF="mailto:boehm@acm.org"><TT>boehm@acm.org</tt></a>
 </body>
 </html>

diff --git a/doc/overview.html b/doc/overview.html
index 8e93609ff256944aeab99833d0e49be6197f5ec5..cc4421b62dff2cd6499af9d9eb8d1151d5b0c643 100644 (file)
--- a/doc/overview.html
+++ b/doc/overview.html
@@ -401,28 +401,33 @@ Technical Report version</a>).
 <a href="http://www.hboehm.info/gc/gctalk.ps">Slides for OOPSLA 98 garbage collection talk</a>.
 </p><p>
 <a href="http://www.hboehm.info/gc/papers/">Related papers</a>.
-</p><h1><a name="contacts">Contacts and Mailing List</a></h1>
-<a>We have recently set up two mailing list for collector announcements
-and discussions:
-</a><ul>
-<li><a href="mailto:bdwgc-announce@lists.opendylan.org">bdwgc-announce@lists.opendylan.org</a>
-is used for announcements of new versions.  Postings are restricted.
-We expect this to always remain a very low volume list.
-</li><li><a href="mailto:bdwgc@lists.opendylan.org">bdwgc@lists.opendylan.org</a>
-is used for discussions, bug reports, and the like.  Subscribers may post.
-On-topic posts by nonsubscribers will usually also be accepted, but
-it may take some time to review them.
-</li></ul>
-To subscribe to these lists, please visit
-<a href="https://lists.opendylan.org/mailman/listinfo/bdwgc-announce">lists.opendylan.org/mailman/listinfo/bdwgc-announce</a>
-and
-<a href="https://lists.opendylan.org/mailman/listinfo/bdwgc">lists.opendylan.org/mailman/listinfo/bdwgc</a>,
-respectively.
+</p><h1><a name="contacts">Contacts and new release announcements</a></h1>
+GitHub and Stack Overflow are the major two places for communication.
 <p>
-The archives for these lists appear
-<a href="https://lists.opendylan.org/pipermail/bdwgc-announce/">here</a> and
-<a href="https://lists.opendylan.org/pipermail/bdwgc/">here</a>,
-respectively.
+Technical questions (how to, how does it work, etc.) should be posted to
+<a href="https://stackoverflow.com/questions/tagged/boehm-gc">Stack Overflow</a>
+with "boehm-gc" tag.
+</p><p>
+To contribute, please rebase your code to the latest
+<a href="https://github.com/ivmai/bdwgc/tree/master/">master</a> and submit
+a <a href="https://github.com/ivmai/bdwgc/pulls">pull request</a> to GitHub.
+</p><p>
+To report a bug, or propose (request) a new feature, create
+a <a href="https://github.com/ivmai/bdwgc/issues">GitHub issue</a>.
+Please make sure it has not been reported yet by someone else.
+</p><p>
+To receive notifications on every release, please subscribe to
+<a href="https://github.com/ivmai/bdwgc/releases.atom">Releases RSS feed</a>.
+Notifications on all issues and pull requests are available by
+<a href="https://github.com/ivmai/bdwgc/watchers">watching</a> the project.
+</p><p>
+Mailing lists (bdwgc-announce@lists.opendylan.org, bdwgc@lists.opendylan.org,
+and the former gc-announce@linux.hpl.hp.com and gc@linux.hpl.hp.com) are not
+used at this moment.  Their content is available in
+<a href="https://github.com/ivmai/bdwgc/files/1037650/bdwgc-announce-mailing-list-archive-2014_02.tar.gz">bdwgc-announce</a>
+and
+<a href="https://github.com/ivmai/bdwgc/files/1038163/bdwgc-mailing-list-archive-2017_04.tar.gz">bdwgc</a>
+archive files, respectively.
 The gc list archive may also be read at
 <a href="http://dir.gmane.org/gmane.comp.programming.garbage-collection.boehmgc">gmane.org</a>.
 </p><p>
@@ -430,8 +435,4 @@ Some prior discussion of the collector has taken place on the gcc
 java mailing list, whose archives appear
 <a href="http://gcc.gnu.org/ml/java/">here</a>, and also on
 <a href="http://lists.tunes.org/mailman/listinfo/gclist">gclist@iecc.com</a>.
-</p><p>
-Comments and bug reports may also be sent to
-(<a href="mailto:boehm@acm.org">boehm@acm.org</a>), but the gc
-mailing list is usually preferred.
 </p></body></html>