diff options
Diffstat (limited to 'site/gnu')
| -rw-r--r-- | site/gnu/index.php | 135 |
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); +?> |