[PATCH 00/11] A first pass at removing labels

["Nicolas Dechesne" <nicolas.dechesne@linaro.org>]

During the initial (automated) migration from Docbook to Sphinx with
pandoc, a custom label was created for each section, since these
labels were used when referencing sections. However with Sphinx, we
have enable autosectionlabel extention which allows us to refer
sections its title. So the vast majority of the labels are not used,
not needed, and use valuable space in our editors ;)

This is a first pass at removing the labels. I am dealing with the
'simple' ones for now, I wanted to have all of them done before
sending the patches, but for the ref-manual, dev-manual and
overview-manual we still use many labels, so it's taking more time. I
am hoping we can merge this first series, while I continue to fix the
last manuals!

This series is made of 2 parts: first I replace some documents which
use references to a label, with their corresponding 'autosection'
label, then I am removing all labels.

All patches in the second part of this series are generated with this
command:

sed -i '/{\n/{:a;N;/\n}/!ba};/^\.\. _.*/,+1d' *.rst

And the whole series is tested with:

git rebase -i origin/master --exec "make -C documentation clean html"

And has no warnings/errors..

Nicolas Dechesne (11):
  what-i-wish-id-known: replace labels with references to section title
  sdk-manual: replace labels with references to section title
  ref-manual: replace labels with references to section title
  dev-manual: replace labels with references to section title
  kernel-dev: replace labels with references to section title
  test-manual: remove unused labels
  bsp-guide: remove unused labels
  kernel-dev: remove unused labels
  profile-manual: remove unused labels
  sdk-manual: remove unused labels
  toaster-manual: remove unused labels

 documentation/bsp-guide/bsp.rst               | 20 --------
 .../dev-manual/dev-manual-common-tasks.rst    | 15 +++---
 .../kernel-dev/kernel-dev-advanced.rst        | 12 +----
 .../kernel-dev/kernel-dev-common.rst          |  2 -
 .../kernel-dev/kernel-dev-concepts-appx.rst   |  2 -
 documentation/kernel-dev/kernel-dev-faq.rst   |  2 -
 documentation/kernel-dev/kernel-dev-intro.rst | 10 ++--
 .../profile-manual/profile-manual-intro.rst   |  4 --
 .../profile-manual/profile-manual-usage.rst   | 46 -------------------
 documentation/ref-manual/faq.rst              |  4 +-
 .../ref-manual/ref-devtool-reference.rst      |  2 +-
 .../sdk-manual/sdk-appendix-obtain.rst        |  4 +-
 documentation/sdk-manual/sdk-extensible.rst   | 44 ------------------
 documentation/sdk-manual/sdk-intro.rst        |  4 --
 documentation/sdk-manual/sdk-using.rst        |  6 ---
 .../test-manual/test-manual-intro.rst         | 22 ---------
 .../test-manual/test-manual-test-process.rst  |  2 -
 .../test-manual-understand-autobuilder.rst    | 20 --------
 .../toaster-manual/toaster-manual-intro.rst   |  4 --
 .../toaster-manual-reference.rst              | 22 ---------
 .../toaster-manual-setup-and-use.rst          | 16 -------
 .../toaster-manual/toaster-manual-start.rst   |  6 ---
 documentation/what-i-wish-id-known.rst        |  2 +-
 23 files changed, 19 insertions(+), 252 deletions(-)

-- 
2.29.2