summary refs log tree commit diff
path: root/doc
diff options
context:
space:
mode:
authorMaxim Cournoyer <maxim.cournoyer@gmail.com>2023-05-07 22:49:29 -0400
committerMaxim Cournoyer <maxim.cournoyer@gmail.com>2023-05-07 22:49:29 -0400
commitb7e77446261fdc8dab360d7835a5dec919f6a79f (patch)
tree1ce44f4e3df3b3a27bad802ca06576bb27e79502 /doc
parent9719d7d2b0733c57e30bff3180ff0fa25c34c66f (diff)
downloadguix-b7e77446261fdc8dab360d7835a5dec919f6a79f.tar.gz
Revert "doc: Update all menus."
This reverts commit 9719d7d2b0733c57e30bff3180ff0fa25c34c66f.  It breaks Guix
pull, building the 'guix-manual' for reasons that currently escape me.
Diffstat (limited to 'doc')
-rw-r--r--doc/contributing.texi6
-rw-r--r--doc/guix.texi102
2 files changed, 30 insertions, 78 deletions
diff --git a/doc/contributing.texi b/doc/contributing.texi
index bfb2fd8a13..7bf350ee0d 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -1384,12 +1384,6 @@ should not be delayed.
 When a bug is resolved, please close the thread by sending an email to
 @email{@var{ISSUE_NUMBER}-done@@debbugs.gnu.org}.
 
-@menu
-* Configuring Git::
-* Sending a Patch Series::
-* Teams::
-@end menu
-
 @node Configuring Git
 @subsection Configuring Git
 @cindex git configuration
diff --git a/doc/guix.texi b/doc/guix.texi
index ca0d09a0dc..8fab555e49 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -180,7 +180,7 @@ Weblate} (@pxref{Translating Guix}).
 * Introduction::                What is Guix about?
 * Installation::                Installing Guix.
 * System Installation::         Installing the whole operating system.
-* System Troubleshooting Tips::  When things don't go as planned.
+* System Troubleshooting Tips:: When things don't go as planned.
 * Getting Started::             Your first steps.
 * Package Management::          Package installation, upgrade, etc.
 * Channels::                    Customizing the package collection.
@@ -210,8 +210,8 @@ Weblate} (@pxref{Translating Guix}).
 
 Introduction
 
-* Managing Software the Guix Way::  What's special.
-* GNU Distribution::            The packages and tools.
+* Managing Software the Guix Way::      What's special.
+* GNU Distribution::                    The packages and tools.
 
 Installation
 
@@ -241,14 +241,14 @@ System Installation
 * Installing Guix in a VM::     Guix System playground.
 * Building the Installation Image::  How this comes to be.
 
-Manual Installation
+System Troubleshooting Tips
 
-* Keyboard Layout and Networking and Partitioning::  Initial setup.
-* Proceeding with the Installation::  Installing.
+* Chrooting into an existing system::  Fixing things from a chroot
 
-System Troubleshooting Tips
+Manual Installation
 
-* Chrooting into an existing system::
+* Keyboard Layout and Networking and Partitioning:: Initial setup.
+* Proceeding with the Installation::  Installing.
 
 Package Management
 
@@ -293,7 +293,7 @@ Development
 * Invoking guix environment::   Setting up development environments.
 * Invoking guix pack::          Creating software bundles.
 * The GCC toolchain::           Working with languages supported by GCC.
-* Invoking guix git authenticate::  Authenticating Git repositories.
+* Invoking guix git authenticate:: Authenticating Git repositories.
 
 Programming Interface
 
@@ -309,7 +309,7 @@ Programming Interface
 * Derivations::                 Low-level interface to package derivations.
 * The Store Monad::             Purely functional interface to the store.
 * G-Expressions::               Manipulating build expressions.
-* Invoking guix repl::          Programming Guix in Guile
+* Invoking guix repl::          Programming Guix in Guile.
 * Using Guix Interactively::    Fine-grain interaction at the REPL.
 
 Defining Packages
