doc: organize chapters into parts, and reduce toc depth

Reorganize the chapters into parts and reduce the TOC depth to make the
TOC useful again. The top-level TOC is very brief, but that is fine
because every part will have its own TOC.

Section titles of languages/frameworks are also simplified to just
the name of the language/framework.

doc/contributing.xml doc/contributing-to-documentation.xml
+1 -1
doc/doc-support/parameters.xml
···
<xsl:param name="html.script" select="'./highlightjs/highlight.pack.js ./highlightjs/loader.js'" />
<xsl:param name="xref.with.number.and.title" select="1" />
<xsl:param name="use.id.as.filename" select="1" />
-
<xsl:param name="toc.section.depth" select="3" />
+
<xsl:param name="toc.section.depth" select="0" />
<xsl:param name="admon.style" select="''" />
<xsl:param name="callout.graphics.extension" select="'.svg'" />
</xsl:stylesheet>
+1 -1
doc/languages-frameworks/emscripten.section.md
···
-
# User's Guide to Emscripten in Nixpkgs
+
# Emscripten
[Emscripten](https://github.com/kripken/emscripten): An LLVM-to-JavaScript Compiler
+1 -1
doc/languages-frameworks/haskell.section.md
···
author: Peter Simons
date: 2015-06-01
---
-
# User's Guide to the Haskell Infrastructure
+
# Haskell
## How to install Haskell packages
+1 -1
doc/languages-frameworks/idris.section.md
···
-
# Idris packages
+
# Idris
## Installing Idris
+1 -1
doc/languages-frameworks/index.xml
···
<chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xml:id="chap-language-support">
-
<title>Support for specific programming languages and frameworks</title>
+
<title>Languages and frameworks</title>
<para>
The <link linkend="chap-stdenv">standard build environment</link> makes it easy to build typical Autotools-based packages with very little code. Any other kind of package can be accomodated by overriding the appropriate phases of <literal>stdenv</literal>. However, there are specialised functions in Nixpkgs to easily build packages for other programming languages, such as Perl or Haskell. These are described in this chapter.
</para>
+2 -2
doc/languages-frameworks/node.section.md
···
-
Node.js packages
-
================
+
Node.js
+
=======
The `pkgs/development/node-packages` folder contains a generated collection of
[NPM packages](https://npmjs.com/) that can be installed with the Nix package
manager.
+2 -2
doc/languages-frameworks/r.section.md
···
-
R packages
-
==========
+
R
+
=
## Installation
+1 -1
doc/languages-frameworks/rust.section.md
···
date: 2017-03-05
---
-
# User's Guide to the Rust Infrastructure
+
# Rust
To install the rust compiler and cargo put
+1 -1
doc/languages-frameworks/vim.section.md
···
author: Marc Weber
date: 2016-06-25
---
-
# User's Guide to Vim Plugins/Addons/Bundles/Scripts in Nixpkgs
+
# Vim
Both Neovim and Vim can be configured to include your favorite plugins
and additional libraries.
+28 -16
doc/manual.xml
···
</subtitle>
</info>
<xi:include href="introduction.chapter.xml" />
-
<xi:include href="quick-start.xml" />
-
<xi:include href="package-specific-user-notes.xml" />
-
<xi:include href="stdenv.xml" />
-
<xi:include href="multiple-output.xml" />
-
<xi:include href="cross-compilation.xml" />
-
<xi:include href="configuration.xml" />
-
<xi:include href="functions.xml" />
-
<xi:include href="meta.xml" />
-
<xi:include href="languages-frameworks/index.xml" />
-
<xi:include href="platform-notes.xml" />
-
<xi:include href="package-notes.xml" />
-
<xi:include href="overlays.xml" />
-
<xi:include href="coding-conventions.xml" />
-
<xi:include href="submitting-changes.xml" />
-
<xi:include href="reviewing-contributions.xml" />
-
<xi:include href="contributing.xml" />
+
<part>
+
<title>Using Nixpkgs</title>
+
<xi:include href="configuration.xml" />
+
<xi:include href="overlays.xml" />
+
<xi:include href="functions.xml" />
+
</part>
+
<part>
+
<title>Standard environment</title>
+
<xi:include href="stdenv.xml" />
+
<xi:include href="meta.xml" />
+
<xi:include href="multiple-output.xml" />
+
<xi:include href="cross-compilation.xml" />
+
<xi:include href="platform-notes.xml" />
+
</part>
+
<part>
+
<title>Languages, frameworks and packages</title>
+
<xi:include href="languages-frameworks/index.xml" />
+
<xi:include href="package-specific-user-notes.xml" />
+
<xi:include href="package-notes.xml" />
+
</part>
+
<part>
+
<title>Contributing to Nixpkgs</title>
+
<xi:include href="quick-start.xml" />
+
<xi:include href="coding-conventions.xml" />
+
<xi:include href="submitting-changes.xml" />
+
<xi:include href="reviewing-contributions.xml" />
+
<xi:include href="contributing-to-documentation.xml" />
+
</part>
</book>
+1 -1
doc/platform-notes.xml
···
<chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink"
-
xml:id="chap-platform-nodes">
+
xml:id="chap-platform-notes">
<title>Platform Notes</title>
<section xml:id="sec-darwin">
<title>Darwin (macOS)</title>
+1 -1
doc/reviewing-contributions.xml
···
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:xi="http://www.w3.org/2001/XInclude"
version="5.0"
-
xml:id="sec-reviewing-contributions">
+
xml:id="chap-reviewing-contributions">
<title>Reviewing contributions</title>
<warning>
<para>