Add building section to gnurl page.

1 files changed, 166 insertions, 69 deletions

diff --git a/locale/en/LC_MESSAGES/messages.po b/locale/en/LC_MESSAGES/messages.po
index f7b2808a..26d3cd64 100644
--- a/locale/en/LC_MESSAGES/messages.po
+++ b/locale/en/LC_MESSAGES/messages.po
@@ -52,11 +52,11 @@ msgid ""
 "href='contact.html'>Report issues with this website</a>."
 msgstr ""
 
-#: common/navigation.j2.inc:39 template/index.html.j2:46
+#: common/navigation.j2.inc:39 template/index.html.j2:52
 msgid "About"
 msgstr ""
 
-#: common/navigation.j2.inc:42 template/index.html.j2:378
+#: common/navigation.j2.inc:42 template/index.html.j2:384
 msgid "News"
 msgstr ""
 
@@ -64,7 +64,7 @@ msgstr ""
 msgid "Community"
 msgstr ""
 
-#: common/navigation.j2.inc:50 template/index.html.j2:58
+#: common/navigation.j2.inc:50 template/index.html.j2:64
 msgid "Engage"
 msgstr ""
 
@@ -104,7 +104,7 @@ msgstr ""
 msgid "Documentation"
 msgstr ""
 
-#: common/navigation.j2.inc:86 template/index.html.j2:52
+#: common/navigation.j2.inc:86 template/index.html.j2:58
 #: template/install.html.j2:6
 msgid "Install"
 msgstr ""
@@ -497,7 +497,7 @@ msgid ""
 "org/gauger/\">https://old.gnunet.org/gauger/</a>."
 msgstr ""
 
-#: template/download.html.j2:7 template/gnurl.html.j2:140
+#: template/download.html.j2:7 template/gnurl.html.j2:147
 msgid "Downloads"
 msgstr ""
 
@@ -838,42 +838,134 @@ msgid ""
 msgstr ""
 
 #: template/gnurl.html.j2:128
-msgid ""
-"You can get the Gnurl Git repository using: <!-- https://bugs.gnunet.org/"
-"view.php?id=5483 ! <code>git clone https://git.taler.net/gnurl.git</code> --"
-"> <code>git clone git://git.taler.net/gnurl.git</code> The versions are "
-"checked in as signed git tags."
+msgid "You can get the gnurl git repository using:"
+msgstr ""
+
+#: template/gnurl.html.j2:141
+msgid "The versions are checked in as (signed) git tags."
 msgstr ""
 
-#: template/gnurl.html.j2:142
+#: template/gnurl.html.j2:149
 msgid ""
-"Releases are published on <a href=\"https://ftp.gnu.org/gnu/gnunet/\">ftp."
-"gnu.org/gnu/gnunet</a>. gnURL is available from within a variety of "
-"distributions and package managers. Package Managers which include gnurl "
-"are: <a href=\"https://www.gnu.org/software/guix/\">GNU Guix</a> (available "
-"as \"gnurl\"), <a href=\"https://gentoo.org\">Gentoo</a> through the "
-"collaborative ebuild collection <a href=\"https://git.gnunet.org/"
+"Releases are published on <a href=\"https://ftpmirror.gnu.org/gnu/gnunet/"
+"\">ftpmirror.gnu.org/gnu/gnunet</a>. gnurl is available from within a "
+"variety of distributions and package managers. Package Managers which "
+"include gnurl are: <a href=\"https://www.gnu.org/software/guix/\">GNU Guix</"
+"a> (available as \"gnurl\"), <a href=\"https://gentoo.org\">Gentoo</a> "
+"through the collaborative ebuild collection <a href=\"https://git.gnunet.org/"
 "youbroketheinternet-overlay.git/\">youbroketheinternet</a>, <a href="