@@ -344,9 +344,8 @@ Invoking @command{guix build}
 * Debugging Build Failures::    Real life packaging experience.
 
 Foreign Architectures
-
-* Cross-Compilation::           Cross-compiling for another architecture.
-* Native Builds::               Targeting another architecture through native builds.
+* Cross-Compilation::   Cross-compiling for another architecture.
+* Native Builds::       Targeting another architecture through native builds.
 
 System Configuration
 
@@ -369,9 +368,9 @@ System Configuration
 * Running Guix in a VM::        How to run Guix System in a virtual machine.
 * Defining Services::           Adding new service definitions.
 
-File Systems
+Home Environment Configuration
 
-* Btrfs file system::
+* Invoking guix home::          Instantiating a home environment configuration.
 
 Services
 
@@ -389,14 +388,12 @@ Services
 * Mail Services::               IMAP, POP3, SMTP, and all that.
 * Messaging Services::          Messaging services.
 * Telephony Services::          Telephony services.
-* File-Sharing Services::       File-sharing services.
 * Monitoring Services::         Monitoring services.
 * Kerberos Services::           Kerberos services.
 * LDAP Services::               LDAP services.
 * Web Services::                Web servers.
 * Certificate Services::        TLS certificates via Let's Encrypt.
 * DNS Services::                DNS daemons.
-* VNC Services::                VNC daemons.
 * VPN Services::                VPN daemons.
 * Network File System::         NFS related services.
 * Samba Services::              Samba services.
@@ -420,45 +417,18 @@ Defining Services
 * Shepherd Services::           A particular type of service.
 * Complex Configurations::      Defining bindings for complex configurations.
 
-Home Configuration
-
-* Declaring the Home Environment::  Customizing your Home.
-* Configuring the Shell::       Enabling home environment.
-* Home Services::               Specifying home services.
-* Invoking guix home::          Instantiating a home configuration.
-
-Home Services
-
-* Essential Home Services::     Environment variables, packages, on-* scripts.
-* Shells: Shells Home Services.  POSIX shells, Bash, Zsh.
-* Mcron: Mcron Home Service.    Scheduled User's Job Execution.
-* Power Management: Power Management Home Services.  Services for battery power.
-* Shepherd: Shepherd Home Service.  Managing User's Daemons.
-* SSH: Secure Shell.            Setting up the secure shell client.
-* GPG: GNU Privacy Guard.       Setting up GPG and related tools.
-* Desktop: Desktop Home Services.  Services for graphical environments.
-* Guix: Guix Home Services.     Services for Guix.
-* Fonts: Fonts Home Services.   Services for managing User's fonts.
-* Sound: Sound Home Services.   Dealing with audio.
-* Messaging: Messaging Home Services.  Services for managing messaging.
-* Media: Media Home Services.   Services for managing media.
-
 Platforms
 
 * platform Reference::          Detail of platform declarations.
 * Supported Platforms::         Description of the supported platforms.
 
-Creating System Images
+System Images
 
 * image Reference::             Detail of image declarations.
 * Instantiate an Image::        How to instantiate an image record.
 * image-type Reference::        Detail of image types declaration.
 * Image Modules::               Definition of image modules.
 
-@code{image} Reference
-
-* partition Reference::
-
 Installing Debugging Files
 
 * Separate Debug Info::         Installing 'debug' outputs.
@@ -467,7 +437,7 @@ Installing Debugging Files
 Bootstrapping
 
 * Full-Source Bootstrap::       A Bootstrap worthy of GNU.
-* Preparing to Use the Bootstrap Binaries::  Building that what matters most.
+* Preparing to Use the Bootstrap Binaries:: Building that what matters most.
 
 @end detailmenu
 @end menu
