From mboxrd@z Thu Jan 1 00:00:00 1970 From: Andreas Enge Subject: Re: 01/01: doc: Typos and small stylistic changes. Date: Sun, 6 Mar 2016 14:10:42 +0100 Message-ID: <20160306131042.GA13567@solar> References: <20160305152745.10002.35086@vcs.savannah.gnu.org> <877fhg38b2.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-15 Content-Transfer-Encoding: 8bit Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:38743) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1acYSQ-0000O8-Q5 for guix-devel@gnu.org; Sun, 06 Mar 2016 08:10:51 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1acYSO-0004TY-Kh for guix-devel@gnu.org; Sun, 06 Mar 2016 08:10:50 -0500 Received: from mailrelay7.public.one.com ([91.198.169.215]:41427) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1acYSO-0004TL-9g for guix-devel@gnu.org; Sun, 06 Mar 2016 08:10:48 -0500 Content-Disposition: inline In-Reply-To: <877fhg38b2.fsf@gnu.org> List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org To: Ludovic =?iso-8859-15?Q?Court=E8s?= Cc: guix-devel@gnu.org On Sat, Mar 05, 2016 at 10:48:33PM +0100, Ludovic Courtès wrote: > This commit modifies some of the service documentation, which is also > available in docstrings in gnu/services/*.scm. Could you update them > accordingly? Oh dear, correcting typos in the texinfo manual is already close to more work than what the result is worth (but well, I am not complaining, I did it voluntarily); now looking up where I marked my paper copy, checking how I changed things in guix.texi and modifying the source code accordingly sounds very tedious. I will give it a try. I suppose it is not easily possible to import the doc strings automatically into the texinfo file, in a way that we would keep a hand-written manual, but with small pieces automatically extracted from the source code? Maintaining two separate documents is always a bit painful. Andreas