-"\"https://nixos.org/nix/\">Nix</a>, and <a href=\"http://pkgsrc.org"
-"\">pkgsrc</a>."
+"\"https://nixos.org/nix/\">Nix</a>, and as www/gnurl in <a href=\"https://"
+"pkgsrc.org\">pkgsrc</a>."
+msgstr ""
+
+#: template/gnurl.html.j2:165
+msgid "Building gnurl"
+msgstr ""
+
+#: template/gnurl.html.j2:167
+msgid ""
+"We suggest to closely follow release announcements, as they might indicate "
+"changes in how gnurl is to be build. <br> If your package manager provides a "
+"binary build or build instructions to build gnurl from source automated and "
+"integrated with your environment, we strongly suggest to use this binary "
+"build. <br> There are two ways to build gnurl. The first one builds from the "
+"most recent git tag, the second one uses the distributed tarball. "
+"Distributors generally are supposed to build from the tarball, but we "
+"describe both methods here. Both methods are written with a NetBSD 9 "
+"userland in mind, substitute tools as necessary. <br> You should <b>avoid</"
+"b> building gnurl from the tip of the default git branch, as only tags are "
+"considered to be stable and approved builds."
+msgstr ""
+
+#: template/gnurl.html.j2:188
+msgid "Building from the distributed tarball (prefered method)"
+msgstr ""
+
+#: template/gnurl.html.j2:190
+msgid ""
+"If you want to verify the signature, install an OpenPGP compatible tool such "
+"as security/gnupgp2 (and set it up). Assuming you use pkgin:"
+msgstr ""
+
+#: template/gnurl.html.j2:204
+msgid "Fetch the signature key from"
+msgstr ""
+
+#: template/gnurl.html.j2:208
+msgid "or via commandline with gnupg2."
+msgstr ""
+
+#: template/gnurl.html.j2:213
+msgid ""
+"Fetch the release, the signature, the checksum file as well as its signature:"
+msgstr ""
+
+#: template/gnurl.html.j2:232
+msgid ""
+"verify the signatures, and verify the checksums against the checksums in "
+"the .sum.txt file."
 msgstr ""
 
-#: template/gnurl.html.j2:157
+#: template/gnurl.html.j2:238
+msgid "unpack the tarball:"
+msgstr ""
+
+#: template/gnurl.html.j2:248
+msgid "Change into the directory"
+msgstr ""
+
+#: template/gnurl.html.j2:258
+msgid "Now you can either run"
+msgstr ""
+
+#: template/gnurl.html.j2:268
+msgid "directly (and read configure-gnurl before you do so) or invoke"
+msgstr ""
+
+#: template/gnurl.html.j2:278
+msgid ""
+"and pass additional parameters such as a custom PREFIX location. Further "
+"reference can be the"
+msgstr ""
+
+#: template/gnurl.html.j2:283
+msgid "Now run"
+msgstr ""
+
+#: template/gnurl.html.j2:293
+msgid "(this is optional)"
+msgstr ""
+
+#: template/gnurl.html.j2:302
+msgid "and you are done."
+msgstr ""
+
+#: template/gnurl.html.j2:306
+msgid "Building from a tagged git commit"
+msgstr ""
+
+#: template/gnurl.html.j2:308
+msgid ""
+"Follow the steps above, but instead of downloading the tarball, clone the "
+"git tag you want to build from."
+msgstr ""
+
+#: template/gnurl.html.j2:318
 msgid "Reporting Bugs"
 msgstr ""
 
-#: template/gnurl.html.j2:159
+#: template/gnurl.html.j2:320
 msgid ""
 "You can report bugs on our bug tracker: <a href=\"https://bugs.gnunet.org/"
 "\">bugs.gnunet.org</a>. Alternatively you can use our bug mailinglist, but "
 "we prefer to track bugs on the bugtracker."
 msgstr ""
 
-#: template/gnurl.html.j2:168
+#: template/gnurl.html.j2:329
 msgid "Maintainer and Cryptographic signatures"
 msgstr ""
 
-#: template/gnurl.html.j2:170
+#: template/gnurl.html.j2:331
 msgid ""
 "gnurl/libgnurl is maintained by ng0. Releases are signed with the OpenPGP "
 "Key <b>A88C8ADD129828D7EAC02E52E22F9BBFEE348588</b>, with the key "
