This simplifies use of images created with 'guix system docker-image'.

* gnu/system/vm.scm (system-docker-image)[boot-program]: New variable.
[os]: Add it to the GC roots.
[build]: Pass #:entry-point to 'build-docker-image'.
* gnu/tests/docker.scm (run-docker-system-test): New procedure.
(%test-docker-system): New variable.
* doc/guix.texi (Invoking guix system): Remove GUIX_NEW_SYSTEM hack and
'--entrypoint' from the example.  Mention 'docker create', 'docker
start', and 'docker exec'.

* doc/guix.texi (Desktop Services): Mention ModemManager here.

Signed-off-by: Ludovic Courtès <ludo@gnu.org>

* gnu/system/linux-container.scm (container-essential-services): If network is
to be shared with the host, remove network configuration files from etc
service.
(containerized-operating-system): If network is to be shared with the host,
remove nscd service and map host's /var/run/nscd if it exists.
(container-script): If network is to be shared with the host, do not create
network namespace.
* guix/scripts/system.scm (system-derivation-for-action): Add
#:container-shared-network? argument.
(perform-action): Add #:container-shared-network? argument.
(show-help): Add "-N, --network" help information.
(%options): Add network option.
(process-action): Call perform-action with #container-shared-network? argument.
* doc/guix.texi (Invoking guix system): Document the "-N, --network" option.

Co-authored-by: Christopher Baines <mail@cbaines.net>

* doc/guix.texi (Top): Mention the Russian translation.

* doc/guix.texi (GNU Distribution): Remove "experimental" bit for
AArch64.  Mark "mips64el-linux" as "no longer fully supported."

* doc/guix.texi (shepherd-service): Document 'auto-start?' field.

Signed-off-by: Ludovic Courtès <ludo@gnu.org>

* doc/guix.texi (shepherd-service): Replace 'requirements' with 'requirement'.

Signed-off-by: Arun Isaac <arunisaac@systemreboot.net>

* doc/guix.texi (cargo-build-system): Correct Carto.toml.

Signed-off-by: Arun Isaac <arunisaac@systemreboot.net>

* gnu/services/mail.scm (dovecot-configuration)[auth-verbose-passwords?]:
Rename to auth-verbose-passwords, and change the type to a string, as this
parameter can take one of three string values.
* doc/guix.texi (Dovecot service): Update the corresponding documentation.

* doc/guix.texi (X Window): Mention 'display' and 'vt' fields of
  'slim-configuration' and explain how to use them to add multiple SLiM
  services to system services.

Signed-off-by: Ludovic Courtès <ludo@gnu.org>

* doc/guix.texi (VM): Add missing dot.

Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>

* doc/guix.texi (xfce-desktop-service-type): Fix sentence.

Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>

* doc/guix.texi (page-log@files-configuration@CUPS): "Page log" instead of
"access log".

Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>

* doc/guix.texi (set-xorg-configuration): Add missing @code tag.
(error-log@files-configuration@CUPS): "Error log" instead of "access log".

Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>

* doc/guix.texi (rsync-service-type): Add missing sentence.

Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>

* doc/guix.texi (openntpd-configuration): Fix spelling issues.

Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>

* doc/guix.texi (rakudo-build-system, libvirt-configuration,
pam-krb5): Missing period between sentences.
(gnu services vpn): Fix server spelling.
(agetty-configuration): Add missing subject in the sentence.
(udev-service): Fix markup for Scheme procedures.
({gnome,xfce,mate}-desktop-service): Add missing colon after default.

Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>

* doc/guix.texi (Defining Packages): Reference to 'autoconf' instead of
obsolete 'configure' manual for triplets.
(Additional Build Options): Adjust 'autoconf' node name.

Fixes <https://bugs.gnu.org/35537>.
Reported by Andy Tai <atai@atai.org>.

* doc/guix.texi (Running Guix in a VM): Use @url and provide the actual
URL, without @var{system}.

* doc/guix.texi: Use HTTPS where possible.

* config-daemon.ac: Replace "ci.guix.info" with "ci.guix.gnu.org".
* doc/guix.texi (SUBSTITUTE-SERVER): Likewise.
* etc/substitutes/ci.guix.gnu.org.pub: New file.
* Makefile.am (dist_pkgdata_DATA): Add it.
* guix/scripts/build.scm (%default-log-urls): Update.
* guix/scripts/substitute.scm (%default-substitute-urls): Likewise.
* guix/store.scm (%default-substitute-urls): Likewise.
* guix/self.scm (miscellaneous-files): Add "ci.guix.gnu.org".

