From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([209.51.188.92]:41638) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1glX8a-00048Q-3s for guix-patches@gnu.org; Mon, 21 Jan 2019 05:49:04 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1glX8Z-0006yV-8P for guix-patches@gnu.org; Mon, 21 Jan 2019 05:49:04 -0500 Received: from debbugs.gnu.org ([209.51.188.43]:40183) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1glX8Y-0006yC-T9 for guix-patches@gnu.org; Mon, 21 Jan 2019 05:49:03 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1glX8Y-0007i7-Mf for guix-patches@gnu.org; Mon, 21 Jan 2019 05:49:02 -0500 Subject: [bug#34156] [PATCH 0/4] Re-organize the manual Resent-Message-ID: Received: from eggs.gnu.org ([209.51.188.92]:41396) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1glX7U-0003M7-0r for guix-patches@gnu.org; Mon, 21 Jan 2019 05:47:56 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1glX7P-00061K-Ua for guix-patches@gnu.org; Mon, 21 Jan 2019 05:47:55 -0500 From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Date: Mon, 21 Jan 2019 11:47:41 +0100 Message-Id: <20190121104741.14511-1-ludo@gnu.org> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+kyle=kyleam.com@gnu.org Sender: "Guix-patches" To: 34156@debbugs.gnu.org Hello Guix! This is the great season cleanup of the manual. I think it provides a clearer view of what=E2=80=99s available. Until now, the top-level cha= pters were: --8<---------------cut here---------------start------------->8--- * Introduction:: What is Guix about? * Installation:: Installing Guix. * Package Management:: Package installation, upgrade, etc. * Programming Interface:: Using Guix in Scheme. * Utilities:: Package management commands. * GNU Distribution:: Software for your friendly GNU system. * Contributing:: Your help needed! --8<---------------cut here---------------end--------------->8--- With these changes, that becomes: --8<---------------cut here---------------start------------->8--- * Introduction:: What is Guix about? * Installation:: Installing Guix. * System Installation:: Installing the whole operating system. * Package Management:: Package installation, upgrade, etc. * Programming Interface:: Using Guix in Scheme. * Utilities:: Package management commands. * System Configuration:: Configuring the operating system. * Documentation:: Browsing software user manuals. * Installing Debugging Files:: Feeding the debugger. * Security Updates:: Deploying security fixes quickly. * Bootstrapping:: GNU/Linux built from scratch. * Porting:: Targeting another platform or kernel. * Contributing:: Your help needed! --8<---------------cut here---------------end--------------->8--- Things about =E2=80=9Cthe distro=E2=80=9D in a broad sense are no longer = hidden under =E2=80=9CGNU Distribution=E2=80=9D and the introduction no longer i= gnores Guix System. Next up I=E2=80=99d like us to get rid of these catch-all =E2=80=9CUtilit= ies=E2=80=9D section and instead organize things by activities, such as =E2=80=9CDevelopment=E2=80=9D, =E2=80=9CDistributing Substitutes=E2=80=9D= , and =E2=80=9CManaging Storage Space=E2=80=9D. Later I=E2=80=99d like to move each chapter to its own .texi file, which will be nicer and will help Emacs build menus (currently it=E2=80=99s confused because only one chapter leaves in a separate file.) Thoughts? Ludo=E2=80=99. Ludovic Court=C3=A8s (4): doc: Move sections under "GNU Distribution" one level higher. doc: Move "System Installation" right after "Installation". doc: Move "Packaging Guidelines" under "Contributing". doc: Move "Package Modules" under "Programming Interface". doc/contributing.texi | 450 ++++++++ doc/guix.texi | 2254 ++++++++++++++++------------------------- 2 files changed, 1336 insertions(+), 1368 deletions(-) --=20 2.20.1