doc: Shuffle some text around.
* doc/guix.texi: Drop duplicate copyright notice, start section "Packaging Guidelines" with existant text.
This commit is contained in:
parent
575ed8d5b3
commit
da7cabd46b
|
@ -23,6 +23,7 @@
|
||||||
@title GNU Guix Reference Manual
|
@title GNU Guix Reference Manual
|
||||||
@subtitle Using the GNU Guix Functional Package Manager
|
@subtitle Using the GNU Guix Functional Package Manager
|
||||||
@author Ludovic Courtès
|
@author Ludovic Courtès
|
||||||
|
@author Andreas Enge
|
||||||
@author Nikita Karetnikov
|
@author Nikita Karetnikov
|
||||||
|
|
||||||
@page
|
@page
|
||||||
|
@ -30,7 +31,7 @@
|
||||||
Edition @value{EDITION} @*
|
Edition @value{EDITION} @*
|
||||||
@value{UPDATED} @*
|
@value{UPDATED} @*
|
||||||
|
|
||||||
Copyright @copyright{} @value{YEARS} Ludovic Court@`es
|
Copyright @copyright{} @value{YEARS} Ludovic Court@`es, Andreas Enge, Nikita Karetnikov
|
||||||
|
|
||||||
@quotation
|
@quotation
|
||||||
Permission is granted to copy, distribute and/or modify this document
|
Permission is granted to copy, distribute and/or modify this document
|
||||||
|
@ -64,17 +65,6 @@ Documentation License.''
|
||||||
This document describes GNU Guix version @value{VERSION}, a functional
|
This document describes GNU Guix version @value{VERSION}, a functional
|
||||||
package management tool written for the GNU system.
|
package management tool written for the GNU system.
|
||||||
|
|
||||||
@quotation
|
|
||||||
Copyright @copyright{} @value{YEARS} Ludovic Courtès
|
|
||||||
|
|
||||||
Permission is granted to copy, distribute and/or modify this document
|
|
||||||
under the terms of the GNU Free Documentation License, Version 1.3 or
|
|
||||||
any later version published by the Free Software Foundation; with no
|
|
||||||
Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
|
|
||||||
copy of the license is included in the section entitled ``GNU Free
|
|
||||||
Documentation License.''
|
|
||||||
@end quotation
|
|
||||||
|
|
||||||
@menu
|
@menu
|
||||||
* Introduction:: What is Guix about?
|
* Introduction:: What is Guix about?
|
||||||
* Installation:: Installing Guix.
|
* Installation:: Installing Guix.
|
||||||
|
@ -1502,7 +1492,7 @@ tools that help users exert that freedom.
|
||||||
@menu
|
@menu
|
||||||
* Installing Debugging Files:: Feeding the debugger.
|
* Installing Debugging Files:: Feeding the debugger.
|
||||||
* Package Modules:: Packages from the programmer's viewpoint.
|
* Package Modules:: Packages from the programmer's viewpoint.
|
||||||
* Adding New Packages:: Growing the distribution.
|
* Packaging Guidelines:: Growing the distribution.
|
||||||
* Bootstrapping:: GNU/Linux built from scratch.
|
* Bootstrapping:: GNU/Linux built from scratch.
|
||||||
* Porting:: Targeting another platform or kernel.
|
* Porting:: Targeting another platform or kernel.
|
||||||
@end menu
|
@end menu
|
||||||
|
@ -1587,41 +1577,14 @@ distribution. The root of this dependency graph is a small set of
|
||||||
bootstrap)} module. For more information on bootstrapping,
|
bootstrap)} module. For more information on bootstrapping,
|
||||||
@ref{Bootstrapping}.
|
@ref{Bootstrapping}.
|
||||||
|
|
||||||
@node Adding New Packages
|
@node Packaging Guidelines
|
||||||
@section Adding New Packages
|
@section Packaging Guidelines
|
||||||
|
|
||||||
The GNU distribution is nascent and may well lack some of your favorite
|
The GNU distribution is nascent and may well lack some of your favorite
|
||||||
packages. This section describes how you can help make the distribution
|
packages. This section describes how you can help make the distribution
|
||||||
grow. @ref{Contributing}, for additional information on how you can
|
grow. @ref{Contributing}, for additional information on how you can
|
||||||
help.
|
help.
|
||||||
|
|
||||||
@menu
|
|
||||||
* Packaging Guidelines:: What goes into the distribution.
|
|
||||||
* From the Source Tarball to the Package:: The story of a package.
|
|
||||||
@end menu
|
|
||||||
|
|
||||||
@node Packaging Guidelines
|
|
||||||
@subsection Packaging Guidelines
|
|
||||||
|
|
||||||
@c Adapted from http://www.gnu.org/philosophy/philosophy.html.
|
|
||||||
|
|
||||||
The GNU operating system has been developed so that users can have
|
|
||||||
freedom in their computing. GNU is @dfn{free software}, meaning that
|
|
||||||
users have the @url{http://www.gnu.org/philosophy/free-sw.html,four
|
|
||||||
essential freedoms}: to run the program, to study and change the program
|
|
||||||
in source code form, to redistribute exact copies, and to distribute
|
|
||||||
modified versions. Packages found in the GNU distribution provide only
|
|
||||||
software that conveys these four freedoms.
|
|
||||||
|
|
||||||
In addition, the GNU distribution follow the
|
|
||||||
@url{http://www.gnu.org/distros/free-system-distribution-guidelines.html,free
|
|
||||||
software distribution guidelines}. Among other things, these guidelines
|
|
||||||
reject non-free firmware, recommendations of non-free software, and
|
|
||||||
discuss ways to deal with trademarks and patents.
|
|
||||||
|
|
||||||
@node From the Source Tarball to the Package
|
|
||||||
@subsection From the Source Tarball, to the Package Definition, to the Binary Package
|
|
||||||
|
|
||||||
Free software packages are usually distributed in the form of
|
Free software packages are usually distributed in the form of
|
||||||
@dfn{source code tarballs}---typically @file{tar.gz} files that contain
|
@dfn{source code tarballs}---typically @file{tar.gz} files that contain
|
||||||
all the source files. Adding a package to the distribution means
|
all the source files. Adding a package to the distribution means
|
||||||
|
@ -1667,6 +1630,30 @@ package automatically downloads binaries from there (except when using
|
||||||
needed is to review and apply the patch.
|
needed is to review and apply the patch.
|
||||||
|
|
||||||
|
|
||||||
|
@menu
|
||||||
|
* Software Freedom:: What may go into the distribution.
|
||||||
|
@end menu
|
||||||
|
|
||||||
|
@node Software Freedom
|
||||||
|
@subsection Software Freedom
|
||||||
|
|
||||||
|
@c Adapted from http://www.gnu.org/philosophy/philosophy.html.
|
||||||
|
|
||||||
|
The GNU operating system has been developed so that users can have
|
||||||
|
freedom in their computing. GNU is @dfn{free software}, meaning that
|
||||||
|
users have the @url{http://www.gnu.org/philosophy/free-sw.html,four
|
||||||
|
essential freedoms}: to run the program, to study and change the program
|
||||||
|
in source code form, to redistribute exact copies, and to distribute
|
||||||
|
modified versions. Packages found in the GNU distribution provide only
|
||||||
|
software that conveys these four freedoms.
|
||||||
|
|
||||||
|
In addition, the GNU distribution follow the
|
||||||
|
@url{http://www.gnu.org/distros/free-system-distribution-guidelines.html,free
|
||||||
|
software distribution guidelines}. Among other things, these guidelines
|
||||||
|
reject non-free firmware, recommendations of non-free software, and
|
||||||
|
discuss ways to deal with trademarks and patents.
|
||||||
|
|
||||||
|
|
||||||
@node Bootstrapping
|
@node Bootstrapping
|
||||||
@section Bootstrapping
|
@section Bootstrapping
|
||||||
|
|
||||||
|
@ -1836,8 +1823,8 @@ reason.
|
||||||
This project is a cooperative effort, and we need your help to make it
|
This project is a cooperative effort, and we need your help to make it
|
||||||
grow! Please get in touch with us on @email{guix-devel@@gnu.org}. We
|
grow! Please get in touch with us on @email{guix-devel@@gnu.org}. We
|
||||||
welcome ideas, bug reports, patches, and anything that may be helpful to
|
welcome ideas, bug reports, patches, and anything that may be helpful to
|
||||||
the project. We particularly welcome help on packaging (@pxref{Adding
|
the project. We particularly welcome help on packaging
|
||||||
New Packages}).
|
(@pxref{Packaging Guidelines}).
|
||||||
|
|
||||||
Please see the
|
Please see the
|
||||||
@url{http://git.savannah.gnu.org/cgit/guix.git/tree/HACKING,
|
@url{http://git.savannah.gnu.org/cgit/guix.git/tree/HACKING,
|
||||||
|
|
Loading…
Reference in New Issue