@@ -498,8 +468,8 @@ readily available through the @command{guix system} command, even if you're
 using a different distro underneath!}.  @xref{GNU Distribution}.
 
 @menu
-* Managing Software the Guix Way::  What's special.
-* GNU Distribution::            The packages and tools.
+* Managing Software the Guix Way::      What's special.
+* GNU Distribution::                    The packages and tools.
 @end menu
 
 @node Managing Software the Guix Way
@@ -2444,7 +2414,7 @@ Guix System.  This means that you can install additional packages, should you
 need it, using @command{guix package} (@pxref{Invoking guix package}).
 
 @menu
-* Keyboard Layout and Networking and Partitioning::  Initial setup.
+* Keyboard Layout and Networking and Partitioning:: Initial setup.
 * Proceeding with the Installation::  Installing.
 @end menu
 
@@ -2942,10 +2912,6 @@ from there.  Such technique is explained below.
 @cindex chroot, guix system
 @cindex chrooting, guix system
 @cindex repairing GRUB, via chroot
-@menu
-* Chrooting into an existing system::
-@end menu
-
 @node Chrooting into an existing system
 @section Chrooting into an existing system
 
@@ -5963,7 +5929,7 @@ easily distributed to users who do not run Guix.
 * Invoking guix environment::   Setting up development environments.
 * Invoking guix pack::          Creating software bundles.
 * The GCC toolchain::           Working with languages supported by GCC.
-* Invoking guix git authenticate::  Authenticating Git repositories.
+* Invoking guix git authenticate:: Authenticating Git repositories.
 @end menu
 
 @node Invoking guix shell
@@ -16197,8 +16163,8 @@ requires emulation, using the QEMU program for instance.
 @end enumerate
 
 @menu
-* Cross-Compilation::           Cross-compiling for another architecture.
-* Native Builds::               Targeting another architecture through native builds.
+* Cross-Compilation::   Cross-compiling for another architecture.
+* Native Builds::       Targeting another architecture through native builds.
 @end menu
 
 @node Cross-Compilation
@@ -17112,10 +17078,6 @@ operating system configuration.  See the examples above.
 @end defun
 
 
-@menu
-* Btrfs file system::
-@end menu
-
 @node Btrfs file system
 @subsection Btrfs file system
 
@@ -41791,9 +41753,9 @@ still in an experimental stage, though.
 
 @menu
 * Declaring the Home Environment::  Customizing your Home.
-* Configuring the Shell::       Enabling home environment.
-* Home Services::               Specifying home services.
-* Invoking guix home::          Instantiating a home configuration.
+* Configuring the Shell::     Enabling home environment.
+* Home Services::             Specifying home services.
+* Invoking guix home::        Instantiating a home configuration.
 @end menu
 
 @node Declaring the Home Environment
@@ -43809,10 +43771,10 @@ This chapter explains how to define customized system images and how to
 turn them into actual bootable images.
 
 @menu
-* image Reference::             Detail of image declarations.
-* Instantiate an Image::        How to instantiate an image record.
-* image-type Reference::        Detail of image types declaration.
-* Image Modules::               Definition of image modules.
+* image Reference::        Detail of image declarations.
+* Instantiate an Image::   How to instantiate an image record.
+* image-type Reference::   Detail of image types declaration.
+* Image Modules::          Definition of image modules.
 @end menu
 
 @node image Reference
@@ -43903,10 +43865,6 @@ defaults to @code{true}.
 @end table
 @end deftp
 
-@menu
-* partition Reference::
-@end menu
-
 @node partition Reference
 @subsection @code{partition} Reference
 
@@ -44751,7 +44709,7 @@ Binaries}).
 
 @menu
 * Full-Source Bootstrap::       A Bootstrap worthy of GNU.
-* Preparing to Use the Bootstrap Binaries::  Building that what matters most.
+* Preparing to Use the Bootstrap Binaries:: Building that what matters most.
 @end menu
 
 @node Full-Source Bootstrap