[elbe-devel] [PATCH 9/9] docs: sphinx: drop autogenerated anchors
Thomas Weißschuh
thomas.weissschuh at linutronix.de
Mon Apr 8 15:08:44 CEST 2024
These are leftovers from the conversion of asciidoc to reST and not
needed.
They only generate a lot of warnings like the following:
docs/elbe-validate.rst:50: WARNING: duplicate label _elbe, other instance in docs/elbe-updated.rst
Signed-off-by: Thomas Weißschuh <thomas.weissschuh at linutronix.de>
---
docs/article-elbeoverview-en.rst | 44 ----------------------------------------
docs/article-quickstart.rst | 42 --------------------------------------
docs/elbe-add.rst | 12 -----------
docs/elbe-buildchroot.rst | 12 -----------
docs/elbe-buildsdk.rst | 10 ---------
docs/elbe-buildsysroot.rst | 12 -----------
docs/elbe-check_updates.rst | 12 -----------
docs/elbe-chg_archive.rst | 12 -----------
docs/elbe-chroot.rst | 12 -----------
docs/elbe-control.rst | 16 ---------------
docs/elbe-daemon.rst | 10 ---------
docs/elbe-db.rst | 12 -----------
docs/elbe-debianize.rst | 6 ------
docs/elbe-diff.rst | 10 ---------
docs/elbe-fetch_initvm_pkgs.rst | 10 ---------
docs/elbe-gen_update.rst | 12 -----------
docs/elbe-genlicence.rst | 12 -----------
docs/elbe-get_archive.rst | 12 -----------
docs/elbe-hdimg.rst | 12 -----------
docs/elbe-init.rst | 12 -----------
docs/elbe-initvm.rst | 18 ----------------
docs/elbe-mkcdrom.rst | 12 -----------
docs/elbe-parselicence.rst | 24 ----------------------
docs/elbe-pbuilder.rst | 20 ------------------
docs/elbe-pkgdiff.rst | 10 ---------
docs/elbe-preprocess.rst | 10 ---------
docs/elbe-prjrepo.rst | 14 -------------
docs/elbe-remove_sign.rst | 12 -----------
docs/elbe-repodir.rst | 12 -----------
docs/elbe-setsel.rst | 12 -----------
docs/elbe-show.rst | 12 -----------
docs/elbe-sign.rst | 12 -----------
docs/elbe-toolchainextract.rst | 12 -----------
docs/elbe-updated.rst | 12 -----------
docs/elbe-validate.rst | 12 -----------
docs/elbe.rst | 12 -----------
36 files changed, 508 deletions(-)
diff --git a/docs/article-elbeoverview-en.rst b/docs/article-elbeoverview-en.rst
index 70d957830250..fcff49e27fcb 100644
--- a/docs/article-elbeoverview-en.rst
+++ b/docs/article-elbeoverview-en.rst
@@ -4,8 +4,6 @@ ELBE Overview
Debian-based system to generate root filesystems for embedded devices.
-.. _`_general_notes`:
-
General Notes
=============
@@ -48,8 +46,6 @@ Elbe takes a different approach to solve these problems:
- Updating, adding, or removing a package is done via Debian’s
package-management (apt) which also resolves package dependencies.
-.. _`_overview`:
-
Overview
========
@@ -115,8 +111,6 @@ will cause problems during installation. This typically includes
database application packages, which set up a database in their postinst
script and rely on the database server to be already running.
-.. _`_create_initvm_and_build_a_first_xml_file_from_the_examples`:
-
Create initvm and build a first xml file from the examples
==========================================================
@@ -150,8 +144,6 @@ If you need to start the initvm again, use
elbe initvm start --directory ~/elbe-initvm
-.. _`_example_xml_files`:
-
Example XML Files
-----------------
@@ -221,8 +213,6 @@ initvm has not been created yet, use:
elbe initvm create --directory ~/elbe-initvm example.xml
-.. _`_passwords_in_xml`:
-
Passwords in XML
----------------
@@ -282,8 +272,6 @@ must be given in plain-text. This plain-text password will not be
removed by the preprocessing and will stay also in the generated XML
files ``/etc/elbe_base.xml`` and ``source.xml``.
-.. _`_changing_the_subset_that_is_extracted_as_the_root_filesystem`:
-
Changing the subset that is extracted as the root filesystem
============================================================
@@ -300,8 +288,6 @@ root-filesystem.
- The embedded archive.
-.. _`_finetuning`:
-
Finetuning
----------
@@ -372,8 +358,6 @@ example finetuning section:
The copy, mv, and rm commands operate on full directories.
-.. _`_useful_directories_to_trim_with_finetuning`:
-
Useful directories to trim with finetuning
------------------------------------------
@@ -414,8 +398,6 @@ to get a smaller target image.
- debconf cache is also not necessary
-.. _`_archive`:
-
Archive
-------
@@ -431,8 +413,6 @@ command can be used to embed the archive into the XML file:
This feature is useful to place custom configuration-files into the
final image.
-.. _`_slimming_the_root_filesystem_with_the_different_modes`:
-
Slimming the root filesystem with the different modes
=====================================================
@@ -464,8 +444,6 @@ configured.
</target>
-.. _`_install_recommends`:
-
install-recommends
------------------
@@ -478,8 +456,6 @@ This is not strictly a mode as described in the following paragraphs. It
can be combined with any of them, and the following modes are mutually
exclusive.
-.. _`_default`:
-
default
-------
@@ -487,8 +463,6 @@ The default mode generates a full copy of the build image. This mode is
the easiest to use, but its not possible to generate images which have
the Debian package management removed.
-.. _`_setsel`:
-
setsel
------
@@ -519,8 +493,6 @@ The setsel mode works by feeding the pkg list to
that there is no need to cope with some unregistered configuration
files.
-.. _`_diet`:
-
diet
----
@@ -542,8 +514,6 @@ Do not use this for normal filesystems.
This also holds for the *tighten* mode.
-.. _`_tighten`:
-
tighten
-------
@@ -551,8 +521,6 @@ Tighten mode only extracts the files referenced by the packages in
*pkg-list*. No dependencies are resolved. This mode is intended for
compatibility with old XML files, do not use in new elbe projects.
-.. _`_cdrom_functionality`:
-
CDROM Functionality
===================
@@ -566,8 +534,6 @@ can also serve as an installation source.
<cdrom>/home/user/elbe-example/install.iso</cdrom>
</mirror>
-.. _`_install_reports`:
-
Install Reports
===============
@@ -582,8 +548,6 @@ command:
This report lists all files in the root-file-system, including the
origin Debian package.
-.. _`_validation`:
-
Validation
==========
@@ -593,8 +557,6 @@ in a file used with ``elbe create`` the installed package versions and
md5 hashes are validated and a report is printed and saved to
``validation.txt``. This file is also in asciidoc format.
-.. _`_xml_reference`:
-
XML Reference
=============
@@ -756,8 +718,6 @@ configuration for a different architecture
- The package list resides here.
-.. _`_building_ubi_images`:
-
Building ubi images
-------------------
@@ -888,8 +848,6 @@ partitions and mountpoints. Lets look at an example *target* section.
this section. Entries for */proc*, */sys* etc. can be generated with
*bydev* nodes.
-.. _`_building_harddisk_sdcard_images`:
-
Building harddisk / sdcard images
---------------------------------
@@ -964,8 +922,6 @@ partitions and mountpoints. Lets look at an example *target* section.
A complete reference that is automatically generated from the schema
file is also available.
-.. _`_elbe_init_detailed_explanation`:
-
Elbe init (detailed Explanation)
================================
diff --git a/docs/article-quickstart.rst b/docs/article-quickstart.rst
index b895b5b2bcdc..cee4b09aec3d 100644
--- a/docs/article-quickstart.rst
+++ b/docs/article-quickstart.rst
@@ -9,8 +9,6 @@ filesystem.
This quickstart guide describes the steps necessary to rebuild the
root-filesystem from the XML file and to simple modifications.
-.. _`_steps_necessary`:
-
Steps necessary
===============
@@ -30,8 +28,6 @@ Steps 1,2 and 3 need only be performed once.
When Debian is running inside a VM (vmware etc), you need to make
sure, that nested KVM is working.
-.. _`_customization_of_the_build`:
-
Customization of the build
==========================
@@ -48,8 +44,6 @@ ELBE allows manipulating the generated root filesystem through a set of
user, change directory permissions, and remove files from the root
filesystem.
-.. _`_installing_elbe`:
-
Installing ELBE
===============
@@ -59,8 +53,6 @@ on a Debian 10 (Buster) system.
But ELBE can also be installed from git.
-.. _`_binary_debian_packages`:
-
Binary Debian packages
----------------------
@@ -89,8 +81,6 @@ Then run (as root):
# apt update
# apt install elbe
-.. _`_create_initvm_and_submit_xml_files`:
-
Create initvm and submit XML files
==================================
@@ -137,8 +127,6 @@ directory.
touch .stamps/stamp-install-initial-image
*****
-.. _`_submitting_an_xml_file`:
-
Submitting an XML file
======================
@@ -220,21 +208,15 @@ using
The result of the build is stored in elbe-build-<TIMESTAMP> below your
current working directory.
-.. _`_ports_opened_by_initvm`:
-
Ports opened by initvm
======================
The initvm will open port 7587 on localhost. This is used by the elbe
tools on your host to communicate with the initvm.
-.. _`_advanced_usage`:
-
Advanced usage
==============
-.. _`_elbe_archive`:
-
ELBE Archive
------------
@@ -247,8 +229,6 @@ It is done with the following XML node:
<archivedir>foo</archivedir>
-.. _`_archivedir`:
-
archivedir
----------
@@ -264,8 +244,6 @@ Example snippet to use ‘archivedir’:
<archivedir>foo</archivedir>
<archivedir variant="production">bar</archivedir>
-.. _`_adding_packages_to_the_list_of_packages_to_install`:
-
Adding packages to the "list of packages to install"
----------------------------------------------------
@@ -278,8 +256,6 @@ the ``<target>`` XML node. Inserting a line containing
will add the ``util-linux`` package to the target-rfs.
-.. _`_using_the_finetuning_rules`:
-
Using the finetuning rules
--------------------------
@@ -295,15 +271,11 @@ example finetuning from
<adduser passwd="elbe" shell="/bin/bash">elbe</adduser>
</finetuning>
-.. _`_rm`:
-
rm
~~
The ``<rm>`` node removes files from the target-rfs.
-.. _`_adduser`:
-
adduser
~~~~~~~
@@ -338,8 +310,6 @@ attribute in the XML.
<adduser passwd_hashed="$6$rounds=656000$7vWuOPVX0YKaISh5$cJhevq/z7kJ215n18dnksv/zOeUf6uPoLgICwLeTSu/2xoLHkyYQABaM7a99sQmpilCV.SlK9jfHZz3m7/s2a." shell="/bin/bash">elbe</adduser>
-.. _`_changing_ownership_of_directories_or_files`:
-
Changing ownership of directories or files
------------------------------------------
@@ -352,16 +322,12 @@ which allows running any command that is available in the target-rfs.
<command>chown elbe:elbe /mnt</command>
<command>chmod 777 /mnt</command>
-.. _`_further_example`:
-
Further Example
~~~~~~~~~~~~~~~
A more complete example can be found in the ELBE overview document that
is installed at ``/usr/share/doc/elbe-doc/elbeoverview-en.html``
-.. _`_using_the_elbe_pbuilder_feature`:
-
Using the Elbe Pbuilder Feature
===============================
@@ -431,8 +397,6 @@ profiles:
$ cd linux*/
$ ../elbe pbuilder --cross --origfile ../linux*.orig.tar.xz --profile nodoc,nopython build --project `cat ../pbuilder.prj`
-.. _`_custom_repository`:
-
Custom Repository
=================
@@ -441,8 +405,6 @@ image. This can be done with a custom repository. You can use
`reprepro <https://mirrorer.alioth.debian.org/>`__ to create your own
repository or the above mentioned pbuilder feature.
-.. _`_repository_key`:
-
Repository Key
--------------
@@ -490,8 +452,6 @@ used to export the public key into a repo.pub file.
gpg --export --armor CF837F1AAAC35E084062AE4468E68615BB6CB47C > repo.pub
-.. _`_reprepro_configuration`:
-
reprepro configuration
----------------------
@@ -526,8 +486,6 @@ put ``repo.pub`` into your ``repo`` directory.
│ └── distributions
└── repo.pub
-.. _`_insert_pkgs_into_repo`:
-
insert pkgs into repo
---------------------
diff --git a/docs/elbe-add.rst b/docs/elbe-add.rst
index ac8362db75a0..a10636783851 100644
--- a/docs/elbe-add.rst
+++ b/docs/elbe-add.rst
@@ -2,15 +2,11 @@
elbe-add
************************
-.. _`_name`:
-
NAME
====
elbe-add - Insert new package(s) into the target package list.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -18,8 +14,6 @@ SYNOPSIS
elbe add [options] <xmlfile> <package name> [<package name>]*
-.. _`_description`:
-
DESCRIPTION
===========
@@ -28,16 +22,12 @@ If more than one package name was given, all the packages are added to
the list. If a package already exists in the list, the package isn’t
added twice.
-.. _`_options`:
-
OPTIONS
=======
<xmlfile>
The xmlfile to be modified.
-.. _`_examples`:
-
EXAMPLES
========
@@ -47,8 +37,6 @@ EXAMPLES
$ elbe add mybsp.xml vim-nox mc
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-buildchroot.rst b/docs/elbe-buildchroot.rst
index a52508c72d02..cc91dc455f60 100644
--- a/docs/elbe-buildchroot.rst
+++ b/docs/elbe-buildchroot.rst
@@ -2,15 +2,11 @@
elbe-buildchroot
************************
-.. _`_name`:
-
NAME
====
elbe-buildchroot - Build a root filesystem.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -21,8 +17,6 @@ SYNOPSIS
<xmlfile>
The XML describing the Elbe project.
-.. _`_description`:
-
DESCRIPTION
===========
@@ -36,8 +30,6 @@ can also be used as an installation source. For details, please refer to
``elbe-mkcdrom(1)``. Optionally, a source CD-ROM image can be generated,
too.
-.. _`_options`:
-
OPTIONS
=======
@@ -83,8 +75,6 @@ OPTIONS
Obsolete option, from the time, before --build-bin and
--build-sources existed.
-.. _`_examples`:
-
EXAMPLES
========
@@ -103,8 +93,6 @@ EXAMPLES
# elbe buildchroot --output myarm.txt --target /root/myarm \
--build-sources --build-bin myarm.xml
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-buildsdk.rst b/docs/elbe-buildsdk.rst
index a45991e99d35..1b43eb78e1c3 100644
--- a/docs/elbe-buildsdk.rst
+++ b/docs/elbe-buildsdk.rst
@@ -2,15 +2,11 @@
elbe-buildsdk
************************
-.. _`_name`:
-
NAME
====
elbe-buildsdk - Build a yocto style sdk.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -21,15 +17,11 @@ SYNOPSIS
<directory>
directory containing the elbe project.
-.. _`_description`:
-
DESCRIPTION
===========
creates a yocto style SDK
-.. _`_examples`:
-
EXAMPLES
========
@@ -41,8 +33,6 @@ EXAMPLES
# elbe buildchroot --output myarm.txt --target /root/myarm myarm.xml
# elbe buildsdk /root/myarm
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-buildsysroot.rst b/docs/elbe-buildsysroot.rst
index d813db364767..7eee33dcca37 100644
--- a/docs/elbe-buildsysroot.rst
+++ b/docs/elbe-buildsysroot.rst
@@ -2,15 +2,11 @@
elbe-buildsysroot
************************
-.. _`_name`:
-
NAME
====
elbe-buildsysroot - Build a sysroot archive.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -21,8 +17,6 @@ SYNOPSIS
[ --skip-validation ] \
<builddir>
-.. _`_description`:
-
DESCRIPTION
===========
@@ -43,8 +37,6 @@ package list of the project for this to work, as well as the relevant
development packages. The XML file of the project also needs a *triplet*
definition.
-.. _`_options`:
-
OPTIONS
=======
@@ -57,8 +49,6 @@ OPTIONS
<builddir>
The build directory to generate the sysroot archive from.
-.. _`_examples`:
-
EXAMPLES
========
@@ -68,8 +58,6 @@ EXAMPLES
# elbe buildsysroot /root/myarm
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-check_updates.rst b/docs/elbe-check_updates.rst
index 37d8b9c8b230..99b4522dd967 100644
--- a/docs/elbe-check_updates.rst
+++ b/docs/elbe-check_updates.rst
@@ -2,16 +2,12 @@
elbe-check_updates
************************
-.. _`_name`:
-
NAME
====
elbe-check_updates - Check whether package updates are available for an
Elbe project.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -22,8 +18,6 @@ SYNOPSIS
[ --skip-validation ] \
<source-xmlfile>
-.. _`_description`:
-
DESCRIPTION
===========
@@ -49,8 +43,6 @@ started like this:
If none of the above is true, the script will not be started.
-.. _`_options`:
-
OPTIONS
=======
@@ -64,8 +56,6 @@ OPTIONS
<source-xmlfile>
Path to the *source.xml* file of the project.
-.. _`_examples`:
-
EXAMPLES
========
@@ -78,8 +68,6 @@ EXAMPLES
$ elbe check_updates --script /scratch/fixpackages.sh \
/scratch/example/source.xml
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-chg_archive.rst b/docs/elbe-chg_archive.rst
index 8d872f32cbc9..e28a631e2d34 100644
--- a/docs/elbe-chg_archive.rst
+++ b/docs/elbe-chg_archive.rst
@@ -2,15 +2,11 @@
elbe-chg_archive
************************
-.. _`_name`:
-
NAME
====
elbe-chg_archive - Insert a new config archive (.tbz) into a XML file.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -18,8 +14,6 @@ SYNOPSIS
elbe chg_archive [options] <xmlfile> [<archive.tar.bz2> | <directory>]
-.. _`_description`:
-
DESCRIPTION
===========
@@ -29,8 +23,6 @@ specified.
The archive tbz is used to insert configuration files into the
root-filesystem.
-.. _`_options`:
-
OPTIONS
=======
@@ -53,8 +45,6 @@ OPTIONS
directory will be archived in a tar.bz2 format and then stored
uuencoded in the <archive> tag of the specified <xmlfile>.
-.. _`_examples`:
-
EXAMPLES
========
@@ -72,8 +62,6 @@ EXAMPLES
$ echo 'my-very-special-config' > my-rfs-overlay/etc/my.cfg
$ elbe chg_archive mybsp.xml my-rfs-overlay
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-chroot.rst b/docs/elbe-chroot.rst
index 4dc691e2c8f9..e262d3931ead 100644
--- a/docs/elbe-chroot.rst
+++ b/docs/elbe-chroot.rst
@@ -2,15 +2,11 @@
elbe-chroot
************************
-.. _`_name`:
-
NAME
====
elbe-chroot - Enter an Elbe root filesystem using chroot.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -19,8 +15,6 @@ SYNOPSIS
elbe chroot [--skip-validation] [--buildtype=TYPE] [--target] <builddir> \
["command"]
-.. _`_description`:
-
DESCRIPTION
===========
@@ -28,8 +22,6 @@ Enters buildenv of a previously built Elbe root filesystem using chroot.
The command has to be run as root **inside the Elbe build VM** (created
with ``elbe-init(1)``).
-.. _`_options`:
-
OPTIONS
=======
@@ -46,8 +38,6 @@ OPTIONS
<builddir>
The build directory of the root filesystem to work with.
-.. _`_examples`:
-
EXAMPLES
========
@@ -83,8 +73,6 @@ EXAMPLES
# elbe chroot /root/testrfs_arm
(chroot) #
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-control.rst b/docs/elbe-control.rst
index e539f1e45378..a04008229ab3 100644
--- a/docs/elbe-control.rst
+++ b/docs/elbe-control.rst
@@ -2,15 +2,11 @@
elbe-control
************************
-.. _`_name`:
-
NAME
====
elbe-control - Low level interface to elbe Soap Daemon running in initvm
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -39,8 +35,6 @@ SYNOPSIS
elbe control [options] shutdown_initvm
elbe control [options] install_elbe_version <version>
-.. _`_description`:
-
DESCRIPTION
===========
@@ -55,8 +49,6 @@ user build 2 projects at once.
You can only wait on the project, that you are currently building.
-.. _`_options`:
-
OPTIONS
=======
@@ -93,8 +85,6 @@ OPTIONS
Specify pbuilder profile(s) to build. Provide multiple profiles as a
comma separated list.
-.. _`_commands`:
-
COMMANDS
========
@@ -204,8 +194,6 @@ a ./debian folder with a valid debianization.
version of the elbe executable. This requires, that the initvm has
package sources configured properly.
-.. _`_examples`:
-
Examples
========
@@ -237,15 +225,11 @@ Examples
elbe-report.txt (Report)
log.txt (Log file)
-.. _`_see_also`:
-
SEE ALSO
========
``elbe-initvm(1)`` ``git-daemon(1)``
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-daemon.rst b/docs/elbe-daemon.rst
index 46883f7db212..c065a60c9d74 100644
--- a/docs/elbe-daemon.rst
+++ b/docs/elbe-daemon.rst
@@ -2,15 +2,11 @@
elbe-daemon
************************
-.. _`_name`:
-
NAME
====
elbe-daemon - control the ELBE daemon.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -18,15 +14,11 @@ SYNOPSIS
elbe daemon [options]
-.. _`_description`:
-
DESCRIPTION
===========
This command controls the ELBE daemon and is run inside the inivm.
-.. _`_options`:
-
OPTIONS
=======
@@ -40,8 +32,6 @@ OPTIONS
--<daemon>
Enable <daemon>.
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-db.rst b/docs/elbe-db.rst
index bf5a4caf86bd..ebf1759f30ef 100644
--- a/docs/elbe-db.rst
+++ b/docs/elbe-db.rst
@@ -2,15 +2,11 @@
elbe-db
************************
-.. _`_name`:
-
NAME
====
elbe-db - interface to the ELBE db. Must be run inside the initvm.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -33,15 +29,11 @@ SYNOPSIS
elbe db [options] del_versions <project_dir> <version>
elbe db [options] build <project_dir>
-.. _`_description`:
-
DESCRIPTION
===========
This command controls the ELBE daemon and is run inside the initvm.
-.. _`_options`:
-
OPTIONS
=======
@@ -83,8 +75,6 @@ OPTIONS
Description of the project version which shall be stored in the
database.
-.. _`_commands`:
-
COMMANDS
========
@@ -143,8 +133,6 @@ COMMANDS
*print_version_xml* <project_dir> <version>
Prints ELBE xml file in <project_dir> of version <version>.
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-debianize.rst b/docs/elbe-debianize.rst
index 9688a9b16b1d..0239e546ba5c 100644
--- a/docs/elbe-debianize.rst
+++ b/docs/elbe-debianize.rst
@@ -2,15 +2,11 @@
elbe-debianize
************************
-.. _`_name`:
-
NAME
====
elbe-debianize - How to debianize software
-.. _`_description`:
-
DESCRIPTION
===========
@@ -52,8 +48,6 @@ Several Linux versions will not generate all the Build-Depends that are
needed to build in a clean environment and you will probably need to fix
them manually.
-.. _`_examples`:
-
EXAMPLES
========
diff --git a/docs/elbe-diff.rst b/docs/elbe-diff.rst
index 6cf1d36ee7d1..6288010d7666 100644
--- a/docs/elbe-diff.rst
+++ b/docs/elbe-diff.rst
@@ -2,16 +2,12 @@
elbe-diff
************************
-.. _`_name`:
-
NAME
====
elbe-diff - Looks at 2 directories and makes Suggestions to modify the
xml file.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -19,8 +15,6 @@ SYNOPSIS
elbe diff <generated_dir> <fixed_dir>
-.. _`_description`:
-
DESCRIPTION
===========
@@ -29,8 +23,6 @@ tweaks. It is supplied with the generated and the fixed rootfs, and will
suggest a finetuning section and a commandline to generate an archive
file.
-.. _`_options`:
-
OPTIONS
=======
@@ -40,8 +32,6 @@ OPTIONS
<fixed_dir>
This should point to the fixed directory.
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-fetch_initvm_pkgs.rst b/docs/elbe-fetch_initvm_pkgs.rst
index 57c88b5a282a..7ec17f94e68a 100644
--- a/docs/elbe-fetch_initvm_pkgs.rst
+++ b/docs/elbe-fetch_initvm_pkgs.rst
@@ -2,15 +2,11 @@
elbe-fetch_initvm_pkgs
************************
-.. _`_name`:
-
NAME
====
elbe-fetch_initvm_pkgs - Download initvm binary and source Packages
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -27,8 +23,6 @@ SYNOPSIS
[--skip-build-bin] \
<xmlfile>
-.. _`_description`:
-
DESCRIPTION
===========
@@ -42,8 +36,6 @@ generate the initvm related repositories.
This command is used by elbe internally during the creation of the
initvm. It is currently not supposed to be called by users.
-.. _`_options`:
-
OPTIONS
=======
@@ -77,8 +69,6 @@ OPTIONS
<xmlfile>
the XML file to use.
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-gen_update.rst b/docs/elbe-gen_update.rst
index 5fc949259eda..57abe563514b 100644
--- a/docs/elbe-gen_update.rst
+++ b/docs/elbe-gen_update.rst
@@ -2,15 +2,11 @@
elbe-gen_update
************************
-.. _`_name`:
-
NAME
====
elbe-gen_update - Generate an update archive to be used by elbe-updated.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -23,8 +19,6 @@ SYNOPSIS
[ --skip-validation ] \
<base_sourcexml>
-.. _`_description`:
-
DESCRIPTION
===========
@@ -36,8 +30,6 @@ with ``elbe-updated(1)``.
This command has to be run as root **inside the Elbe build VM**.
-.. _`_options`:
-
OPTIONS
=======
@@ -63,8 +55,6 @@ OPTIONS
<base_sourcexml>
The *source.xml* file of the base version of the project.
-.. _`_examples`:
-
EXAMPLES
========
@@ -78,8 +68,6 @@ EXAMPLES
--output /root/v0.1-v0.2.upd \
/root/v0.1.xml
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-genlicence.rst b/docs/elbe-genlicence.rst
index 7027b52174ec..376513cbece6 100644
--- a/docs/elbe-genlicence.rst
+++ b/docs/elbe-genlicence.rst
@@ -2,16 +2,12 @@
elbe-genlicence
************************
-.. _`_name`:
-
NAME
====
elbe-genlicence - Generate a file containing the licences of the
packages included in a project.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -22,8 +18,6 @@ SYNOPSIS
[ --xml <xmlfilename> ] \
<project-dir>
-.. _`_description`:
-
DESCRIPTION
===========
@@ -33,8 +27,6 @@ the */usr/share/doc/\** directories of the root filesystem.
This command has to be run **inside the Elbe build VM**.
-.. _`_options`:
-
OPTIONS
=======
@@ -53,8 +45,6 @@ OPTIONS
<project>
The build directory of the project to process.
-.. _`_examples`:
-
EXAMPLES
========
@@ -65,8 +55,6 @@ EXAMPLES
# elbe genlicence --output myproject-licences.txt /var/cache/elbe/<uuid>
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-get_archive.rst b/docs/elbe-get_archive.rst
index c175c3b78122..2d510712464c 100644
--- a/docs/elbe-get_archive.rst
+++ b/docs/elbe-get_archive.rst
@@ -2,15 +2,11 @@
elbe-get_archive
************************
-.. _`_name`:
-
NAME
====
elbe-get_archive - Extract the archive from an xmlfile.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -18,16 +14,12 @@ SYNOPSIS
elbe get_archive <xmlfile> <archive>
-.. _`_description`:
-
DESCRIPTION
===========
This command extracts the archive from an xml file. It will not
overwrite anything.
-.. _`_options`:
-
OPTIONS
=======
@@ -37,8 +29,6 @@ OPTIONS
<archive>
Name of the extracted archive file. The archive must be a tar.bz2.
-.. _`_examples`:
-
EXAMPLES
========
@@ -48,8 +38,6 @@ EXAMPLES
$ elbe get_archive project.xml archive.tar.bz2
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-hdimg.rst b/docs/elbe-hdimg.rst
index 6687d39271a2..945a44f7d3a3 100644
--- a/docs/elbe-hdimg.rst
+++ b/docs/elbe-hdimg.rst
@@ -2,15 +2,11 @@
elbe-hdimg
************************
-.. _`_name`:
-
NAME
====
elbe-hdimg - Create hard disk and flash images from the given XML file.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -22,8 +18,6 @@ SYNOPSIS
[ --skip-grub ] \
<xmlfile>
-.. _`_description`:
-
DESCRIPTION
===========
@@ -31,8 +25,6 @@ DESCRIPTION
section in the given XML file. The command has to be run as root
**inside the Elbe build VM**.
-.. _`_options`:
-
OPTIONS
=======
@@ -55,8 +47,6 @@ OPTIONS
<xmlfile>
The XML file to use.
-.. _`_examples`:
-
EXAMPLES
========
@@ -67,8 +57,6 @@ EXAMPLES
elbe hdimg --target /root/myproject --output /root/hdimg.log \
/root/myproject/source.xml
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-init.rst b/docs/elbe-init.rst
index bf2b84d80414..a7ecaf3189a8 100644
--- a/docs/elbe-init.rst
+++ b/docs/elbe-init.rst
@@ -2,15 +2,11 @@
elbe-init
************************
-.. _`_name`:
-
NAME
====
elbe-init - create a project for an Elbe build virtual machine
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -25,8 +21,6 @@ SYNOPSIS
[ --skip-validation ] \
<xmlfile>
-.. _`_description`:
-
DESCRIPTION
===========
@@ -43,8 +37,6 @@ if a serial console is enough). After that, the virtual machine can be
used to work inside the generated root filesystem. To do so, please use
the ``elbe-chroot(1)`` command **inside the VM**.
-.. _`_options`:
-
OPTIONS
=======
@@ -75,8 +67,6 @@ OPTIONS
<xmlfile>
The XML describing the Elbe project.
-.. _`_examples`:
-
EXAMPLES
========
@@ -89,8 +79,6 @@ EXAMPLES
$ cd /scratch/example
$ make
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-initvm.rst b/docs/elbe-initvm.rst
index 0950799fc54b..1536b00a6ed2 100644
--- a/docs/elbe-initvm.rst
+++ b/docs/elbe-initvm.rst
@@ -2,16 +2,12 @@
elbe-initvm
************************
-.. _`_name`:
-
NAME
====
elbe-initvm - High Level Interface to the ELBE System. Allows one to
create an initvm and directly build Rootfilesystems using ELBE.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -24,8 +20,6 @@ SYNOPSIS
elbe initvm [options] stop
elbe initvm [options] ensure
-.. _`_description`:
-
DESCRIPTION
===========
@@ -34,8 +28,6 @@ This command allows one to build and manage an initvm.
Initvms are managed via libvirt, and it’s necessary that a user is a
member of the libvirt group.
-.. _`_options`:
-
OPTIONS
=======
@@ -85,8 +77,6 @@ OPTIONS
--qemu
Use QEMU directly instead of libvirt.
-.. _`_xml_options`:
-
XML OPTIONS
===========
@@ -96,8 +86,6 @@ XML OPTIONS
--proxy <proxy>
add proxy to mirrors
-.. _`_commands`:
-
COMMANDS
========
@@ -141,8 +129,6 @@ COMMANDS
*ensure*
Make sure an initvm is running in the Background.
-.. _`_examples`:
-
Examples
========
@@ -159,15 +145,11 @@ Examples
$ elbe initvm submit /usr/share/doc/elbe-doc/examples/elbe-desktop.xml
-.. _`_see_also`:
-
SEE ALSO
========
``elbe-control(1)``
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-mkcdrom.rst b/docs/elbe-mkcdrom.rst
index 3d8e7406813d..78395a179ecf 100644
--- a/docs/elbe-mkcdrom.rst
+++ b/docs/elbe-mkcdrom.rst
@@ -2,16 +2,12 @@
elbe-mkcdrom
************************
-.. _`_name`:
-
NAME
====
elbe-mkcdrom - Create an ISO image containing binary and/or source
packages used in the given project.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -28,8 +24,6 @@ SYNOPSIS
[ --rfs-only ] \
<builddir>
-.. _`_description`:
-
DESCRIPTION
===========
@@ -37,8 +31,6 @@ DESCRIPTION
packages used in the given project. This command has to be run as root
**inside the Elbe build VM**.
-.. _`_options`:
-
OPTIONS
=======
@@ -79,8 +71,6 @@ OPTIONS
of the build directory. In that case the *--rfs-only* option has to
be given.
-.. _`_examples`:
-
EXAMPLES
========
@@ -96,8 +86,6 @@ EXAMPLES
# elbe mkcdrom --source foo/myproject
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-parselicence.rst b/docs/elbe-parselicence.rst
index e3a78a710e97..39284a6afa98 100644
--- a/docs/elbe-parselicence.rst
+++ b/docs/elbe-parselicence.rst
@@ -2,16 +2,12 @@
elbe-parselicence
************************
-.. _`_name`:
-
NAME
====
elbe-parselicence - Generate a file containing the licences of the
packages included in a project.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -25,8 +21,6 @@ SYNOPSIS
[ --errors-only ] \
<licence.xml filename>
-.. _`_description`:
-
DESCRIPTION
===========
@@ -37,8 +31,6 @@ generated using mappings and overrides found in the mapping file.
This information is written to an output xml file, and to a tagvalue
based SPDX File.
-.. _`_options`:
-
OPTIONS
=======
@@ -64,8 +56,6 @@ OPTIONS
<licence.xml filename>
licence.xml File generated during elbe build.
-.. _`_workflow`:
-
WORKFLOW
========
@@ -95,8 +85,6 @@ and use the out.xml or generate tag-value output using option
elbe parselicence --mapping my_mapping.xml /path/to/license.xml --tvout spdx_licenses.tagvalue
-.. _`_license_xml_file`:
-
LICENSE.XML FILE
================
@@ -108,8 +96,6 @@ generated via heuristics.
There are 3 possibitlities per Package:
-.. _`_copyright_file_is_machine_readable`:
-
Copyright File is machine-readable
----------------------------------
@@ -163,8 +149,6 @@ Example:
</detailed>
</pkglicense>
-.. _`_some_information_can_be_extracted_via_heuristics`:
-
Some information can be extracted via heuristics
------------------------------------------------
@@ -207,8 +191,6 @@ Example:
</debian_licenses>
</pkglicense>
-.. _`_no_information_can_be_extracted_automatically`:
-
No information can be extracted automatically
---------------------------------------------
@@ -261,8 +243,6 @@ Example:
</text>
</pkglicense>
-.. _`_mapping_file`:
-
MAPPING FILE
============
@@ -364,16 +344,12 @@ As you can see, it is also necessary to add identity mappings, like
Its not allowed to mix ``<license>`` and ``<mapping>`` in a single
<package> node.
-.. _`_nomos`:
-
NOMOS
=====
Nomos is part of fossology. See https://www.fossology.org/get-started/
to find out, how to install the nomos executable.
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-pbuilder.rst b/docs/elbe-pbuilder.rst
index f7da74396854..8043b7929945 100644
--- a/docs/elbe-pbuilder.rst
+++ b/docs/elbe-pbuilder.rst
@@ -2,8 +2,6 @@
elbe-pbuilder
************************
-.. _`_name`:
-
NAME
====
@@ -11,8 +9,6 @@ elbe-pbuilder - High Level Interface to the ELBE Package Build System.
Allows one to create a package builder for a project and to build Debian
packages.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -21,16 +17,12 @@ SYNOPSIS
elbe pbuilder build [--project <project> | --xmlfile <xmlfile>]
elbe pbuilder create [--project <project> | --xmlfile <xmlfile>] [--writeproject <filename>]
-.. _`_description`:
-
DESCRIPTION
===========
Creates a pbuilder for a specified project and builds the Debian package
like pbuilder, but for the configured ELBE project.
-.. _`_options`:
-
OPTIONS
=======
@@ -68,8 +60,6 @@ OPTIONS
be a number followed by an optional suffix: k, M, G, T. Use 0 for no
limit.
-.. _`_xml_options`:
-
XML OPTIONS
===========
@@ -79,8 +69,6 @@ XML OPTIONS
--proxy <proxy>
add proxy to mirrors
-.. _`_commands`:
-
COMMANDS
========
@@ -104,8 +92,6 @@ COMMANDS
directory will be built. The result of the package build is stored in
../ like pbuilder does.
-.. _`_notes`:
-
NOTES
=====
@@ -128,8 +114,6 @@ pbuilder ccache create 6m44,117s pbuilder ccache build 1. 7m36,130s 2.
pbuilder ccache cross create 4m4,190s pbuilder ccache cross build 1.
2m40,159s 2. 2m32,650s
-.. _`_examples`:
-
EXAMPLES
========
@@ -156,15 +140,11 @@ EXAMPLES
# cd program
# elbe pbuilder build --project `cat ../myarm.prj` --cpuset 1
-.. _`_see_also`:
-
SEE ALSO
========
``elbe-control(1)`` ``elbe-initvm(1)`` ``pdebuild(1)``
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-pkgdiff.rst b/docs/elbe-pkgdiff.rst
index 8a08c76be07b..ca2fd0ef7ad4 100644
--- a/docs/elbe-pkgdiff.rst
+++ b/docs/elbe-pkgdiff.rst
@@ -2,16 +2,12 @@
elbe-pkgdiff
************************
-.. _`_name`:
-
NAME
====
elbe-pkgdiff - Compare two directories for differing packages and
suggest how to modify the Elbe XML file.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -19,8 +15,6 @@ SYNOPSIS
elbe pkgdiff <generated_dir> <fixed_dir>
-.. _`_description`:
-
DESCRIPTION
===========
@@ -31,8 +25,6 @@ added packages and to exclude the removed ones. The command is supplied
with the path to the originally generated directory and the path to the
directory with the modified root filesystem.
-.. _`_options`:
-
OPTIONS
=======
@@ -42,8 +34,6 @@ OPTIONS
<fixed_dir>
This should point to the fixed directory.
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-preprocess.rst b/docs/elbe-preprocess.rst
index 98df3d5cdb72..95b83878cbd2 100644
--- a/docs/elbe-preprocess.rst
+++ b/docs/elbe-preprocess.rst
@@ -2,16 +2,12 @@
elbe-preprocess
************************
-.. _`_name`:
-
NAME
====
elbe-preprocess - resolves xinclude, external resources and resolves
variants
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -19,8 +15,6 @@ SYNOPSIS
'elbe preprocess [options] <xmlfile>
-.. _`_description`:
-
DESCRIPTION
===========
@@ -33,8 +27,6 @@ tag will only be used if *elbe preprocess* is called with
--variant=audio or --variant=video or --variant=audio,video. If no
--variant is given, the tag will be dropped.
-.. _`_options`:
-
OPTIONS
=======
@@ -47,8 +39,6 @@ OPTIONS
--output <filename>
preprocessed output file, defaults to preprocess.xml
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-prjrepo.rst b/docs/elbe-prjrepo.rst
index f819da7d216d..0a834ce95a19 100644
--- a/docs/elbe-prjrepo.rst
+++ b/docs/elbe-prjrepo.rst
@@ -2,16 +2,12 @@
elbe-prjrepo
************************
-.. _`_name`:
-
NAME
====
elbe-prjrepo - Provides access to the Debian repositories in each
project folder.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -21,8 +17,6 @@ SYNOPSIS
elbe prjrepo upload_pkg <project_dir> [<debfile> | <dscfile> | <changesfile>]
elbe prjrepo list_packages <project_dir>
-.. _`_description`:
-
DESCRIPTION
===========
@@ -32,8 +26,6 @@ initvm. Packages in this repository can then be installed into a root
file system. The ``elbe-prjrepo`` command allows the user to interact
with this repository, i.e. list, upload and download packages.
-.. _`_options`:
-
OPTIONS
=======
@@ -47,8 +39,6 @@ OPTIONS
How many times to retry the connection to the server before giving up
(default is 10 times, yielding 10 seconds).
-.. _`_commands`:
-
COMMANDS
========
@@ -69,8 +59,6 @@ COMMANDS
*list_packages* <project_dir>
Lists all packages available in the Debian repository of the project.
-.. _`_example`:
-
Example
=======
@@ -81,8 +69,6 @@ Example
$ elbe prjrepo list_packages "/var/cache/elbe/38599ce2-4cad-4578-bfe1-06fa793b883a"
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-remove_sign.rst b/docs/elbe-remove_sign.rst
index 22603d048e3c..0eb1e5535f73 100644
--- a/docs/elbe-remove_sign.rst
+++ b/docs/elbe-remove_sign.rst
@@ -2,15 +2,11 @@
elbe-remove_sign
************************
-.. _`_name`:
-
NAME
====
elbe-remove_sign - Verify a signed file and remove the signature.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -18,8 +14,6 @@ SYNOPSIS
elbe remove_sign <filename>
-.. _`_description`:
-
DESCRIPTION
===========
@@ -29,16 +23,12 @@ this to work the public key of the signer has to be added to the
keyring. Note that to get *VALID (Trusted)*, the key has to have
ultimate trust.
-.. _`_options`:
-
OPTIONS
=======
<filename>
The name of the file to sign.
-.. _`_examples`:
-
EXAMPLES
========
@@ -48,8 +38,6 @@ EXAMPLES
elbe remove_sign rfs.tar.bz2.gpg
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-repodir.rst b/docs/elbe-repodir.rst
index 39d962a1d0fb..bd2f74250d07 100644
--- a/docs/elbe-repodir.rst
+++ b/docs/elbe-repodir.rst
@@ -2,15 +2,11 @@
elbe-repodir
************************
-.. _`_name`:
-
NAME
====
elbe-repodir - preprocesses and hosts repodirs on an Elbe client
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -18,8 +14,6 @@ SYNOPSIS
'elbe repodir [options] <xmlfile>
-.. _`_description`:
-
DESCRIPTION
===========
@@ -36,8 +30,6 @@ key file must be a relative path to repodir’s PATH.
After the output file is written, the started webserver(s) will log
their accessed files.
-.. _`_options`:
-
OPTIONS
=======
@@ -45,8 +37,6 @@ OPTIONS
preprocessed output file, defaults to repodir.xml. If this exists it
will be overridden.
-.. _`_examples`:
-
EXAMPLES
========
@@ -79,8 +69,6 @@ i. is preprocessed to:
i. with randomly chosen TCP port 36071 serving PATH1 and port 33187
serving PATH2.
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-setsel.rst b/docs/elbe-setsel.rst
index eb200672c268..2193a433aad6 100644
--- a/docs/elbe-setsel.rst
+++ b/docs/elbe-setsel.rst
@@ -2,16 +2,12 @@
elbe-setsel
************************
-.. _`_name`:
-
NAME
====
elbe-setsel - Replace the package list of an Elbe XML file by a list
obtained from *dpkg-getselections*.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -19,8 +15,6 @@ SYNOPSIS
elbe setsel <xmlfile> <pkglist>
-.. _`_description`:
-
DESCRIPTION
===========
@@ -46,8 +40,6 @@ filesystem). The recommended usage is as follows:
7. Rebuild using the setsel mode of Elbe.
-.. _`_options`:
-
OPTIONS
=======
@@ -57,8 +49,6 @@ OPTIONS
<pkglist>
The package list from *dpkg --get-selections*.
-.. _`_examples`:
-
EXAMPLES
========
@@ -69,8 +59,6 @@ EXAMPLES
$ elbe setsel myproject.xml myproject.pkgs
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-show.rst b/docs/elbe-show.rst
index 3d05f21027d8..e7118d24c716 100644
--- a/docs/elbe-show.rst
+++ b/docs/elbe-show.rst
@@ -2,15 +2,11 @@
elbe-show
************************
-.. _`_name`:
-
NAME
====
elbe-show - Get a human readable representation of a ELBE XML file.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -18,8 +14,6 @@ SYNOPSIS
elbe show [--verbose] <xmlfile>
-.. _`_description`:
-
DESCRIPTION
===========
@@ -28,8 +22,6 @@ file.
It’s useful to get an idea what a specific XML file was designed for.
-.. _`_options`:
-
OPTIONS
=======
@@ -40,8 +32,6 @@ OPTIONS
<xmlfile>
The xmlfile to be shown.
-.. _`_examples`:
-
EXAMPLES
========
@@ -51,8 +41,6 @@ EXAMPLES
$ elbe show project.xml
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-sign.rst b/docs/elbe-sign.rst
index 920dfed3d976..e35fc5b937c4 100644
--- a/docs/elbe-sign.rst
+++ b/docs/elbe-sign.rst
@@ -2,15 +2,11 @@
elbe-sign
************************
-.. _`_name`:
-
NAME
====
elbe-sign - Add a signature to the given file
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -18,8 +14,6 @@ SYNOPSIS
elbe sign <filename> <fingerprint>
-.. _`_description`:
-
DESCRIPTION
===========
@@ -32,8 +26,6 @@ The person receiving the file can use *gpg --decrypt* or
``elbe-remove_sign(1)`` to verify the file and to get the original
content.
-.. _`_options`:
-
OPTIONS
=======
@@ -43,8 +35,6 @@ OPTIONS
<fingerprint>
The fingerprint of the private GPG key to use for signing the file.
-.. _`_examples`:
-
EXAMPLES
========
@@ -54,8 +44,6 @@ EXAMPLES
elbe sign rfs.tar.bz2 FEE1DEAD
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-toolchainextract.rst b/docs/elbe-toolchainextract.rst
index 05a45f878b15..18f1f77cf9a6 100644
--- a/docs/elbe-toolchainextract.rst
+++ b/docs/elbe-toolchainextract.rst
@@ -2,15 +2,11 @@
elbe-toolchainextract
************************
-.. _`_name`:
-
NAME
====
elbe-toolchainextract - extract libraries from a cross-toolchain
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -22,8 +18,6 @@ SYNOPSIS
[ --codename <distro codename for repository> ]
[ --buildtype <shortname for the toolchain type> ]
-.. _`_description`:
-
DESCRIPTION
===========
@@ -32,8 +26,6 @@ packages that have been generated from a given cross-toolchain.
This command has to be run as root **inside the Elbe build VM**.
-.. _`_options`:
-
OPTIONS
=======
@@ -50,8 +42,6 @@ OPTIONS
--buildtype <shortname of the toolchain type>
currently armhf-linaro48 or armel-linaro48 can be used.
-.. _`_examples`:
-
EXAMPLES
========
@@ -96,8 +86,6 @@ EXAMPLES
/opt/gcc-linaro-arm-linux-gnueabihf-4.8-2013.10_repo/pool/main/libs/libstdc++6:
libstdc++6_4.8.3_armhf.deb
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-updated.rst b/docs/elbe-updated.rst
index 8f6e2bda33e5..4b5301d5c6ce 100644
--- a/docs/elbe-updated.rst
+++ b/docs/elbe-updated.rst
@@ -2,15 +2,11 @@
elbe-updated
************************
-.. _`_name`:
-
NAME
====
elbe-updated - Elbe update daemon.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -23,8 +19,6 @@ SYNOPSIS
[ --port <port> ] \
[ --usb ]
-.. _`_description`:
-
DESCRIPTION
===========
@@ -44,8 +38,6 @@ that *elbe updated* is usually started by the init script of its
package, so in most cases there should be no need to start it by
invoking this command directly.
-.. _`_options`:
-
OPTIONS
=======
@@ -67,8 +59,6 @@ OPTIONS
Enable the USB monitor. This option requires pyudev module and an
automount system for the usb drives (e.g. usbmount).
-.. _`_examples`:
-
EXAMPLES
========
@@ -79,8 +69,6 @@ EXAMPLES
# elbe updated --directory /updates --nosign
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe-validate.rst b/docs/elbe-validate.rst
index f6a09995e54a..d6b5329e684b 100644
--- a/docs/elbe-validate.rst
+++ b/docs/elbe-validate.rst
@@ -2,15 +2,11 @@
elbe-validate
************************
-.. _`_name`:
-
NAME
====
elbe-validate - validate xml file.
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -18,23 +14,17 @@ SYNOPSIS
elbe validate <xmlfile>
-.. _`_description`:
-
DESCRIPTION
===========
This command validates the xmlfile provided, and prints out errors.
-.. _`_options`:
-
OPTIONS
=======
<xmlfile>
The xml file to validate.
-.. _`_examples`:
-
EXAMPLES
========
@@ -44,8 +34,6 @@ EXAMPLES
$ elbe validate project.xml
-.. _`_elbe`:
-
ELBE
====
diff --git a/docs/elbe.rst b/docs/elbe.rst
index b4ea50251a09..6639e8b812e7 100644
--- a/docs/elbe.rst
+++ b/docs/elbe.rst
@@ -2,15 +2,11 @@
elbe
************************
-.. _`_name`:
-
NAME
====
elbe - Embedded Linux Build Environment
-.. _`_synopsis`:
-
SYNOPSIS
========
@@ -18,8 +14,6 @@ SYNOPSIS
elbe <command> [<args>]
-.. _`_description`:
-
DESCRIPTION
===========
@@ -28,8 +22,6 @@ also includes tools to modify xml files.
The *<command>* is a name of an Elbe command (see below).
-.. _`_elbe_commands`:
-
Elbe COMMANDS
=============
@@ -102,15 +94,11 @@ Elbe COMMANDS
``elbe-validate(1)``
validate the given XML file against the Elbe XML Schema.
-.. _`_see_also`:
-
SEE ALSO
========
``elbe(1)``
-.. _`_elbe`:
-
ELBE
====
--
2.44.0
More information about the elbe-devel
mailing list