From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jakub Narebski Subject: Re: [PATCH] Documentation/config.txt: Order variables alphabetically Date: Thu, 2 Dec 2010 00:38:52 +0100 Message-ID: <201012020038.55019.jnareb@gmail.com> References: <1291209174-9239-1-git-send-email-jari.aalto@cante.net> <87vd3dv2ow.fsf@picasso.cante.net> <20101201180332.GC7774@sigill.intra.peff.net> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit Cc: Jari Aalto , Thomas Rast , git@vger.kernel.org To: Jeff King X-From: git-owner@vger.kernel.org Thu Dec 02 00:39:16 2010 Return-path: Envelope-to: gcvg-git-2@lo.gmane.org Received: from vger.kernel.org ([209.132.180.67]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1PNwGV-0004oX-F1 for gcvg-git-2@lo.gmane.org; Thu, 02 Dec 2010 00:39:11 +0100 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1756341Ab0LAXjF (ORCPT ); Wed, 1 Dec 2010 18:39:05 -0500 Received: from mail-bw0-f46.google.com ([209.85.214.46]:52076 "EHLO mail-bw0-f46.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1755655Ab0LAXjE (ORCPT ); Wed, 1 Dec 2010 18:39:04 -0500 Received: by bwz15 with SMTP id 15so6686443bwz.19 for ; Wed, 01 Dec 2010 15:39:02 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:from:to:subject:date :user-agent:cc:references:in-reply-to:mime-version:content-type :content-transfer-encoding:content-disposition:message-id; bh=cqRdPzzUy1Ds362TaBKw8JxD69S9L2nsiaecINKTuoU=; b=LbUnq84WvJJjVQ6geT3K/lLe5gL8OIaZP3sBv5STdmkm1/h29n571u7F7mZVdz6eNV P6pUVZVWauJPTkq66zREIgcssa1Ktpd7Zs4xUoQgpxrPJOxYdO6mVE/y3OibG8lIDUbF LYSqkXZso/1aoxZLNyqUkoLtKnrjqeFyhL0r4= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=from:to:subject:date:user-agent:cc:references:in-reply-to :mime-version:content-type:content-transfer-encoding :content-disposition:message-id; b=hcpr8Ba3dyUfOM1VZm3pqCkizee+gJqZYpSXy0Y6G2p2RWZPBDDU82orKOF12FbOwy EJD3jI8vbSmewpdsGqaQv7yZLm5Rxdlppc5XqhuBrtDI+we+ENqoeiT9n2bBLkWoPPek wbFN9Ny8lRyeY9GMrq7XnoL9//AmD/a4Uz87Y= Received: by 10.204.52.132 with SMTP id i4mr9203456bkg.65.1291246741976; Wed, 01 Dec 2010 15:39:01 -0800 (PST) Received: from [192.168.1.13] (abvl90.neoplus.adsl.tpnet.pl [83.8.209.90]) by mx.google.com with ESMTPS id g8sm3719626bkg.11.2010.12.01.15.38.59 (version=TLSv1/SSLv3 cipher=RC4-MD5); Wed, 01 Dec 2010 15:39:00 -0800 (PST) User-Agent: KMail/1.9.3 In-Reply-To: <20101201180332.GC7774@sigill.intra.peff.net> Content-Disposition: inline Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Archived-At: On Wed, 1 Dec 2010, Jeff King wrote: > On Wed, Dec 01, 2010 at 07:10:55PM +0200, Jari Aalto wrote: > > > 2010-12-01 18:37 Jakub Narebski : > > > Having related config variables together is IMVHO more important than > > > having config variables sorted alphabetically. > > > > That's subjective criteria. I doubt there are many related one that > > can't be handled with standard "see also". > > Don't we already have a plan and some patches in flight (from Thomas) to > turn the master list into a straight one-line-per-config index (which > probably _should_ be alphabetized), and then put related options into > their respective manpages (which effectively sorts them by > functionality)? Actually Thomas Rast patches (the 'tr/config-doc', not even in 'pu') are about finding config variables referenced in individual manpages but not in list of config variables, and adding reference to them in list of all config variables. Sorting list of variables is orthogonal to that (though first version sorted by default). > > This patch is just going to cause conflicts with Thomas's, and in the > end will be obsoleted by it. Could be obsoleted, yes (if we chose sorting). Cause confict, no; at least if first patch in series is generated by script, as described in http://permalink.gmane.org/gmane.comp.version-control.git/162145 -- Jakub Narebski Poland