aboutsummaryrefslogtreecommitdiff
path: root/docs/index.md
diff options
context:
space:
mode:
authorLeah Rowe <info@minifree.org>2017-04-04 23:28:53 +0000
committerGogs <gogitservice@gmail.com>2017-04-04 23:28:53 +0000
commit2a8d4222cc1a4d2f4ea068da00b7204cde3883d0 (patch)
treea1e6290c5b6e7f09bd43d91718f532b5529d4533 /docs/index.md
parent60af3bd694ce24e15e38263a6a0ad4e6f313ec78 (diff)
parent15ee46bb2995319f2866089b7cf50f467ab223b7 (diff)
downloadlibrebootfr-2a8d4222cc1a4d2f4ea068da00b7204cde3883d0.tar.gz
librebootfr-2a8d4222cc1a4d2f4ea068da00b7204cde3883d0.zip
Merge branch 'leahleah' of libreboot/libreboot into master
Diffstat (limited to 'docs/index.md')
-rw-r--r--docs/index.md136
1 files changed, 38 insertions, 98 deletions
diff --git a/docs/index.md b/docs/index.md
index 1796ae7c..455bb0e2 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,23 +1,16 @@
% Libreboot documentation
-Information about this release can be found at
-[release.html](release.html). Always check
-[libreboot.org](http://libreboot.org) for updates.
+Information about this release can be found at [release.html](release.html).
+Always check [libreboot.org](/) for updates.
-[What is libreboot?](#why)
+Answers to [frequently asked questions about
+Libreboot](https://libreboot.org/faq/).
-[Answers to frequently asked questions about
-Libreboot](https://libreboot.org/faq/)
-
-Libreboot is compatible with GNU+Linux and several BSD systems.
-
-For GNU+Linux, have a look at our [list of GNU+Linux distributions that
-we recommend](distros/).
-
-For BSD, refer to [the libreboot FAQ](https://libreboot.org/faq/#bsd).
-We wish to merge instructions into the official libreboot documentation,
-if someone will provide it. We do have some instructions now for NetBSD,
-FreeBSD and OpenBSD, but they are still incomplete. See [bsd/](bsd/).
+Libreboot is compatible with GNU+Linux and several BSD systems. For BSD, refer
+to [the libreboot FAQ](https://libreboot.org/faq/#bsd). We wish to merge
+instructions into the official libreboot documentation, if someone will provide
+it. We do have some instructions now for NetBSD, FreeBSD and OpenBSD, but they
+are still incomplete. See [bsd/](bsd/).
Installing libreboot
====================
@@ -28,9 +21,6 @@ Installing libreboot
Installing operating systems
============================
-- [List of recommended GNU+Linux distributions for
- libreboot](distros/)
-
- [How to install GNU+Linux on a libreboot system](gnulinux/)
- [How to install BSD on a libreboot system](bsd/)
@@ -44,28 +34,15 @@ Information for developers
Other information
=================
-- [Hardware modifications](hardware/)
- [Miscellaneous](misc/)
About the libreboot project
===========================
-Libreboot is a free BIOS or UEFI replacement ([free as in
-freedom](https://en.wikipedia.org/wiki/Free_software)); libre *boot
-firmware* that initializes the hardware and starts a bootloader for your
-operating system. It's also an open source BIOS, but open source fails
-to promote freedom; *please call libreboot **[free
-software](https://en.wikipedia.org/wiki/Free_software)***.
-
-Libreboot originally began during December 2013, as a commercial effort
-by the [Ministry of Freedom](https://minifree.org) to achieve RYF
-endorsement for a modified ThinkPad X60 (the first system to ever be
-added to libreboot), which it did then achieve.
-
-Back then, the name *libreboot* didn't exist; the project was nameless,
-referring to itself as a *deblobbed version of coreboot*. The project
-named itself libreboot at some point during early 2014, and has since
-rapidly expanded to support more hardware and become more user-friendly.
+Libreboot is a [free](https://en.wikipedia.org/wiki/Free_software) and Open
+Source BIOS or UEFI replacement, initialising the hardware and booting your
+operating system. We are a member of the [Peers Community](https://peers.community/)
+project, an organisation that supports Free Software.
Libreboot is a [coreboot](http://coreboot.org/) distribution (distro)
with proprietary software removed, intended to be a
@@ -100,28 +77,21 @@ The libreboot project has three main goals:
and support. Most people will simply give up before attempting to
install coreboot.
-
+Libreboot attempts to bridge this divide, making sure that everything from
+building to installing coreboot is automated, as much as is feasibly possible.
+Secondly, the project produces documentation aimed at non-technical users.
+Thirdly, the project attempts to provide excellent user support via mailing
+lists and IRC.
- Libreboot attempts to bridge this divide, making sure that
- everything from building to installing coreboot is automated, as
- much as is feasibly possible. Secondly, the project produces
- documentation aimed at non-technical users. Thirdly, the project
- attempts to provide excellent user support via mailing lists and
- IRC.
+Libreboot already comes with a payload (GRUB), flashrom and other
+needed parts. Everything is fully integrated, in a way where most of
+the complicated steps that are otherwise required, are instead done
+for the user in advance.
-
-
- Libreboot already comes with a payload (GRUB), flashrom and other
- needed parts. Everything is fully integrated, in a way where most of
- the complicated steps that are otherwise required, are instead done
- for the user in advance.
-
-
-
- You can download ROM images for your libreboot system and install
- them, without having to build anything from source. The build system
- is also fully automated, so building from source is easy if you
- wanted to do that (for whatever reason).
+You can download ROM images for your libreboot system and install
+them, without having to build anything from source. The build system
+is also fully automated, so building from source is easy if you
+wanted to do that (for whatever reason).
Libreboot is a coreboot distribution, not a coreboot fork
---------------------------------------------------------
@@ -145,16 +115,16 @@ Libreboot is a 'stable' version of coreboot
---------------------------------------------
- Coreboot uses the [rolling
- release](https://en.wikipedia.org/wiki/Rolling_release) model, which
- means that it is not guaranteed to be stable, or to even work at all
- on a given day. Coreboot does have a strict code review process, but
- being such a large project with so many contributors, regressions
- are always possible.
+release](https://en.wikipedia.org/wiki/Rolling_release) model, which
+means that it is not guaranteed to be stable, or to even work at all
+on a given day. Coreboot does have a strict code review process, but
+being such a large project with so many contributors, regressions
+are always possible.
- Libreboot freezes on a particular revision of coreboot, making sure
- that everything works properly, making fixes on top of that and
- repeating this during each subsequent update to a later version of
- coreboot. By doing this, it provides a stronger guarantee to the
- user that the firmware will be reliable, and not break their system.
+that everything works properly, making fixes on top of that and
+repeating this during each subsequent update to a later version of
+coreboot. By doing this, it provides a stronger guarantee to the
+user that the firmware will be reliable, and not break their system.
How do I know what version I'm running?
========================================
@@ -174,7 +144,9 @@ If it exists, you can also extract this *lbversion* file by using the
*cbfstool* utility which libreboot includes, from a ROM image that you
either dumped or haven't flashed yet. In your distribution, run
cbfstool on your ROM image (*libreboot.rom*, in this example):
+
$ ./cbfstool libreboot.rom extract -n lbversion -f lbversion
+
You will now have a file, named *lbversion*, which you can read in
whatever program it is that you use for reading/writing text files.
@@ -210,36 +182,4 @@ Generally speaking, it is advisable to use the latest version of
libreboot.
Copyright © 2014, 2015, 2016 Leah Rowe <info@minifree.org>\
-Permission is granted to copy, distribute and/or modify this document
-under the terms of the Creative Commons Attribution-ShareAlike 4.0
-International license or any later version published by Creative
-Commons; A copy of the license can be found at
-[cc-by-sa-4.0.txt](cc-by-sa-4.0.txt)
-
-Updated versions of the license (when available) can be found at
-<https://creativecommons.org/licenses/by-sa/4.0/legalcode>
-
-UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE EXTENT
-POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS AND
-AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND
-CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS, IMPLIED, STATUTORY,
-OR OTHER. THIS INCLUDES, WITHOUT LIMITATION, WARRANTIES OF TITLE,
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT,
-ABSENCE OF LATENT OR OTHER DEFECTS, ACCURACY, OR THE PRESENCE OR ABSENCE
-OF ERRORS, WHETHER OR NOT KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF
-WARRANTIES ARE NOT ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT
-APPLY TO YOU.
-
-TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE TO YOU
-ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION, NEGLIGENCE) OR
-OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT, INCIDENTAL, CONSEQUENTIAL,
-PUNITIVE, EXEMPLARY, OR OTHER LOSSES, COSTS, EXPENSES, OR DAMAGES
-ARISING OUT OF THIS PUBLIC LICENSE OR USE OF THE LICENSED MATERIAL, EVEN
-IF THE LICENSOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH LOSSES,
-COSTS, EXPENSES, OR DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT
-ALLOWED IN FULL OR IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.
-
-The disclaimer of warranties and limitation of liability provided above
-shall be interpreted in a manner that, to the extent possible, most
-closely approximates an absolute disclaimer and waiver of all liability.
-
+This page is available under the [CC BY SA 4.0](cc-by-sa-4.0.txt)