Re: [PATCH] docs: Make CodingStyle and SubmittingPatches symlinks

From: Joe Perches
Date: Fri Jan 13 2017 - 15:03:39 EST


On Fri, 2017-01-13 at 12:41 -0700, Jonathan Corbet wrote:
> On Tue, 10 Jan 2017 14:09:51 -0800
> Joe Perches <joe@xxxxxxxxxxx> 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.