linux-kernel.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* [PATCH v2] Documentation: kernel-docs: Remove entry for vfs.txt
@ 2019-04-06 10:15 Jonathan Neuschäfer
  2019-04-08 22:05 ` Jonathan Corbet
  0 siblings, 1 reply; 2+ messages in thread
From: Jonathan Neuschäfer @ 2019-04-06 10:15 UTC (permalink / raw)
  To: linux-doc
  Cc: Jonathan Neuschäfer, Jonathan Corbet, Martin Kepplinger,
	Federico Vaga, linux-kernel

It's unnecessary to point to an external mirror of the Documentation
directory.

Jonathan Corbet writes in favor of removing this entry, instead of
moving it under "Docs at the Linux Kernel tree":

> We don't want to turn kernel-docs.rst into yet another out-of-date
> index for the rest of Documentation/, and the removal of the external
> URL takes away the only bit of additional information that this entry
> offers.

Signed-off-by: Jonathan Neuschäfer <j.neuschaefer@gmx.net>
---

v2:
- Follow Jonathan Corbet's suggestion of dropping this list entry
  entirely
- I didn't include Martin Kepplinger's R-b, because v2 is significantly
  different from v1

v1:
https://lore.kernel.org/lkml/20190331221439.22892-1-j.neuschaefer@gmx.net/
---
 Documentation/process/kernel-docs.rst | 12 ------------
 1 file changed, 12 deletions(-)

diff --git a/Documentation/process/kernel-docs.rst b/Documentation/process/kernel-docs.rst
index ab12dddc773e..7a45a8e36ea7 100644
--- a/Documentation/process/kernel-docs.rst
+++ b/Documentation/process/kernel-docs.rst
@@ -95,18 +95,6 @@ On-line docs
         [...]. This paper examines some common problems for
         submitting larger changes and some strategies to avoid problems.

-    * Title: **Overview of the Virtual File System**
-
-      :Author: Richard Gooch.
-      :URL: http://www.mjmwired.net/kernel/Documentation/filesystems/vfs.txt
-      :Date: 2007
-      :Keywords: VFS, File System, mounting filesystems, opening files,
-        dentries, dcache.
-      :Description: Brief introduction to the Linux Virtual File System.
-        What is it, how it works, operations taken when opening a file or
-        mounting a file system and description of important data
-        structures explaining the purpose of each of their entries.
-
     * Title: **Linux Device Drivers, Third Edition**

       :Author: Jonathan Corbet, Alessandro Rubini, Greg Kroah-Hartman
--
2.20.1


^ permalink raw reply related	[flat|nested] 2+ messages in thread

* Re: [PATCH v2] Documentation: kernel-docs: Remove entry for vfs.txt
  2019-04-06 10:15 [PATCH v2] Documentation: kernel-docs: Remove entry for vfs.txt Jonathan Neuschäfer
@ 2019-04-08 22:05 ` Jonathan Corbet
  0 siblings, 0 replies; 2+ messages in thread
From: Jonathan Corbet @ 2019-04-08 22:05 UTC (permalink / raw)
  To: Jonathan Neuschäfer
  Cc: linux-doc, Martin Kepplinger, Federico Vaga, linux-kernel

On Sat,  6 Apr 2019 12:15:27 +0200
Jonathan Neuschäfer <j.neuschaefer@gmx.net> wrote:

> It's unnecessary to point to an external mirror of the Documentation
> directory.
> 
> Jonathan Corbet writes in favor of removing this entry, instead of
> moving it under "Docs at the Linux Kernel tree":
> 
> > We don't want to turn kernel-docs.rst into yet another out-of-date
> > index for the rest of Documentation/, and the removal of the external
> > URL takes away the only bit of additional information that this entry
> > offers.  
> 
> Signed-off-by: Jonathan Neuschäfer <j.neuschaefer@gmx.net>

Applied, thanks.

jon

^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2019-04-08 22:05 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2019-04-06 10:15 [PATCH v2] Documentation: kernel-docs: Remove entry for vfs.txt Jonathan Neuschäfer
2019-04-08 22:05 ` Jonathan Corbet

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).