[Savannah-cvs] [537] update links, reword them in a more readable way

[ineiev]

Revision: 537
          
http://svn.savannah.gnu.org/viewvc/?view=rev&root=administration&revision=537
Author:   ineiev
Date:     2023-02-03 13:25:48 -0500 (Fri, 03 Feb 2023)
Log Message:
-----------
update links, reword them in a more readable way

Modified Paths:
--------------
    trunk/sviki/JavaIssues.mdwn
    trunk/sviki/WhyChooseSavannah.mdwn

Modified: trunk/sviki/JavaIssues.mdwn
===================================================================
--- trunk/sviki/JavaIssues.mdwn 2023-02-03 18:24:04 UTC (rev 536)
+++ trunk/sviki/JavaIssues.mdwn 2023-02-03 18:25:48 UTC (rev 537)
@@ -1,11 +1,11 @@
-Requirement
------------
+# Java issues
 
+## Requirement
+
 To host your project at Savannah, your project needs to run under a free
-software Java suite such as [[IcedTea]] or GCJ + GNU Classpath.
+software Java suite such as IcedTea or GCJ + GNU Classpath.
 
-Explanation
------------
+## Explanation
 
 Free Java is moving forward, but not completely yet.
 
@@ -14,19 +14,19 @@
 replaced. Currently this means you need to get "binary blobs" to get a
 fully functionnal Free JDK from Sun.
 
--   <http://www.fsf.org/news/fsf-welcomes-gpl-java.html>:
+-   <https://www.fsf.org/news/fsf-welcomes-gpl-java.html>:
     FSF news
 -   <http://openjdk.java.net/legal/binary-plugs-2007-05-08.html>:
-    the current version still requires non-free parts in non-trivial
+    the current version still requires nonfree parts in non-trivial
     areas such as sound system, font rasterizer, graphics rasterizer,
     SNMP, crypto areas and build system.
--   [[IcedTea]] project provides a harness to build the source code from
-    <http://openjdk.java.net/> using Free
-    Software build tools and provides replacements for the binary plugs
-    with code from the GNU Classpath project."
+-   IcedTea project provides a harness to build the source code from
+    <http://openjdk.java.net/> using free
+    software build tools and provides replacements for the binary plugs
+    with code from the GNU Classpath project.
 
 That's why it is important to rely on a completely free Java suite.
-Until a completely free [[OpenJDK]] is out, relying on Sun's Java is not
+Until a completely free OpenJDK is out, relying on Sun's Java is not
 acceptable yet. A Java suite is made up of 3 parts:
 
 -   a compiler,
@@ -35,24 +35,24 @@
 -   and a Java API library.
 
 (This problem is very similar to the issue that occured a few years ago
-when the Qt library was non-free yet still used by free software
+when the Qt library was nonfree yet still used by free software
 project.)
 
 The free software Java suite we recommend is:
 
