diff options
Diffstat (limited to 'site/download/index.php')
| -rw-r--r-- | site/download/index.php | 81 |
1 files changed, 76 insertions, 5 deletions
diff --git a/site/download/index.php b/site/download/index.php index 3c4b5e0..d2b854f 100644 --- a/site/download/index.php +++ b/site/download/index.php @@ -110,11 +110,6 @@ also includes links to the Git repositories. This shows how to submit patches. </p> <p> - Get in GNU. See <a href="../gnu/">../gnu/</a>. PaulK is working on the build system changes, - we still need to finish transitioning over to Texinfo for the documentation. - <strong>Becoming part of GNU is a #1 priority for the libreboot project.</strong> - </p> - <p> D16 and D8 doesn't boot with GRUB payload, see <a href="https://ticket.coreboot.org/issues/48">https://ticket.coreboot.org/issues/48</a> - workaround: seabios as main payload, compress grub and put that in cbfs too, configure @@ -166,6 +161,82 @@ found in the <a href="../contrib/">contrib</a> page. This could take months though, so probably won't be done before the next release. </p> + <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> + <li>GNU Emacs has decent integration for editing Texinfo documents. See <em>Texinfo mode</em>. + However, any text editor should be fine (the lead developer of libreboot uses Vim).</li> + <li> + i18n should be implemented from the start, so that we can start maintaining versions of the documentation + in non-English languages. GNU Gettext can be used for this. + </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> + Modify the build system, to + directly download the + build dependencies + that libreboot + currently tells the + user to install from + their distribution + package repository. + (Only in Git. Release + archives would have + them already). Build + these from source, + with our own GCC + (re-using coreboot's + GCC, which libreboot + already uses). This + will make <em>complete + corresponding + source</em> 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 <em>libreboot's own version of GCC</em>, 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 |