From 96a4e1f80d1692965d3c4eb8152c00cc64b3216a Mon Sep 17 00:00:00 2001
From: Eric Sagnes <eric.sagnes@gmail.com>
Date: Sun, 22 May 2016 18:05:37 +0900
Subject: [PATCH] nixpkgs manual: cleanup (#15611)

---
 doc/default.nix                                 |  5 ++---
 .../beam.xml}                                   | 10 +++++-----
 .../haskell.md}                                 |  2 +-
 doc/languages-frameworks/index.xml              | 17 +++++++++--------
 doc/manual.xml                                  |  2 --
 5 files changed, 17 insertions(+), 19 deletions(-)
 rename doc/{beam-users-guide.xml => languages-frameworks/beam.xml} (98%)
 rename doc/{haskell-users-guide.md => languages-frameworks/haskell.md} (99%)

diff --git a/doc/default.nix b/doc/default.nix
index ddbee65f1ac..a9f22267584 100644
--- a/doc/default.nix
+++ b/doc/default.nix
@@ -52,9 +52,8 @@ stdenv.mkDerivation {
       outputFile = "./languages-frameworks/python.xml";
     }
   + toDocbook {
-      inputFile = ./haskell-users-guide.md;
-      outputFile = "haskell-users-guide.xml";
-      useChapters = true;
+      inputFile = ./languages-frameworks/haskell.md;
+      outputFile = "./languages-frameworks/haskell.xml";
     }
   + toDocbook {
       inputFile = ./../pkgs/development/idris-modules/README.md;
diff --git a/doc/beam-users-guide.xml b/doc/languages-frameworks/beam.xml
similarity index 98%
rename from doc/beam-users-guide.xml
rename to doc/languages-frameworks/beam.xml
index c1a4c90bc27..2dc5aa63e45 100644
--- a/doc/beam-users-guide.xml
+++ b/doc/languages-frameworks/beam.xml
@@ -1,10 +1,10 @@
-<chapter xmlns="http://docbook.org/ns/docbook"
+<section xmlns="http://docbook.org/ns/docbook"
          xmlns:xlink="http://www.w3.org/1999/xlink"
-         xml:id="users-guide-to-the-erlang-infrastructure">
+         xml:id="sec-beam">
 
-  <title>User's Guide to the Beam Infrastructure</title>
+  <title>Beam Languages (Erlang &amp; Elixir)</title>
   <section xml:id="beam-introduction">
-    <title>Beam Languages (Erlang &amp; Elixir) on Nix</title>
+    <title>Introduction</title>
     <para>
       In this document and related Nix expressions we use the term
       <emphasis>Beam</emphasis> to describe the environment. Beam is
@@ -373,4 +373,4 @@ $ nix-build -A beamPackages
       that.
     </para>
 </section>
-</chapter>
+</section>
diff --git a/doc/haskell-users-guide.md b/doc/languages-frameworks/haskell.md
similarity index 99%
rename from doc/haskell-users-guide.md
rename to doc/languages-frameworks/haskell.md
index b981466bf2e..ef10ea58369 100644
--- a/doc/haskell-users-guide.md
+++ b/doc/languages-frameworks/haskell.md
@@ -3,7 +3,7 @@ title: User's Guide for Haskell in Nixpkgs
 author: Peter Simons
 date: 2015-06-01
 ---
-# User's Guide to the Haskell Infrastructure
+# Haskell
 
 
 ## How to install Haskell packages
diff --git a/doc/languages-frameworks/index.xml b/doc/languages-frameworks/index.xml
index 395d4688021..8076c33f1b3 100644
--- a/doc/languages-frameworks/index.xml
+++ b/doc/languages-frameworks/index.xml
@@ -13,19 +13,20 @@ in Nixpkgs to easily build packages for other programming languages,
 such as Perl or Haskell.  These are described in this chapter.</para>
 
 
-<xi:include href="perl.xml" />
-<xi:include href="python.xml" />
-<xi:include href="ruby.xml" />
+<xi:include href="beam.xml" />
+<xi:include href="bower.xml" />
+<xi:include href="coq.xml" />
 <xi:include href="go.xml" />
+<xi:include href="haskell.xml" />
+<xi:include href="idris.xml" /> <!-- generated from ../../pkgs/development/idris-modules/README.md  -->
 <xi:include href="java.xml" />
 <xi:include href="lua.xml" />
-<xi:include href="coq.xml" />
-<xi:include href="idris.xml" /> <!-- generated from ../../pkgs/development/idris-modules/README.md  -->
-<xi:include href="r.xml" /> <!-- generated from ../../pkgs/development/r-modules/README.md  -->
+<xi:include href="perl.xml" />
+<xi:include href="python.xml" />
 <xi:include href="qt.xml" />
+<xi:include href="r.xml" /> <!-- generated from ../../pkgs/development/r-modules/README.md  -->
+<xi:include href="ruby.xml" />
 <xi:include href="texlive.xml" />
-<xi:include href="bower.xml" />
 
 
 </chapter>
-
diff --git a/doc/manual.xml b/doc/manual.xml
index 1045d0d4f81..32e94e8e59c 100644
--- a/doc/manual.xml
+++ b/doc/manual.xml
@@ -20,8 +20,6 @@
   <xi:include href="package-notes.xml" />
   <xi:include href="coding-conventions.xml" />
   <xi:include href="submitting-changes.xml" />
-  <xi:include href="haskell-users-guide.xml" />
-  <xi:include href="beam-users-guide.xml" />
   <xi:include href="contributing.xml" />
 
 </book>