aboutsummaryrefslogtreecommitdiff
path: root/docs/index.md
diff options
context:
space:
mode:
authorAlyssa Rosenzweig <alyssa@rosenzweig.io>2017-04-04 08:56:58 -0700
committerLeah Rowe <info@minifree.org>2017-04-04 23:48:23 +0100
commit337183ebbd1114346d2261b6eaebc0381b6515ae (patch)
tree7c8ce5cd005f42042b4e50e1ce8bcad91c333469 /docs/index.md
parent8791c95748efa02fd8c998706883a0d23ff0e85e (diff)
downloadlibrebootfr-337183ebbd1114346d2261b6eaebc0381b6515ae.tar.gz
librebootfr-337183ebbd1114346d2261b6eaebc0381b6515ae.zip
Remove hardware modification information; it's out of scope and does not apply to the new models supported
Diffstat (limited to 'docs/index.md')
-rw-r--r--docs/index.md97
1 files changed, 38 insertions, 59 deletions
diff --git a/docs/index.md b/docs/index.md
index f3c1ca18..afd6ffd4 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,23 +1,20 @@
% 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 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/).
+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
====================
@@ -44,28 +41,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 +84,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 +122,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 +151,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.