summaryrefslogtreecommitdiffstats
path: root/site/gnu/index.php
blob: fe1490d27f8a97df6bed19d2c3fd22ce9ea63d5d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
<?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>
							<li>GNU Emacs has decent integration for editing Texinfo documents. See <em>Texinfo mode</em>. We should promote use of Emacs
							(the lead develop of libreboot is attempting to learn it). It's also very useful in general. We could document it to a limited
							extent, with quick tips, cheat sheets and links to more guides on other sites.</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>
						<s>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.</s>
					</li>
					<li>
						<s>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.</s> - DONE!
					</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 <em>GNU/Linux</em> 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 <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
	include "../common/footer.php";
?>

</body>
</html>
<?php
	$strHtml = ob_get_clean();
	echo miniHtml($strHtml);
?>