From patchwork Mon Jan 21 10:47:41 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Ludovic_Court=C3=A8s?= X-Patchwork-Id: 775 Return-Path: X-Original-To: patchwork@mira.cbaines.net Delivered-To: patchwork@mira.cbaines.net Received: by mira.cbaines.net (Postfix, from userid 113) id 880A316A47; Mon, 21 Jan 2019 10:51:57 +0000 (GMT) X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on mira.cbaines.net X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=ham autolearn_force=no version=3.4.0 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mira.cbaines.net (Postfix) with ESMTP id 22C2116A40 for ; Mon, 21 Jan 2019 10:51:57 +0000 (GMT) Received: from localhost ([127.0.0.1]:51676 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1glXBM-0005nv-FJ for patchwork@mira.cbaines.net; Mon, 21 Jan 2019 05:51:56 -0500 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 X-Loop: help-debbugs@gnu.org Subject: [bug#34156] [PATCH 0/4] Re-organize the manual Resent-From: Ludovic =?utf-8?q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Mon, 21 Jan 2019 10:49:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 34156 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 34156@debbugs.gnu.org X-Debbugs-Original-To: guix-patches@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.154806768529573 (code B ref -1); Mon, 21 Jan 2019 10:49:02 +0000 Received: (at submit) by debbugs.gnu.org; 21 Jan 2019 10:48:05 +0000 Received: from localhost ([127.0.0.1]:39464 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1glX7c-0007gv-La for submit@debbugs.gnu.org; Mon, 21 Jan 2019 05:48:04 -0500 Received: from eggs.gnu.org ([209.51.188.92]:59433) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1glX7a-0007gR-UB for submit@debbugs.gnu.org; Mon, 21 Jan 2019 05:48:03 -0500 Received: from lists.gnu.org ([209.51.188.17]:34009) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1glX7U-00065S-V5 for submit@debbugs.gnu.org; Mon, 21 Jan 2019 05:47:57 -0500 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 Received: from hera.aquilenet.fr ([2a0c:e300::1]:56440) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1glX7P-0005xw-OO; Mon, 21 Jan 2019 05:47:51 -0500 Received: from localhost (localhost [127.0.0.1]) by hera.aquilenet.fr (Postfix) with ESMTP id 8DB043FED; Mon, 21 Jan 2019 11:47:47 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at aquilenet.fr Received: from hera.aquilenet.fr ([127.0.0.1]) by localhost (hera.aquilenet.fr [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id liorBhl-l7TR; Mon, 21 Jan 2019 11:47:46 +0100 (CET) Received: from gnu.org (unknown [IPv6:2001:660:6102:320:e120:2c8f:8909:cdfe]) by hera.aquilenet.fr (Postfix) with ESMTPSA id B8AC73FA3; Mon, 21 Jan 2019 11:47:46 +0100 (CET) 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> X-Mailer: git-send-email 2.20.1 MIME-Version: 1.0 X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org Sender: "Guix-patches" X-getmail-retrieved-from-mailbox: Patches Hello Guix! This is the great season cleanup of the manual. I think it provides a clearer view of what’s available. Until now, the top-level chapters 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 “the distro” in a broad sense are no longer hidden under “GNU Distribution” and the introduction no longer ignores Guix System. Next up I’d like us to get rid of these catch-all “Utilities” section and instead organize things by activities, such as “Development”, “Distributing Substitutes”, and “Managing Storage Space”. Later I’d like to move each chapter to its own .texi file, which will be nicer and will help Emacs build menus (currently it’s confused because only one chapter leaves in a separate file.) Thoughts? Ludo’. Ludovic Courtès (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(-)