Menu
▾
▴
[Docutils-checkins] SF.net SVN: docutils:[8103] trunk/docutils
|
From: <mi...@us...> - 2017-06-09 11:02:38
|
Revision: 8103
http://sourceforge.net/p/docutils/code/8103
Author: milde
Date: 2017-06-09 11:02:35 +0000 (Fri, 09 Jun 2017)
Log Message:
-----------
Remove dead links to the Gmane web interface.
The mail to news interface and mail archive "Gmane" went down 2016 and is
only partially restored. http://home.gmane.org/2016/08/29/next-steps-gmane/
Remove dead links to the web interface and add links to the
mail archives at Sourceforge.
TODO: There are still dead links to specific messags in
Bugs.txt, todo.txt and alternatives.txt
Thanks to Luke Plant for reporting the issue.
Modified Paths:
--------------
trunk/docutils/BUGS.txt
trunk/docutils/README.txt
trunk/docutils/docs/user/mailing-lists.txt
Modified: trunk/docutils/BUGS.txt
===================================================================
--- trunk/docutils/BUGS.txt 2017-06-03 10:49:13 UTC (rev 8102)
+++ trunk/docutils/BUGS.txt 2017-06-09 11:02:35 UTC (rev 8103)
@@ -152,8 +152,10 @@
``href="C:/test/foo.css"`` instead of
``href="file:///C:/test/foo.css"``.
- For details, see `this posting by Alan G. Isaac
- <http://article.gmane.org/gmane.text.docutils.user/1569>`_.
+ .. gmane web interface is down.
+ TODO: find this article in the Sourceforge mail archives
+ For details, see `this posting by Alan G. Isaac
+ <http://article.gmane.org/gmane.text.docutils.user/1569>`_.
* Footnote label "5" should be "4" when processing the following
input::
Modified: trunk/docutils/README.txt
===================================================================
--- trunk/docutils/README.txt 2017-06-03 10:49:13 UTC (rev 8102)
+++ trunk/docutils/README.txt 2017-06-09 11:02:35 UTC (rev 8103)
@@ -31,7 +31,7 @@
3. Unpack the tarball in a temporary directory (**not** directly in
Python's ``site-packages``), go to the directory created by expanding
- the archive, and run ``setup.py install`` with admin rights. On
+ the archive, and run ``setup.py install``. On
Windows systems it may be sufficient to double-click ``install.py``.
See Installation_ below for details.
@@ -79,18 +79,19 @@
====================
While we are trying to follow a "release early & often" policy,
-features are added very frequently. Since the code in the Subversion
+features are added frequently. Since the code in the Subversion
repository is usually in a bug-free state, we recommend that you use
-the current snapshot (which is usually updated within an hour of
-changes being committed to the repository):
+a current snapshot.
-* Snapshot of Docutils code, documentation, front-end tools, and
- tests:
- http://docutils.svn.sourceforge.net/viewvc/docutils/trunk/docutils/?view=tar
+To get a snapshot, go to the code page and click the download snapshot
+button:
-* Snapshot of the Sandbox (experimental, contributed code):
- http://docutils.svn.sourceforge.net/viewvc/docutils/trunk/sandbox/?view=tar
+* Docutils code, documentation, front-end tools, and tests:
+ https://sourceforge.net/p/docutils/code/HEAD/tree/trunk/docutils/
+* Sandbox (experimental, contributed code):
+ https://sourceforge.net/p/docutils/code/HEAD/tree/trunk/sandbox/
+
To keep up to date on the latest developments, download fresh copies of
the snapshots regularly or use a working copy of the
`Subversion repository`_.
@@ -350,8 +351,8 @@
two times represents the time required to set up the tests (import
modules, create data structures, etc.).
-If any of the tests fail, please `open a bug report`_, `send email`_,
-or post a message via the `web interface`_ (see `Bugs <BUGS.html>`_).
+If any of the tests fail, please `open a bug report`_ or `send an email`_
+(see `Bugs <BUGS.html>`_).
Please include all relevant output, information about your operating
system, Python version, and Docutils version. To see the Docutils
version, use one of the ``rst2*`` front ends or ``tools/quicktest.py``
@@ -369,10 +370,8 @@
.. _Docutils Testing: http://docutils.sourceforge.net/docs/dev/testing.html
.. _open a bug report:
http://sourceforge.net/p/docutils/bugs/
-.. _send email: mailto:doc...@li...
+.. _send an email: mailto:doc...@li...
?subject=Test%20suite%20failure
-.. _web interface: http://post.gmane.org/post.php
- ?group=gmane.text.docutils.user&subject=Test+suite+failure
Getting Help
Modified: trunk/docutils/docs/user/mailing-lists.txt
===================================================================
--- trunk/docutils/docs/user/mailing-lists.txt 2017-06-03 10:49:13 UTC (rev 8102)
+++ trunk/docutils/docs/user/mailing-lists.txt 2017-06-09 11:02:35 UTC (rev 8103)
@@ -9,8 +9,11 @@
:Copyright: This document has been placed in the public domain.
-.. raw:: html
+.. Gmane went down 2016 and is only partially restored.
+ http://home.gmane.org/2016/08/29/next-steps-gmane/
+ .. raw:: html
+
<div class="sidebar">
<p class="first sidebar-title">Search the list archives on Gmane</p>
<form method="get" action="http://search.gmane.org/">
@@ -39,19 +42,19 @@
Docutils-users
--------------
-The Docutils-users mailing list is a place to discuss any issues
+The `Docutils-users mailing list`_ is a place to discuss any issues
related to the usage of Docutils and reStructuredText. (Please be
sure to check the FAQ_ first.)
-There are three possibilities to **read and post** messages on the
+There are several possibilities to **read and post** messages on the
mailing lists; use the one you feel most comfortable with.
* Using an `email subscription`__. This is the traditional way; you
will receive all messages sent to the mailing list via email.
- __ http://lists.sourceforge.net/lists/listinfo/docutils-users
+ __ `docutils-users mailing list`_
-* Using Gmane's `web interface`__. To post a message, click "post" or
+.. * Using Gmane's `web interface`__. To post a message, click "post" or
"followup" in the drop-down menu on the right. (Gmane also has a
complete **archive** of the mailing list; use the search form at the
top of this page to search it.)
@@ -58,48 +61,54 @@
__ http://news.gmane.org/gmane.text.docutils.user
-* If you prefer to use a newsreader, you can also use Gmane's `NNTP
- interface`__ (gmane.text.docutils.user on news.gmane.org).
+* Use a newsreader with Gmane's `NNTP interface`__
+ (gmane.text.docutils.user on news.gmane.org).
__ nntp://news.gmane.org/gmane.text.docutils.user
-**If you do not wish to subscribe,** you can also just send an email
-message with your question or comment to
-Doc...@li.... Please note in your message
-that you are not subscribed (to make sure that you receive copies
-[CCs] of any replies).
+* **If you do not wish to subscribe,** you can also just send an email
+ message with your question or comment to
+ Doc...@li....
+ Note in your message that you are not subscribed (to make sure that you
+ receive copies [CCs] of any replies) or check for answers in the
+ `Docutils-users Archives`_.
+
The first time you post a message without being subscribed (also when
-posting via Gmane), you will receive an automatic response with the
-subject "Your message to Docutils-users awaits moderator approval";
-this is done to prevent spam to the mailing lists. Your message will
-usually be approved within a few hours. To avoid duplicates, please
-do not resend your message using a different email address. After
-your first message has been approved, your email address will be added
-to the whitelist and future messages will be posted to the mailing
-list without moderation.
+posting via Gmane), you will receive an automatic response with the subject
+"Your message to Docutils-users awaits moderator approval"; this is done to
+prevent spam to the mailing lists. Your message will usually be approved
+within a few hours. To avoid duplicates, please do not resend your message
+using a different email address. After your first message has been
+approved, your email address will be added to the whitelist and future
+messages will be posted to the mailing list without moderation.
+To see the collection of prior postings to the list, visit the
+`Docutils-users Archives`_.
+
Docutils-develop
----------------
Discussions about developing and extending Docutils take place on the
-Docutils-develop mailing list.
+`Docutils-develop mailing list`_.
-You can access this list via `email subscription`__, web__ or news__
+You can access this list via `email subscription`__ or news__
(gmane.text.docutils.devel); the posting address is
Doc...@li....
-__ http://lists.sourceforge.net/lists/listinfo/docutils-develop
-__ http://news.gmane.org/gmane.text.docutils.devel
+To see the collection of prior postings to the list, visit the
+`Docutils-develop Archives`__.
+
+__ `Docutils-develop mailing list`_
__ nntp://news.gmane.org/gmane.text.docutils.devel
+__ http://sourceforge.net/mailarchive/forum.php?forum_name=docutils-develop
-
Docutils-checkins
-----------------
All check-ins to the `Subversion repository`_ cause a "check-in email"
-to the Docutils-checkins list. In order to stay informed about
+to the `Docutils-checkins list`_. In order to stay informed about
current development, developers are advised to monitor this mailing
list.
@@ -107,7 +116,7 @@
about the check-ins to Docutils-develop. (For your convenience, the
Reply-To header of all check-in emails points to Docutils-develop.)
-This mailing list is accessible via `email subscription`__, web__ or
+This mailing list is accessible via `email subscription`__ or
news__ (gmane.text.docutils.cvs) as well.
If you are using an email subscription and you would prefer to only
@@ -115,8 +124,7 @@
distribution (i.e. ``trunk/docutils/*``), go to the `list options`_
page and select the "Docutils core" topic.
-__ http://lists.sourceforge.net/lists/listinfo/docutils-checkins
-__ http://news.gmane.org/gmane.text.docutils.cvs
+__ `Docutils-checkins list`_
__ nntp://news.gmane.org/gmane.text.docutils.cvs
.. _list options: http://lists.sf.net/lists/options/docutils-checkins
@@ -123,19 +131,31 @@
Doc-SIG
-------
-The "Python Documentation Special Interest Group" (Doc-SIG) mailing
-list is occasionally used to discuss the usage of Docutils for Python
+The "Python Documentation Special Interest Group" (`Doc-SIG`_) mailing list
+is occasionally used to discuss the usage of Docutils for Python
documentation.
-This mailing list can be accessed via `email subscription`__, web__ or
+This mailing list can be accessed via `email subscription`__ or
news__ (gmane.comp.python.documentation) as well. You must be
subscribed in order to post messages to this mailing list.
-__ http://mail.python.org/mailman/listinfo/doc-sig
-__ http://news.gmane.org/gmane.comp.python.documentation
+__ `Doc-SIG`_
__ nntp://news.gmane.org/gmane.comp.python.documentation
+.. _Docutils-users mailing list:
+ http://lists.sourceforge.net/lists/listinfo/docutils-users
+.. _Docutils-users Archives:
+ http://sourceforge.net/mailarchive/forum.php?forum_name=docutils-users
+.. _Docutils-develop mailing list:
+ http://lists.sourceforge.net/lists/listinfo/docutils-develop
+.. _Docutils-develop Archives:
+ http://sourceforge.net/mailarchive/forum.php?forum_name=docutils-develop
+.. _Docutils-checkins list:
+ http://lists.sourceforge.net/lists/listinfo/docutils-checkins
+.. _Doc-SIG:
+ http://mail.python.org/mailman/listinfo/doc-sig
+
.. _Subversion repository: ../dev/repository.html
.. _Docutils: http://docutils.sourceforge.net/
.. _FAQ: ../../FAQ.html
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
|
