15 Jul, 2019

1 commit

• 113094f74   docs: add some directories to the main documentation index ... Browse Code »

  The contents of those directories were orphaned at the documentation
  body.

  While those directories could likely be moved to be inside some guide,
  I'm opting to just adding their indexes to the main one, removing the
  :orphan: and adding the SPDX header.

  For the drivers, the rationale is that the documentation contains
  a mix of Kernelspace, uAPI and admin-guide. So, better to keep them on
  separate directories, as we've be doing with similar subsystem-specific
  docs that were not split yet.

  For the others, well... I'm too lazy to do the move. Also, it
  seems to make sense to keep at least some of those at the main
  dir (like kbuild, for example). In any case, a latter patch
  could do the move.

  Signed-off-by: Mauro Carvalho Chehab
  Acked-by: Bartlomiej Zolnierkiewicz

  Mauro Carvalho Chehab

  2019-07-15 22:03:03 +0800  

15 Jun, 2019

1 commit

• 593733ab8   docs: netlabel: convert docs to ReST and rename to *.rst ... Browse Code »

  Convert netlabel documentation to ReST.

  This was trivial: just add proper title markups.

  At its new index.rst, let's add a :orphan: while this is not linked to
  the main index.rst file, in order to avoid build warnings.

  Signed-off-by: Mauro Carvalho Chehab
  Acked-by: Paul Moore
  Signed-off-by: Jonathan Corbet

  Mauro Carvalho Chehab

  2019-06-15 04:23:30 +0800  

10 Sep, 2018

1 commit

• a7ddcea58   Drop all 00-INDEX files from Documentation/ ... Browse Code »

  This is a respin with a wider audience (all that get_maintainer returned)
  and I know this spams a *lot* of people. Not sure what would be the correct
  way, so my apologies for ruining your inbox.

  The 00-INDEX files are supposed to give a summary of all files present
  in a directory, but these files are horribly out of date and their
  usefulness is brought into question. Often a simple "ls" would reveal
  the same information as the filenames are generally quite descriptive as
  a short introduction to what the file covers (it should not surprise
  anyone what Documentation/sched/sched-design-CFS.txt covers)

  A few years back it was mentioned that these files were no longer really
  needed, and they have since then grown further out of date, so perhaps
  it is time to just throw them out.

  A short status yields the following _outdated_ 00-INDEX files, first
  counter is files listed in 00-INDEX but missing in the directory, last
  is files present but not listed in 00-INDEX.

  List of outdated 00-INDEX:
  Documentation: (4/10)
  Documentation/sysctl: (0/1)
  Documentation/timers: (1/0)
  Documentation/blockdev: (3/1)
  Documentation/w1/slaves: (0/1)
  Documentation/locking: (0/1)
  Documentation/devicetree: (0/5)
  Documentation/power: (1/1)
  Documentation/powerpc: (0/5)
  Documentation/arm: (1/0)
  Documentation/x86: (0/9)
  Documentation/x86/x86_64: (1/1)
  Documentation/scsi: (4/4)
  Documentation/filesystems: (2/9)
  Documentation/filesystems/nfs: (0/2)
  Documentation/cgroup-v1: (0/2)
  Documentation/kbuild: (0/4)
  Documentation/spi: (1/0)
  Documentation/virtual/kvm: (1/0)
  Documentation/scheduler: (0/2)
  Documentation/fb: (0/1)
  Documentation/block: (0/1)
  Documentation/networking: (6/37)
  Documentation/vm: (1/3)

  Then there are 364 subdirectories in Documentation/ with several files that
  are missing 00-INDEX alltogether (and another 120 with a single file and no
  00-INDEX).

  I don't really have an opinion to whether or not we /should/ have 00-INDEX,
  but the above 00-INDEX should either be removed or be kept up to date. If
  we should keep the files, I can try to keep them updated, but I rather not
  if we just want to delete them anyway.

  As a starting point, remove all index-files and references to 00-INDEX and
  see where the discussion is going.

  Signed-off-by: Henrik Austad
  Acked-by: "Paul E. McKenney"
  Just-do-it-by: Steven Rostedt
  Reviewed-by: Jens Axboe
  Acked-by: Paul Moore
  Acked-by: Greg Kroah-Hartman
  Acked-by: Mark Brown
  Acked-by: Mike Rapoport
  Cc: [Almost everybody else]
  Signed-off-by: Jonathan Corbet

  Henrik Austad

  2018-09-10 05:08:58 +0800  

23 Apr, 2010

1 commit

• a33f32244   Documentation/: it's -> its where appropriate ... Browse Code »

  Fix obvious cases of "it's" being used when "its" was meant.

  Signed-off-by: Francis Galiegue
  Acked-by: Randy Dunlap
  Signed-off-by: Jiri Kosina

  Francis Galiegue

  2010-04-23 08:09:52 +0800  

09 May, 2007

1 commit

• 59c51591a   Fix occurrences of "the the " ... Browse Code »

  Signed-off-by: Michael Opdenacker
  Signed-off-by: Adrian Bunk

  Michael Opdenacker

  2007-05-09 14:57:56 +0800  

23 Sep, 2006

1 commit

• 8802f616f   [NetLabel]: documentation ... Browse Code »

  Documentation for the NetLabel system, this includes a basic overview
  of how NetLabel works, how LSM developers can integrate it into their
  favorite LSM, as well as documentation on the CIPSO related sysctl
  variables. Also, due to the difficulty of finding expired IETF
  drafts, I am including the IETF CIPSO draft that is the basis of the
  NetLabel CIPSO implementation.

  Signed-off-by: Paul Moore
  Signed-off-by: David S. Miller

  Paul Moore

  2006-09-23 05:53:31 +0800