web: Re-format the mailing list page and fix the FAQ URLs.
authorWerner Koch <wk@gnupg.org>
Thu, 23 Oct 2014 18:37:06 +0000 (20:37 +0200)
committerWerner Koch <wk@gnupg.org>
Thu, 23 Oct 2014 19:08:23 +0000 (21:08 +0200)
web/documentation/faqs.org
web/documentation/mailing-lists.org

index 38a1c38..3209562 100644 (file)
@@ -4,13 +4,12 @@
 
 * GnuPG Frequently Asked Questions
 
-  The GnuPG FAQ is available in 3 formats:
+  The GnuPG FAQ is available in 2 formats:
 
-  -  [[../faq/gnupg-faq.html][HTML]]
-  -  [[ftp://ftp.gnupg.org/gcrypt/gnupg/GnuPG-FAQ.txt][Text]]
-  -  [[http://git.gnupg.org/cgi-bin/gitweb.cgi?p%3Dgnupg-doc.git%3Ba%3Dblob_plain%3Bf%3Dweb/faq/gnupg-faq.org][Org-mode]]
+  -  [[https://www.gnupg.org/faq/gnupg-faq.html][HTML]]
+  -  [[https://www.gnupg.org/faq/gnupg-faq.txt][Plain text]]
 
-
-  (If you are looking for the old and outdated FAQ, please go to [[http://www-old.gnupg.org/faq/GnuPG-FAQ.html][here]].)
+  The FAQ is generated using this [[http://git.gnupg.org/cgi-bin/gitweb.cgi?p=gnupg-doc.git;a=blob_plain;f=web/faq/gnupg-faq.org][source code]].  If you are looking for
+  the old and outdated FAQ, please go to [[http://www-old.gnupg.org/faq/GnuPG-FAQ.html][here]].
 
 # eof
index 781b0a7..0568542 100644 (file)
@@ -1,76 +1,72 @@
 #+TITLE: GnuPG - Mailing lists
-#+STARTUP: showall
+#+STARTUP: showall indent
 #+SETUPFILE: "../share/setup.inc"
+#+OPTIONS: ^:{}
 
 * Mailing lists
 
-  The contents of all messages sent to these mailing lists are assumed
-  to be in the public domain.  Archives of these mailing lists are
-  also available; please click on the mailing list name below.
+The contents of all messages sent to these mailing lists are assumed
+to be in the public domain.  Archives of these mailing lists are also
+available; please click on the mailing list name below.
 
-  Please check the [[file:faqs.org][FAQ]] before you ask on one of the lists.  If you
-  want to search these mailing lists (as well as other archives)
-  please use the service provided at [[http://marc.info/]].
+Please check the [[file:faqs.org][FAQ]] before you ask on one of the lists.  If you want
+to search these mailing lists (as well as other archives) please use
+the service provided at [[http://marc.info/]].
 
-  - [[http://lists.gnupg.org/pipermail/gnupg-announce/][gnupg-announce@gnupg.org]] :: It is used to announce new releases
-      and for other important messages.
-  - [[http://lists.gnupg.org/pipermail/gnupg-users/][gnupg-users@gnupg.org]] :: It is used as a general discussion and
-      help forum.
-  - [[http://lists.gnupg.org/pipermail/gnupg-devel/][gnupg-devel@gnupg.org]] :: It is used for development and bug
-      tracking.
-  - [[http://lists.gnupg.org/pipermail/gnupg-i18n/][gnupg-i18n@gnupg.org]] :: It is used for discussion of translations
-      and related things.
-  - [[http://lists.gnupg.org/pipermail/gnupg-doc/][gnupg-doc@gnupg.org]] :: is used for the development of
-      the [[guides.org::gph][GNU Privacy Handbook]].
-  - [[http://lists.gnupg.org/pipermail/gcrypt-devel/][gcrypt-devel@gnupg.org]] :: It is used to discuss the development
-      of the GNU crypto library which will be used by a future GnuPG
-      version and is also used by a couple of other projects.
-  - [[http://lists.gnupg.org/pipermail/gpa-dev/][gpa-dev@gnupg.org]] :: It is used to discuss the development of the
-      GNU Privacy Assistant (a graphical frontend for GnuPG).
-  - [[http://lists.gnupg.org/pipermail/gnupg-br/][gnupg-br@gnupg.org]] :: Help and discussion among Portuguese
-      (Brazil) speaking users of GnuPG.
-  - [[http://lists.gnupg.org/pipermail/gnupg-de/][gnupg-de@gnupg.org]] :: Help and discussion among German speaking
-      users of GnuPG.
-  - [[http://lists.gnupg.org/pipermail/gnupg-pt/][gnupg-pt@gnupg.org]] :: Help
-    and discussion among Portuguese speaking users of GnuPG.
-  - [[http://lists.gnupg.org/pipermail/gnupg-es/][gnupg-es@gnupg.org]] :: Help and discussion among Spanish speaking
-       users of GnuPG.
-  - [[http://lists.gnupg.org/pipermail/gnupg-ru/][gnupg-ru@gnupg.org]] :: Help and discussion among Russian speaking
-       users of GnuPG.
+| Name           | Purpose                                     | Lang |
+|----------------+---------------------------------------------+------|
+|                |                                             |      |
+| [[http://lists.gnupg.org/pipermail/gnupg-announce/][gnupg-announce]] | Release announcements (low-traffic)         | en   |
+|                |                                             |      |
+| [[http://lists.gnupg.org/pipermail/gnupg-users/][gnupg-users]]    | General discussion and help                 | en   |
+| [[http://lists.gnupg.org/pipermail/gnupg-br/][gnupg-br]]       | Help among Portuguese/Brazil speaking users | br   |
+| [[http://lists.gnupg.org/pipermail/gnupg-de/][gnupg-de]]       | Help among German speaking users            | de   |
+| [[http://lists.gnupg.org/pipermail/gnupg-pt/][gnupg-pt]]       | Help among Portuguese speaking users        | pt   |
+| [[http://lists.gnupg.org/pipermail/gnupg-es/][gnupg-es]]       | Help among Spanish speaking users           | es   |
+| [[http://lists.gnupg.org/pipermail/gnupg-ru/][gnupg-ru]]       | Help among Russian speaking users           | ru   |
+|                |                                             |      |
+| [[http://lists.gnupg.org/pipermail/gnupg-devel/][gnupg-devel]]    | Development discussion and bug tracking     | en   |
+| [[http://lists.gnupg.org/pipermail/gpa-dev/][gpa-dev]]        | Development of the GNU Privacy Assistant    | en   |
+| [[http://lists.gnupg.org/pipermail/gcrypt-devel/][gcrypt-devel]]   | Development of Libgcrypt                    | en   |
+| [[http://lists.gnupg.org/pipermail/gnupg-doc/][gnupg-doc]]      | Development of documentation                | en   |
+| [[http://lists.gnupg.org/pipermail/gnupg-commits/][gnupg-commits]]  | Commit messages (read-only)                 | en   |
+|                |                                             |      |
+|----------------+---------------------------------------------+------|
 
-  There are also a few mailing lists which receive log information for
-  CVS commits; you will find them under the [[http://lists.gnupg.org/mailman/listinfo/][mailing list manager]].
 
-** How to subscribe
+A complete list of all mailing lists can also be found at our
+[[http://lists.gnupg.org/mailman/listinfo/][mailing list manager]].
 
-   You can subscribe to these lists [[http://lists.gnupg.org/][via web]] or by sending an e-mail:
+You may subscribe to these lists [[http://lists.gnupg.org/][via web]] or by sending an e-mail:
 
 #+begin_example
-   To: <mailing_list>-request@gnupg.org
-   Subject: subscribe
+  To: <mailing_list>-request@gnupg.org
+  Subject: subscribe
 #+end_example
 
-   where /<mailing_list>/ is the name of the mailing list as described
-   above.
+where /<mailing_list>/ is the name of the mailing list as described
+above.
 
-   Posting to these mailing lists is only allowed for subscribers;
-   postings from non-subcribers are held for approval but there is no
-   guarantee that the moderator can approve them in time; they may
-   even be dropped.
+Posting to these mailing lists is only allowed for subscribers;
+postings from non-subscribers are held for approval but there is no
+guarantee that the moderator can approve them in time; they may even
+be dropped.
 
-   Some kinds of postings will not be accepted: e.g. large ones, mails
-   without the list name in the =To:= or =CC:= header and HTML mails.
-   All mail clients have an option to send plain text only messages;
-   try this if you don't get a response.
+Some kinds of postings will not be accepted: e.g. large ones, mails
+without the list name in the =To:= or =CC:= header and HTML mails.
+All mail clients have an option to send plain text only messages; try
+this if you don’t get a response.
 
-   Please write to the mailing lists in English only.
+Please write to the mailing lists in English unless it is language
+specific list.
 
 ** Other discussion groups
 
-   There are also several country-specific mailing-lists to subscribe
-   to.  It is important to note that these mailing-lists are not
-   hosted on GnuPG's servers, but are of great help for all of those
-   who feel more confortable when speaking their own native language.
+There are also several other country-specific mailing-lists to
+subscribe to.  It is important to note that these mailing-lists are
+not hosted on the GnuPG servers, but are of great help for all of
+those who feel more confortable when speaking their own native
+language.
 
-   -  [[http://www.egroups.co.jp/group/gnupgnewsjapan/][GnuPG News Japan]] :: Discussion group for Japanese users.
-   -  [[http://itlists.org/mailman/listinfo/gnupg-it/][gnupg-it]] :: Mailing dedicated to GnuPG users who speak Italian.
+-  [[http://www.egroups.co.jp/group/gnupgnewsjapan/][GnuPG News Japan]] :: Discussion group for Japanese users.
+-  [[http://itlists.org/mailman/listinfo/gnupg-it/][gnupg-it]] :: Mailing dedicated to GnuPG users who speak Italian.