From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751390AbdAMUDa (ORCPT ); Fri, 13 Jan 2017 15:03:30 -0500 Received: from smtprelay0037.hostedemail.com ([216.40.44.37]:39351 "EHLO smtprelay.hostedemail.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1750789AbdAMUD2 (ORCPT ); Fri, 13 Jan 2017 15:03:28 -0500 X-Session-Marker: 6A6F6540706572636865732E636F6D X-Spam-Summary: 2,0,0,,d41d8cd98f00b204,joe@perches.com,:::::::,RULES_HIT:41:355:379:541:599:800:960:973:988:989:1260:1277:1311:1313:1314:1345:1359:1373:1437:1515:1516:1518:1534:1541:1593:1594:1711:1730:1747:1777:1792:2393:2553:2559:2562:2828:2902:2917:3138:3139:3140:3141:3142:3352:3622:3653:3865:3867:3868:3871:3872:3874:4321:5007:6119:7903:8957:10004:10400:10450:10455:10848:10967:11232:11639:11658:11914:12291:12663:12740:12760:12895:13069:13161:13229:13311:13357:13439:14096:14097:14181:14659:14721:19904:19999:21080:21326:30054:30070:30090:30091,0,RBL:none,CacheIP:none,Bayesian:0.5,0.5,0.5,Netcheck:none,DomainCache:0,MSF:not bulk,SPF:fn,MSBL:0,DNSBL:none,Custom_rules:0:0:0,LFtime:2,LUA_SUMMARY:none X-HE-Tag: stone85_754007600935c X-Filterd-Recvd-Size: 1973 Message-ID: <1484337804.3065.36.camel@perches.com> Subject: Re: [PATCH] docs: Make CodingStyle and SubmittingPatches symlinks From: Joe Perches To: Jonathan Corbet Cc: Mauro Carvalho Chehab , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Date: Fri, 13 Jan 2017 12:03:24 -0800 In-Reply-To: <20170113124135.7873b9c7@lwn.net> References: <4a5d167c038ac98c51bd034855f1dca9a3e0f6fb.1484086131.git.joe@perches.com> <20170113124135.7873b9c7@lwn.net> Content-Type: text/plain; charset="ISO-8859-1" X-Mailer: Evolution 3.22.3-0ubuntu0.1 Mime-Version: 1.0 Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Fri, 2017-01-13 at 12:41 -0700, Jonathan Corbet wrote: > On Tue, 10 Jan 2017 14:09:51 -0800 > Joe Perches wrote: > > > Make these files symlinks to the .rst equivalents > > So I am not necessarily opposed to doing this, but the changelog lacks > one important thing: why do we need to make that change? Have the > existing one-liner files been a problem somehow? The files tell people to open other files. Giving the old link to people just tells them to use the new filename instead. symlinks open the new file automatically. $ head Documentation/CodingStyle This file has moved to process/coding-style.rst vs a symlink $ head Documentation/CodingStyle .. _codingstyle: Linux kernel coding style ========================= This is a short document describing the preferred coding style for the linux kernel. Coding style is very personal, and I won't **force** my views on anybody, but this is what goes for anything that I have to be able to maintain, and I'd prefer it for most other things too. Please at least consider the points made here.