linux-kernel - [PATCH 2/2] Documentation: admin-guide: remove redundant first paragraph of README.rst

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Date:   Wed, 12 Jul 2017 10:07:45 +0200
From:   Martin Kepplinger <martink@...teo.de>
To:     corbet@....net, sunny@...base.org
Cc:     linux-doc@...r.kernel.org, linux-kernel@...r.kernel.org,
        Martin Kepplinger <martink@...teo.de>
Subject: [PATCH 2/2] Documentation: admin-guide: remove redundant first paragraph of README.rst

"These are the release notes for Linux version 4." is what the header above
says. There's no real need to say that again.

"Read them carefully," Why would we advise people to read one file carefully
but other file not?

"they tell you what this is all about, explain how to install the kernel, and
what to do if something goes wrong." That's just the chapters below. With
rendered docs, the reader doesn't even have to scroll down to have this
sentense's information :)

Therefore let's remove the first paragraph, including the "What is Linux?"
subheader, and start with telling what Linux is. This won't come as a surprise
to the reader.

Signed-off-by: Martin Kepplinger <martink@...teo.de>
---
 Documentation/admin-guide/README.rst | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/Documentation/admin-guide/README.rst b/Documentation/admin-guide/README.rst
index b5343c5aa224..4810ae94dce1 100644
--- a/Documentation/admin-guide/README.rst
+++ b/Documentation/admin-guide/README.rst
@@ -1,13 +1,6 @@
 Linux kernel release 4.x <http://kernel.org/>
 =============================================

-These are the release notes for Linux version 4.  Read them carefully,
-as they tell you what this is all about, explain how to install the
-kernel, and what to do if something goes wrong.
-
-What is Linux?
---------------
-
   Linux is a clone of the operating system Unix, written from scratch by
   Linus Torvalds with assistance from a loosely-knit team of hackers across
   the Net. It aims towards POSIX and Single UNIX Specification compliance.
-- 
2.11.0