Make each source file more consistent

It is vital to denote the file name and summary for each source,
otherwise readers could not figure out the corresponding files.

diff --git a/examples/bottomhalf.c b/examples/bottomhalf.c
index e04ea57ad3fa50c6c0f311fe9bafafd1ff921a28..64d98738b315d0b11c3f06a2dcd9c0cd90ce9b46 100644 (file)
--- a/examples/bottomhalf.c
+++ b/examples/bottomhalf.c
@@ -1,8 +1,8 @@
 /*
  * bottomhalf.c - Top and bottom half interrupt handling
  *
- *  Based upon the RPi example by Stefan Wendler (devnull@kaltpost.de)
- *  from:
+ * Based upon the RPi example by Stefan Wendler (devnull@kaltpost.de)
+ * from:
  *    https://github.com/wendlers/rpi-kmod-samples
  *
  *  Press one button to turn on a LED and another to turn it off

diff --git a/examples/chardev.h b/examples/chardev.h
index e67a09aaa960b7d33bd9a0fc7373dda2d2cc0ad3..136ffed3a385e797d68717f9b47f9cf892ace6cb 100644 (file)
--- a/examples/chardev.h
+++ b/examples/chardev.h
@@ -1,5 +1,5 @@
 /*
- *  chardev2.h - the header file with the ioctl definitions.
+ *  chardev.h - the header file with the ioctl definitions.
  *
  *  The declarations here have to be in a header file, because
  *  they need to be known both to the kernel module

diff --git a/examples/completions.c b/examples/completions.c
index 88c7be97aa009f28287dc947ef71bbe26795f517..b3b472e3450c46d4580b7f2f873b4efb37c47654 100644 (file)
--- a/examples/completions.c
+++ b/examples/completions.c
@@ -1,3 +1,6 @@
+/*
+ *  completions.c
+ */
 #include <linux/completion.h>
 #include <linux/init.h>
 #include <linux/kernel.h>

diff --git a/examples/cryptosha256.c b/examples/cryptosha256.c
index 598aa39d67a942a7b7458d8776f15ef00e864714..63c54841c7e0c2b7a441043583ca8be414377599 100644 (file)
--- a/examples/cryptosha256.c
+++ b/examples/cryptosha256.c
@@ -1,3 +1,6 @@
+/*
+ *  cryptosha256.c
+ */
 #include <crypto/internal/hash.h>
 #include <linux/module.h>
 

diff --git a/examples/cryptosk.c b/examples/cryptosk.c
index 6dfca32d6693ed6b2041b64876e8ded4bbd01a74..c5ec7b11b3d17d879cc8db089520ee1b1d6abd58 100644 (file)
--- a/examples/cryptosk.c
+++ b/examples/cryptosk.c
@@ -1,3 +1,6 @@
+/*
+ *  cryptosk.c
+ */
 #include <crypto/internal/skcipher.h>
 #include <linux/crypto.h>
 #include <linux/module.h>

diff --git a/examples/devicemodel.c b/examples/devicemodel.c
index 6b742fb1909de7df27902dbc820ce1d18f94f469..cc2cd59c0c07ca4cd9b71e31443fecc203877145 100644 (file)
--- a/examples/devicemodel.c
+++ b/examples/devicemodel.c
@@ -1,3 +1,6 @@
+/*
+ *  devicemodel.c
+ */
 #include <linux/kernel.h>
 #include <linux/module.h>
 #include <linux/platform_device.h>

diff --git a/examples/example_atomic.c b/examples/example_atomic.c
index 51d740825588b7b715e3c6ee0a7dbaaa62625dba..48fb004d01c20bb806449207b9e2bd71b422334b 100644 (file)
--- a/examples/example_atomic.c
+++ b/examples/example_atomic.c
@@ -1,3 +1,6 @@
+/*
+ *  example_atomic.c
+ */
 #include <linux/interrupt.h>
 #include <linux/kernel.h>
 #include <linux/module.h>

diff --git a/examples/example_mutex.c b/examples/example_mutex.c
index 935c74808f9cbef4cab3f7ed90ad9b83d8cab240..d63cceee71563ecbb92ae75b3a5a601beeeb3ac8 100644 (file)
--- a/examples/example_mutex.c
+++ b/examples/example_mutex.c
@@ -1,3 +1,6 @@
+/*
+ *  example_mutex.c
+ */
 #include <linux/init.h>
 #include <linux/kernel.h>
 #include <linux/module.h>

diff --git a/examples/example_rwlock.c b/examples/example_rwlock.c
index 231f48b88b95f6c8ec800c47fd9b2d20795f0ef5..bca5218833c58888b58735f4a805e6620894cc56 100644 (file)
--- a/examples/example_rwlock.c
+++ b/examples/example_rwlock.c
@@ -1,3 +1,6 @@
+/*
+ *  example_rwlock.c
+ */
 #include <linux/interrupt.h>
 #include <linux/kernel.h>
 #include <linux/module.h>

diff --git a/examples/example_spinlock.c b/examples/example_spinlock.c
index e40eb3512124d50091347b4ff95c8489ec93ae6b..0d0d88ec7fd7e14ff959227a10c8433298d0dee4 100644 (file)
--- a/examples/example_spinlock.c
+++ b/examples/example_spinlock.c
@@ -1,3 +1,6 @@
+/*
+ *  example_spinlock.c
+ */
 #include <linux/init.h>
 #include <linux/interrupt.h>
 #include <linux/kernel.h>

