doc: Shuffle some text around.

* doc/guix.texi: Drop duplicate copyright notice, start section
    "Packaging Guidelines" with existant text.
This commit is contained in:
Andreas Enge 2013-08-28 22:04:52 +02:00
parent 575ed8d5b3
commit da7cabd46b
1 changed files with 31 additions and 44 deletions

View File

@ -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,