--   GCJ, the GNU Compiler for Java, part of the GCC (GNU Compiler
-    Collection). Compiles to either .class or native executables -
-    <http://gcc.gnu.org/>
--   GIJ, the GNU Interpreter for Java, also part of GCC
--   and GNU Classpath, the free replacement for the Java API (the
-    classes in the `java` package) -
-    <http://www.gnu.org/software/classpath/>
+-   GCJ, the GNU Compiler for Java, part of the GCC
+    ([GNU Compiler Collection](//gcc.gnu.org));
+    Compiles to either .class or native executables;
+-   GIJ, the GNU Interpreter for Java, also part of GCC;
+-   and [GNU Classpath](//www.gnu.org/software/classpath/),
+    the free replacement for the Java API (the
+    classes in the `java` package).
 
-### With [[IcedTea]], this becomes:
+### With IcedTea, this becomes:
 
--   Compiler: [[OpenJDK]] javac
--   JVM: [[OpenJDK]] java
--   Class library: [[OpenJDK]] classes minus binary blobs, completed
+-   Compiler: OpenJDK javac
+-   JVM: OpenJDK java
+-   Class library: OpenJDK classes minus binary blobs, completed
     using Classpath and possibly dedicated code
 
 **What we expect is that you make sure your Java application compiles
@@ -64,8 +64,7 @@
 If you did not start coding your project, you should definitely consider
 using another programming language.
 
-FAQ
----
+## FAQ
 
 ### What about blackdown?
 
@@ -79,15 +78,13 @@
 credit card), without garbage collectors or even floats. I think Sun
 actually plays a very small part in it (it's rather a brading job, plus
 applying naming conventions) - and I don't think GCJ can be a free
-replacement for it right now (check
-<http://gcc.gnu.org/ml/java/2005-03/msg00066.html>
-for a bit of background).
+replacement for it right now
+([a bit of background](//gcc.gnu.org/ml/java/2005-03/msg00066.html)).
 
 Sun now plans to release J2ME as free software as well :) This is done
 progressively.
 
-phoneME
-(<https://phoneme.dev.java.net/downloads_page.html>)
+[phoneME](//phoneme.dev.java.net/downloads_page.html)
 is a first free J2ME release, under the GNU GPL (minus some hardware
 support for certain chipsets and devices that Sun's partners didn't
 allow them to release under the GPL).
@@ -94,7 +91,7 @@
 
 ### I carefuly follow the API, and do not make use of the com.sun package. Is 
it enough?
 
-No, you need to test your application and make it works, right now,
+No, you need to test your application and make it work, right now,
 under a free software java suite. Relying on a standard, be it *de
 facto* or *de jure*, does not in itself free your application from
 proprietary dependencies.
@@ -108,17 +105,15 @@
 
 Check the links below for more information.
 
-Further information
--------------------
+## Further information
 
-We recommend you read Richard Stallman's *Free But Shackled - The Java
-Trap* at
-<http://www.gnu.org/philosophy/java-trap.html>,
+We recommend you read Richard Stallman's
+[Free but Shackled - The Java Trap](//www.gnu.org/philosophy/java-trap.html),
 to understand the ethical problem.
 
-For technical help (servets...), the following documentation may be
-useful:
-<http://www.debian.org/doc/manuals/debian-java-faq/>
+For technical help (servets...), the
+[Debian manual](//www.debian.org/doc/manuals/debian-java-faq/) may be
+useful.
 
 Also, the `free-java-sdk` Debian package aims at providing an
 all-working Java environment.

Modified: trunk/sviki/WhyChooseSavannah.mdwn
===================================================================
--- trunk/sviki/WhyChooseSavannah.mdwn  2023-02-03 18:24:04 UTC (rev 536)
+++ trunk/sviki/WhyChooseSavannah.mdwn  2023-02-03 18:25:48 UTC (rev 537)
@@ -1,3 +1,5 @@
+# Why choose Savannah
+
 Savannah has high project approval requirements and thus visitors can
 expect freedom-related qualities from projects hosted here (such as no
 proprietary dependencies). Moreover, there are no advertisements, thus
@@ -6,30 +8,31 @@
 
 By choosing Savannah, you show that you value your freedom, as all of
 Savannah is running exclusively with free software. Check [SourceForge
-Drifting](http://fsfe.org/news/2001/article2001-10-20-01.en.html) by
+Drifting](//fsfe.org/news/2001/article2001-10-20-01.en.html) by
 Savannah founder Loic Dachary, or [GCode's Mercurial
-support](http://googlecode.blogspot.com/2009/04/mercurial-support-for-project-hosting.html)
+support](//googlecode.blogspot.com/2009/04/mercurial-support-for-project-hosting.html)
 based on a private, unpublished fork of the Mercurial server.
 
 Technically, Savannah provides:
 
--   A choice of VCSes (version control systems) for your source code
+-   A choice of version control systems for your source code
     (alphabetical order):
 
-> -   GNU Arch ([[UsingGnuArch]])
-> -   GNU Bazaar ([[UsingBzr]])
-> -   CVS ([[UsingCvs]])
-> -   Git ([[UsingGit]])
-> -   Mercurial ([[UsingHg]])
-> -   Subversion ([[SvN]])
+> -   [[GNU Arch|UsingGnuArch]]
+> -   [[GNU Bazaar|UsingBzr]]
+> -   [[CVS|UsingCvs]]
+> -   [[Git|UsingGit]]
+> -   [[Mercurial|UsingHg]]
+> -   [[Subversion|SvN]]
 
--   The Savane integrated bug tracking system, for bugs, support
-    requests, tasks and patches.
+-   An integrated bug tracking system for bugs, support requests, tasks
+    and patches.
 -   Mailing lists at lists.gnu.org and lists.nongnu.org, managed via
     Mailman.
--   [[Webpages|HomePage]] (at www.gnu.org or www.nongnu.org), managed through 
CVS.
--   A [[download area|DownloadArea]], and its
-    [mirrors](http://download.savannah.gnu.org/releases/00_MIRRORS.html).
+-   [[Webpages|HomePage]] at www.gnu.org or www.nongnu.org, managed through
+    CVS.
+-   A [[download area|DownloadArea]] and its
+    [mirrors](//download.savannah.gnu.org/releases/00_MIRRORS.html).
 
 Videos
 ------
@@ -36,8 +39,8 @@
 
 Savannah was presented at the following events:
 
--   [GNU Hackers Meeting 2009 Gothenburg](http://www.gnu.org/ghm/2009/)
--   [FOSDEM 2010 Brussels](http://www.gnu.org/ghm/2010/fosdem/)
+-   [GNU Hackers Meeting 2009 Gothenburg](//www.gnu.org/ghm/2009/)
+-   [FOSDEM 2010 Brussels](//www.gnu.org/ghm/2010/fosdem/)
     
([alternate](http://video.fosdem.org/2010/lightningtalks/saturday/05-sat-savannah.xvid.avi)
     ([talk](http://www.fosdem.org/2010/schedule/events/gnu_savannah))
 -   LSM/RMLL 2010 Bordeaux (videos in progress)
@@ -49,7 +52,7 @@
 
 Other sites that use Savane and offer free software hosting:
 
--   Puszcza: <http://puszcza.gnu.org.ua/> -
+-   Puszcza: <https://puszcza.gnu.org.ua/> -
     also philosophically compatible, also run by other people (primarily
     Sergey Poznyakoff); located in Ukraine (and pronounced "push-cha")
 
@@ -57,7 +60,7 @@
 
 -   Savane:
     <https://savannah.nongnu.org/p/administration>
-    what we use! (PHP, Perl)
+    what we use! (PHP, Perl, AGPLv3+)
 -   Trac: <http://trac.edgewall.org/> -
     integrated SVN/wiki/tracker for a single project; variants for other
     VCS exists as non-official plugins
@@ -83,8 +86,9 @@
 -   Alioth: <http://alioth.debian.org/> -
     aimed at Debian projects - [code](http://fusionforge.org/)
 -   Launchpad: <https://launchpad.net/> -
-    centered on Bazaar and Ubuntu (Python, AGPL3, but non-free artwork)
+    centered on Bazaar and Ubuntu (Python, AGPL3, but nonfree artwork)
     - [code](http://dev.launchpad.net/Getting)
 -   Allura: <https://allura.apache.org/>
 
-(Note that we do not list projects that advertise a proprietary version)
+(Note that we do not list projects that advertise a proprietary
+version.)