* guix/scripts/search.scm: New file.
* Makefile.am (MODULES): Add it.
* po/guix/POTFILES.in: Add it.
* tests/guix-package-aliases.sh: Add test.
* doc/guix.texi (Invoking guix package): Document it and use it in a
couple of examples.

* guix/build/syscalls.scm (MS_NOATIME): New variable.
* gnu/build/file-systems.scm (mount-flags->bit-mask): Support it.
* doc/guix.texi (File Systems): Document it and add cross-references to
the relevant documentation.

Co-authored-by: Ludovic Courtès <ludo@gnu.org>

* doc/guix.texi (Invoking guix package)
(Official Substitute Server, System Configuration): Replace "the Guix
System Distribution" by "Guix System".

* doc/guix.texi (SUBSTITUTE-SERVER): New variable.
(Invoking guix weather): Use it.

* guix/scripts/install.scm, guix/scripts/remove.scm,
guix/scripts/upgrade.scm, tests/guix-package-aliases.sh: New files.
* Makefile.am (MODULES, SH_TESTS): Add them.
* po/guix/POTFILES.in: Add them.
* guix/scripts/package.scm (guix-package): Split with...
(guix-package*): ... this.  New procedure.
* doc/guix.texi (Invoking guix package): Document them.
(Binary Installation, Application Setup, Package Management)
(Packages with Multiple Outputs, Package Modules)
(X.509 Certificates, Installing Debugging Files): Use 'guix install' in
simple examples.
* etc/completion/bash/guix (_guix_complete): Handle "install", "remove",
and "upgrade".

Since our web site points to "Binary Installation", it's best to have
that note there.

* doc/guix.texi (Binary Installation): Add note about guix-install.sh.

This is a followup to e9926f80.

* doc/guix.texi (Binary Installation): Remove paragraph about not
removing 'guix' from root's profile.

* doc/guix.texi (Running Guix in a VM): Suggest -m 1024.

* doc/guix.texi (Running Guix in a VM): Remove mentions of 'lsh-server';
mention 'openssh-service-type' and add a cross-reference.
* gnu/system/examples/vm-image.tmpl (services): Add a commented-out line
for 'openssh-service-type'.

* doc/guix.texi (Running Guix in a VM): Recommend virtio-blk to access
the image.

* gnu/services/dns.scm (knot-zone-configuration)[zonefile-load]
[journal-content, max-journal-usage, max-journal-depth, max-zone-size]:
New fields.
(knot-zone-config): Serialize them.
* doc/guix.texi (DNS Services): Document them.

From now on, everything will be uploaded to ftp.gnu.org instead of
alpha.gnu.org.

* doc/guix.texi (BASE-URL): Switch to ftp.gnu.org.

* doc/guix.texi (BASE-URL): New variable.
(Binary Installation, USB Stick and DVD Installation)
(Running Guix in a VM): Use it instead of hard-coded URL.

* gnu/system/examples/vm-image.tmpl: Rewrite.
* doc/guix.texi (Running Guix in a VM): Adjust accordingly.

* gnu/services/dns.scm (knot-configuration): Add includes field.
(verify-knot-configuration): Check includes content.
(knot-config-file): Serialize includes.
* doc/guix.texi (DNS Services): Document it.

* gnu/services/certbot.scm (certificate-configuration): Add challenge,
auth-hook and cleanup-hook fields.
(certbot-command): Use them.
* doc/guix.texi (Certificate Services): Document them.

* doc/guix.texi (Top): Mention Simplified Chinese and Spanish.

* gnu/services/shepherd.scm (<shepherd-service>)[one-shot?]: New field.
(shepherd-service-file): Pass #:one-shot? to the <service> constructor.
* doc/guix.texi (Shepherd Services): Document it.

This improves the readability of the boot process, especially when using full
disk encryption where you're required to enter the passphrase at a particular
point.

* gnu/system.scm (<operating-system>)[kernel-arguments]: Change the default to
'("quiet").
* doc/guix.texi (operating-system Reference): Document this change.