@@ -1335,7 +1427,7 @@ msgid ""
 "Report: <a href=\"gsoc-2018-gnunet-webui.html\">GSoC 2018: GNUnet WebUI</a>"
 msgstr ""
 
-#: template/index.html.j2:12
+#: template/index.html.j2:18
 msgid ""
 "GNUnet is a new network protocol stack for building secure, distributed, and "
 "privacy-preserving applications. With strong roots in academic <a href="
@@ -1344,7 +1436,7 @@ msgid ""
 "stack."
 msgstr ""
 
-#: template/index.html.j2:20
+#: template/index.html.j2:26
 msgid ""
 "GNUnet is typically run as an <a href=\"https://en.wikipedia.org/wiki/"
 "Overlay_network\">overlay network</a> on top of the existing Internet "
@@ -1355,7 +1447,7 @@ msgid ""
 "a>."
 msgstr ""
 
-#: template/index.html.j2:31
+#: template/index.html.j2:37
 msgid ""
 "GNUnet is made for a free and open society: It's a self-organizing network "
 "and it is <a href=\"http://www.gnu.org/philosophy/free-sw.html\">free "
@@ -1364,15 +1456,15 @@ msgid ""
 "compromises."
 msgstr ""
 
-#: template/index.html.j2:72
+#: template/index.html.j2:78
 msgid "The Internet of tomorrow needs GNUnet today"
 msgstr ""
 
-#: template/index.html.j2:78
+#: template/index.html.j2:84
 msgid "Imagine..."
 msgstr ""
 
-#: template/index.html.j2:80
+#: template/index.html.j2:86
 msgid ""
 "The conventional Internet is currently like a system of roads with deep "
 "potholes and highwaymen all over the place. Even if you still can use the "
@@ -1389,11 +1481,11 @@ msgid ""
 "central data base. -->"
 msgstr ""
 
-#: template/index.html.j2:102
+#: template/index.html.j2:108
 msgid "The Internet is broken"
 msgstr ""
 
-#: template/index.html.j2:104
+#: template/index.html.j2:110
 msgid ""
 "Protocols from Ethernet and IP to BGP and X.509 PKI are insecure by default: "
 "protecting against address forgery, routers learning metadata, or choosing "
@@ -1404,7 +1496,7 @@ msgid ""
 "multiple attacks massively threatening our freedom. -->"
 msgstr ""
 
-#: template/index.html.j2:116
+#: template/index.html.j2:122
 msgid ""
 "GNUnet provides <a href=\"https://www.w3.org/2014/strint/papers/65.pdf"
 "\">privacy by design</a>, improving addressing, routing, naming and content "
@@ -1415,11 +1507,11 @@ msgid ""
 "content distribution in a technically robust manner. -->"
 msgstr ""
 
-#: template/index.html.j2:132
+#: template/index.html.j2:138
 msgid "Decentralization is hard"
 msgstr ""
 
-#: template/index.html.j2:135
+#: template/index.html.j2:141
 msgid ""
 "<!-- replaced with Proposal from Fabian Gerlach: It seems as if every other "
 "distributed or P2P project develops its own library stack, covering "
@@ -1430,7 +1522,7 @@ msgid ""
 "potential number of vulnerabilities."
 msgstr ""
 
-#: template/index.html.j2:147
+#: template/index.html.j2:153
 msgid ""
 "GNUnet is a metadata-preserving foundation for your application, covering "
 "areas from addressing to reliable bidirectional Axolotl-encrypted channels, "
@@ -1438,11 +1530,11 @@ msgid ""
 "almost two decades."
 msgstr ""
 
-#: template/index.html.j2:161
+#: template/index.html.j2:167
 msgid "Metadata is exposed"
 msgstr ""
 
-#: template/index.html.j2:163
+#: template/index.html.j2:169
 msgid ""
 "Your metadata is just as revealing as the actual content; and it gets "
 "exposed on the Internet.<br> Even though transport encryption is "
@@ -1458,11 +1550,11 @@ msgid ""
 "routing, and more."
 msgstr ""
 
-#: template/index.html.j2:188
+#: template/index.html.j2:194
 msgid "Freedoms are not respected"
 msgstr ""
 