diff --git a/examples/example_tasklet.c b/examples/example_tasklet.c
index 12645fa6a0b4680501783a71622d2ea3ce7c1ecd..372db15b5ae72a0d29ab2fd4fe50941ec54907dc 100644 (file)
--- a/examples/example_tasklet.c
+++ b/examples/example_tasklet.c
@@ -1,3 +1,6 @@
+/*
+ *  example_tasklet.c
+ */
 #include <linux/delay.h>
 #include <linux/interrupt.h>
 #include <linux/kernel.h>

diff --git a/examples/hello-sysfs.c b/examples/hello-sysfs.c
index 49bf6ba0085fa600c1891cc8df342f81e590035c..f764e67fd24a93de3f1e3986df56b6cbb98da896 100644 (file)
--- a/examples/hello-sysfs.c
+++ b/examples/hello-sysfs.c
@@ -1,7 +1,6 @@
 /*
- * hello-sysfs.c sysfs example
+ *  hello-sysfs.c sysfs example
  */
-
 #include <linux/fs.h>
 #include <linux/init.h>
 #include <linux/kobject.h>

diff --git a/examples/ioctl.c b/examples/ioctl.c
index 73af12b534febc0b9ac09f40d8c4e0acee44d726..f847500f01cd9770146876da85aadb7c68d8ff30 100644 (file)
--- a/examples/ioctl.c
+++ b/examples/ioctl.c
@@ -1,3 +1,6 @@
+/*
+ *  ioctl.c
+ */
 #include <linux/cdev.h>
 #include <linux/fs.h>
 #include <linux/init.h>

diff --git a/examples/other/cat_noblock.c b/examples/other/cat_noblock.c
index d427bd070dff2f0ef9326b9a62ce0e769dfdadc4..42117cd88f62930144a42051d4a309533f11bdb3 100644 (file)
--- a/examples/other/cat_noblock.c
+++ b/examples/other/cat_noblock.c
@@ -1,6 +1,7 @@
-/* cat_noblock.c - open a file and display its contents, but exit rather than
- * wait for input */
-
+/*
+ *  cat_noblock.c - open a file and display its contents, but exit rather than
+ *  wait for input.
+ */
 #include <errno.h>  /* for errno */
 #include <fcntl.h>  /* for open */
 #include <stdio.h>  /* standard I/O */
@@ -9,7 +10,6 @@
 
 #define MAX_BYTES 1024 * 4
 
-
 int main(int argc, char *argv[])
 {
     int fd;                 /* The file descriptor for the file to read */

diff --git a/examples/procfs1.c b/examples/procfs1.c
index 42432d89708f5d160a5bb1acd53eee44c4484491..ff88e211d06ed49dd533815b7b1df8d3d35d01a8 100644 (file)
--- a/examples/procfs1.c
+++ b/examples/procfs1.c
@@ -1,6 +1,6 @@
 /*
- procfs1.c
-*/
+ *  procfs1.c
+ */
 
 #include <linux/kernel.h>
 #include <linux/module.h>

diff --git a/examples/procfs2.c b/examples/procfs2.c
index 6e4d4f9a40ace3c2c846620f2b5f832b95cee478..1379a9f28e8e0b642b48429e422030e79306f31b 100644 (file)
--- a/examples/procfs2.c
+++ b/examples/procfs2.c
@@ -1,6 +1,5 @@
-/**
+/*
  *  procfs2.c -  create a "file" in /proc
- *
  */
 
 #include <linux/kernel.h>  /* We're doing kernel work */

diff --git a/examples/procfs3.c b/examples/procfs3.c
index d56d11e3939ac5ce51052e8a6435dede5bccc030..0906bec182f239adeb3851fad3e4280946fd108c 100644 (file)
--- a/examples/procfs3.c
+++ b/examples/procfs3.c
@@ -1,6 +1,6 @@
 /*
-    procfs3.c
-*/
+ *  procfs3.c
+ */
 
 #include <linux/kernel.h>
 #include <linux/module.h>

diff --git a/examples/procfs4.c b/examples/procfs4.c
index e2dc57c90a7e39acf68cf01dd6baab4237bd7be3..cad389b9a62267c29df38414d045e3e9e3793d24 100644 (file)
--- a/examples/procfs4.c
+++ b/examples/procfs4.c
@@ -1,6 +1,6 @@
-/**
+/*
  *  procfs4.c -  create a "file" in /proc
- *      This program uses the seq_file library to manage the /proc file.
+ *  This program uses the seq_file library to manage the /proc file.
  *
  */
 

diff --git a/examples/sched.c b/examples/sched.c
index 3f94bc2aedf15b058463f648c3fcda0f41658e3c..a6a7bcd15b3f39222bd1bf6fd43b4022b99a6a17 100644 (file)
--- a/examples/sched.c
+++ b/examples/sched.c
@@ -1,3 +1,6 @@
+/*
+ *  sched.c
+ */
 #include <linux/init.h>
 #include <linux/module.h>
 #include <linux/workqueue.h>