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 17:02:41 +0100 Message-ID: <20160306160241.GA17356@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]:52535) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1acb8y-0001vq-EB for guix-devel@gnu.org; Sun, 06 Mar 2016 11:03:00 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1acb8o-0005mo-Rm for guix-devel@gnu.org; Sun, 06 Mar 2016 11:02:50 -0500 Received: from mailrelay6.public.one.com ([91.198.169.200]:44433) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1acb8o-0005mb-Fy for guix-devel@gnu.org; Sun, 06 Mar 2016 11:02:46 -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? Finally, I think this is unreasonable. I already spent 20 minutes just trying to organise a work-flow: Some of the strings in the manual are taken from docstrings (I think the procedures), others are not (I think the variables and data types). Altogether, I think I would spend an hour updating comments in the source code, together with writing detailed commit messages. If you think it is important that both match, please just revert my patch (and I will not be offended); I did not make important changes anyway. I do not have the energy right now to wade through the docstrings. Instead, I would rather investigate things around installation that I wanted to look at. Andreas