-#: template/index.html.j2:190
+#: template/index.html.j2:196
 msgid ""
 "Today, monitoring increasingly centralized infrastructure, proprietary "
 "implementations, traffic shapers and firewalls restrict all of the <a href="
@@ -1470,7 +1562,7 @@ msgid ""
 "various degrees."
 msgstr ""
 
-#: template/index.html.j2:199
+#: template/index.html.j2:205
 msgid ""
 "GNUnet gives users freedoms to securely access information (\"run\" the "
 "network), to study all aspects of the network's operation (\"access the code"
@@ -1478,11 +1570,11 @@ msgid ""
 "new applications (\"modify\")."
 msgstr ""
 
-#: template/index.html.j2:211
+#: template/index.html.j2:217
 msgid "Learn more about GNUnet"
 msgstr ""
 
-#: template/index.html.j2:213
+#: template/index.html.j2:219
 msgid ""
 "If you want to know more about the GNUnet please continue reading the <a "
 "href=\"about.html\">about page</a>. There are much more resources, such as "
@@ -1491,7 +1583,7 @@ msgid ""
 "\"https://gnunet.org/en/video.html\">videos</a>."
 msgstr ""
 
-#: template/index.html.j2:222
+#: template/index.html.j2:228
 msgid ""
 "You are very welcome to <a href=\"https://gnunet.org/en/engage.html\"> get "
 "engaged into the conversation</a>, <a href=\"https://gnunet.org/en/install."
@@ -1501,26 +1593,26 @@ msgid ""
 "comes to software &#8211; its not an easy task to rewrite the whole Internet!"
 msgstr ""
 
-#: template/index.html.j2:245
+#: template/index.html.j2:251
 msgid "Featured Applications"
 msgstr ""
 
-#: template/index.html.j2:254
+#: template/index.html.j2:260
 msgid "GNU Taler (Alpha)"
 msgstr ""
 
-#: template/index.html.j2:256
+#: template/index.html.j2:262
 msgid ""
 "<a href=\"https://taler.net/\">GNU Taler</a> is a new privacy-preserving "
 "electronic payment system. Payments are cryptographically secured and are "
 "confirmed within milliseconds with extremely low transaction costs."
 msgstr ""
 
-#: template/index.html.j2:268
+#: template/index.html.j2:274
 msgid "The GNU Name System"
 msgstr ""
 
-#: template/index.html.j2:271
+#: template/index.html.j2:277
 msgid ""
 "The <a href=\"use.html#gns\">GNU Name System (GNS)</a> is a fully "
 "decentralized replacement for the Domain Name System (DNS). Instead of using "
@@ -1531,11 +1623,11 @@ msgid ""
 "efficient and instant key revocation mechanism. -->"
 msgstr ""
 
-#: template/index.html.j2:287
+#: template/index.html.j2:293
 msgid "re:claimID"
 msgstr ""
 
-#: template/index.html.j2:289
+#: template/index.html.j2:295
 msgid ""
 "<a href=\"https://reclaim-identity.io/\">re:claimID</a> is a decentralized "
 "Identity Provider (IdP) service built in top of the GNU Name System. It "
@@ -1543,37 +1635,37 @@ msgid ""
 "standardized protocols (OpenID Connect)."
 msgstr ""
 
-#: template/index.html.j2:302
+#: template/index.html.j2:308
 msgid "Filesharing (Alpha)"
 msgstr ""
 
-#: template/index.html.j2:304
+#: template/index.html.j2:310
 msgid ""
 "GNUnet <a href=\"use.html#fs\">filesharing</a> is an application that aims "
 "to provide censorship-resistant, anonymous filesharing. The publisher is "
 "empowered to make a gradual choice between performance and anonymity."
 msgstr ""
 
-#: template/index.html.j2:315
+#: template/index.html.j2:321
 msgid "Conversation (Pre-Alpha)"
 msgstr ""
 
-#: template/index.html.j2:317
+#: template/index.html.j2:323
 msgid ""
 "GNUnet conversation is an application that provides secure voice "
 "communication in a fully decentralized way by employing GNUnet for routing "
 "and transport."
 msgstr ""
 
