From: Vladimir Panteleev <git@thecybershadow.net>
Date: Mon, 11 Sep 2017 13:09:25 +0000 (+0000)
Subject: docs/hacking-howto: Update section topology
X-Git-Tag: 4.14.1~54
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=c3c94a8e1ae3c06dc1149ac697167bbfe10455d2;p=i3%2Fi3

docs/hacking-howto: Update section topology

- Promote the "How to build?" sub-section to a top-level
  section ("Building i3")

- Convert the "Introduction" sub-section as the intro to the remaining
  contents of the "Using git / sending patches" section

- Keep "Which branch to use?" as a level-3 sub-section, thus making it
  a sub-section of what used to be the "Introduction" sub-section.
---

diff --git a/docs/hacking-howto b/docs/hacking-howto
index 9c89947b..d585c2d7 100644
--- a/docs/hacking-howto
+++ b/docs/hacking-howto
@@ -8,9 +8,7 @@ touching i3’s source code. It should contain all important information to help
 you understand why things are like they are. If it does not mention something
 you find necessary, please do not hesitate to contact me.
 
-== Using git / sending patches
-
-=== How to build?
+== Building i3
 
 You can build i3 like you build any other software package which uses autotools.
 Here’s a memory refresher:
@@ -23,7 +21,7 @@ Here’s a memory refresher:
 (The autoreconf -fi step is unnecessary if you are building from a release tarball,
  but shouldn’t hurt either.)
 
-==== Build system features
+=== Build system features
 
 * We use the AX_ENABLE_BUILDDIR macro to enforce builds happening in a separate
   directory. This is a prerequisite for the AX_EXTEND_SRCDIR macro and building
@@ -51,7 +49,7 @@ Here’s a memory refresher:
 * Coverage reports are now generated using “make check-code-coverage”, which
   requires specifying --enable-code-coverage when calling configure.
 
-=== Introduction
+== Using git / sending patches
 
 For a short introduction into using git, see
 http://web.archive.org/web/20121024222556/http://www.spheredev.org/wiki/Git_for_the_lazy