summaryrefslogtreecommitdiffstats
path: root/site/gnu
diff options
context:
space:
mode:
Diffstat (limited to 'site/gnu')
-rw-r--r--site/gnu/index.php135
1 files changed, 135 insertions, 0 deletions
diff --git a/site/gnu/index.php b/site/gnu/index.php
new file mode 100644
index 0000000..b75b324
--- /dev/null
+++ b/site/gnu/index.php
@@ -0,0 +1,135 @@
+<?php
+/*
+ Frequently asked questions
+ Copyright (C) 2015 Francis Rowe <info@gluglug.org.uk>
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU Affero General Public License as
+ published by the Free Software Foundation, either version 3 of the
+ License, or (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU Affero General Public License for more details.
+
+ You should have received a copy of the GNU Affero General Public License
+ along with this program. If not, see <http://www.gnu.org/licenses/>.
+*/
+ header('Content-type: text/html; charset=utf-8');
+ ob_start();
+ include_once "../common/variables.php";
+ include_once "../common/functions.php";
+?>
+<!DOCTYPE html>
+<html>
+<head>
+ <style type="text/css">
+ <?php echo miniCss(file_get_contents("../common/css/main.css")); ?>
+ </style>
+ <title>GNU Libreboot</title>
+</head>
+
+<body>
+
+ <div id="pagetop">
+
+ <h1>GNU Libreboot</h1>
+ <p>
+ We are working to make libreboot eligible to be added to the <a href="https://gnu.org/">GNU system</a>,
+ and call on the community to help with this effort. <a href="../">Back to home page</a>
+ </p>
+ <p>
+ Firstly, the git repositories (for development) can be found on the <a href="../git/">git page</a>.
+ </p>
+ <p>
+ Libreboot has been 100% philosophically compatible with GNU, from the day the project was founded (our goal is identical to GNU,
+ and our philosophy is identical to the one held by that project), but there are some
+ technical issues with it that make it incompatible with GNU at present.
+ </p>
+ <h2>
+ So far, we have the following tasks to complete (there may be other tasks):
+ </h2>
+ <ul class="c">
+ <li>
+ Convert the documentation to texinfo - partially complete. The docs have been converted using pandoc,
+ but now require a serious cleanup.
+ We wish to merge these into 1 documentation file (manual) in texinfo file.
+ The <a href="https://www.gnu.org/software/texinfo/manual/texinfo/">texinfo manual</a> itself
+ is an example of how we would like to implement the new libreboot documentation. One file, but we
+ will distribute it separated into separate pages/sections,
+ and in other formats in addition to HTML. (info, PDF, etc). The current live documentation on the
+ libreboot website is the old pre-conversion documentation,
+ written in raw HTML. To encourage the transition, we are now refusing all new documentation submissions
+ that are not in texinfo format.
+ <ul>
+ <li>Texinfo is the official documentation format, for all GNU software.</li>
+ </ul>
+ </li>
+ <li>
+ Modify the build system, to make use of standard GNU utilities: make, autoconf and so on. The current build system is
+ non-standard (but well documented), written mostly in BASH.Read these documents:
+ <ul>
+ <li><a href="https://www.gnu.org/prep/standards/html_node/Standard-Targets.html">https://www.gnu.org/prep/standards/html_node/Standard-Targets.html</a></li>
+ <li><a href="https://www.gnu.org/prep/maintain/maintain.html#Distributions">https://www.gnu.org/prep/maintain/maintain.html#Distributions</a></li>
+ </ul>
+ </li>
+ <li>
+ Include ChangeLog and NEWS files in the distribution (in the release archives, but probably uncessary in the git repository).
+ ChangeLog entries can be generated automatically, using the gnulib gitlog-to-changelog script, and the NEWS file can be generated
+ from commit messages.
+ </li>
+ <li>
+ Generally tweak the site and documentation, to more aggressively promote the freedom aspect (the main goal of the GNU project). We already do
+ this to a great extent (especially on the home page), but there are obviously areas for improvement. A lot of the time, we assume
+ that the reader already knows about the free software philosophy, without actually explaining it to them properly. We need to fix that.
+ </li>
+ <li>
+ Document, extensively (and keep it up to date!) full and accurate information about package dependencies, libraries used, etc.
+ We already do this to a great extent (via an installation script for Trisquel and Parabola, and the overall build system in libreboot),
+ but we can do a better job documentation-wise.
+ </li>
+ <li>
+ <s>Re-license the documentation under GNU FDL</s> - DONE!
+ </li>
+ <li>
+ <s>Make libreboot possible to build from source without network access</s> - DONE! (only in release archives.
+ development in git requires network access, for downloading the extra modules that go into the release archives. There is no way to avoid
+ this, due to what libreboot actually is - a boot firmware distribution, combining several projects, much like you have <i>GNU/Linux</i> distributions
+ which are identical in concept).
+ </li>
+ </ul>
+ <h2>
+ Not required, technically, but will make things easier in general, not just for GNU:
+ </h2>
+ <ul class="c">
+ <li>
+ Modify the build system, to directly download (only in git. release archives would have them already) the build dependencies
+ that libreboot currently tells the user to install from their distribution package repository, and build these from source, with
+ our own GCC (re-use coreboot's GCC, which libreboot already uses). This will make <i>complete corresponding source</i> provision easier,
+ because it would be automated; this is in contrast to the present setup, where the person distributing binaries has to include
+ the sources for build dependencies from the distribution that they happened to use for compiling those packages.
+ <ul>
+ <li>This will also make everything self-contained, and coreboot already has integration for cross-compiling. We can make cross compilation
+ of utilities for non-x86 architectures much easier, without relying on quirks from the user's GNU/Linux distribution, where the
+ only thing we need from their distribution is the necessary toolchain for building <i>libreboot's own version of GCC</i>, which would then take over</li>
+ <li>
+ However, do not install these dependencies, only self-host them in the libreboot source archive. Also provide an option for the user to ignore libreboot's
+ GCC and dependencies, and use what their GNU/Linux distribution provides, when building from source.
+ </li>
+ </ul>
+ </li>
+ </ul>
+
+ </div>
+
+<?php
+ include "../common/footer.php";
+?>
+
+</body>
+</html>
+<?php
+ $strHtml = ob_get_clean();
+ echo miniHtml($strHtml);
+?>