-#: template/index.html.j2:334
+#: template/index.html.j2:340
 msgid "Upcoming Applications"
 msgstr ""
 
-#: template/index.html.j2:343
+#: template/index.html.j2:349
 msgid "secushare"
 msgstr ""
 
-#: template/index.html.j2:345
+#: template/index.html.j2:351
 msgid ""
 "<a href=\"https://secushare.org/\">secushare</a> is creating a decentralized "
 "social networking application on top of GNUnet. Using overlay multicast and "
@@ -1581,11 +1673,11 @@ msgid ""
 "encrypted to authorized recipients only."
 msgstr ""
 
-#: template/index.html.j2:357
+#: template/index.html.j2:363
 msgid "pretty Easy privacy"
 msgstr ""
 
-#: template/index.html.j2:359
+#: template/index.html.j2:365
 msgid ""
 "<a href=\"https://pep.foundation/\">pretty Easy privacy</a> (p&#8801;p) is "
 "creating a usable end-to-end encrypted e-mail solution using opportunistic "
@@ -1638,13 +1730,15 @@ msgstr ""
 msgid "Make an installation directory"
 msgstr ""
 
-#: template/install-on-debian9.html.j2:59 template/install-on-macos.html.j2:134
+#: template/install-on-debian9.html.j2:59
+#: template/install-on-macos.html.j2:134
 #: template/install-on-netbsd.html.j2:224
 #: template/install-on-ubuntu1804.html.j2:53
 msgid "Get the source code"
 msgstr ""
 
-#: template/install-on-debian9.html.j2:78 template/install-on-macos.html.j2:142
+#: template/install-on-debian9.html.j2:78
+#: template/install-on-macos.html.j2:142
 #: template/install-on-netbsd.html.j2:232
 #: template/install-on-ubuntu1804.html.j2:61
 msgid "Compile and Install"
@@ -1656,27 +1750,27 @@ msgid "Option 1: GNUnet for testing / usage"
 msgstr ""
 
 #: template/install-on-debian9.html.j2:116
-#: template/install-on-ubuntu1804.html.j2:81
+#: template/install-on-ubuntu1804.html.j2:82
 msgid "Option 2: GNUnet for development"
 msgstr ""
 
 #: template/install-on-debian9.html.j2:153
-#: template/install-on-ubuntu1804.html.j2:96
+#: template/install-on-ubuntu1804.html.j2:97
 msgid "Install GNUnet plugin for name resolution"
 msgstr ""
 
 #: template/install-on-debian9.html.j2:207
-#: template/install-on-ubuntu1804.html.j2:133
+#: template/install-on-ubuntu1804.html.j2:134
 msgid "Create configuration file"
 msgstr ""
 
 #: template/install-on-debian9.html.j2:227
-#: template/install-on-ubuntu1804.html.j2:155
+#: template/install-on-ubuntu1804.html.j2:156
 msgid "Use GNUnet!"
 msgstr ""
 
 #: template/install-on-debian9.html.j2:232
-#: template/install-on-ubuntu1804.html.j2:161
+#: template/install-on-ubuntu1804.html.j2:162
 msgid "Uninstall GNUnet and its dependencies"
 msgstr ""
 
@@ -1692,15 +1786,18 @@ msgstr ""
 msgid "First steps"
 msgstr ""
 
-#: template/install-on-macos.html.j2:109 template/install-on-netbsd.html.j2:182
+#: template/install-on-macos.html.j2:109
+#: template/install-on-netbsd.html.j2:182
 msgid "Alternative: Installation from source"
 msgstr ""
 
-#: template/install-on-macos.html.j2:154 template/install-on-netbsd.html.j2:242
+#: template/install-on-macos.html.j2:154
+#: template/install-on-netbsd.html.j2:242
 msgid "Option 1: GNUnet for production / usage"
 msgstr ""
 
-#: template/install-on-macos.html.j2:187 template/install-on-netbsd.html.j2:267
+#: template/install-on-macos.html.j2:187
+#: template/install-on-netbsd.html.j2:267
 msgid "Option 2: GNUnet experimental"
 msgstr ""