meta: Update leading comments in modules/

modules/ahci.c

@@ -2,6 +2,12 @@
  * @brief AHCI Block Device Driver
  * @file modules/ahci.c
  *
+ * @warning This is a stub driver.
+ *
+ * @copyright
+ * This file is part of ToaruOS and is released under the terms
+ * of the NCSA / University of Illinois License - see LICENSE.md
+ * Copyright (C) 2021 K. Lange
  */
 #include <kernel/syscall.h>
 #include <kernel/module.h>

modules/dospart.c

@@ -1,7 +1,13 @@
-/* vim: tabstop=4 shiftwidth=4 noexpandtab
+/**
+ * @file modules/dospart.c
+ * @brief DOS MBR partition table mapper
+ *
+ * Provides partition entries for disks.
+ *
+ * @copyright
  * This file is part of ToaruOS and is released under the terms
  * of the NCSA / University of Illinois License - see LICENSE.md
- * Copyright (C) 2014-2018 K. Lange
+ * Copyright (C) 2014-2021 K. Lange
  */
 #include <kernel/types.h>
 #include <kernel/module.h>

modules/ext2.c

@@ -1,10 +1,13 @@
 /**
- * @file kernel/vfs/ext2.c
+ * @file modules/ext2.c
  * @brief Implementation of the Ext2 filesystem.
  *
- * @copyright 2014-2021 K. Lange <klange@toaruos.org>
+ * @warning There are many known bugs in this implementation.
+ *
+ * @copyright
  * This file is part of ToaruOS and is released under the terms
  * of the NCSA / University of Illinois License - see LICENSE.md
+ * Copyright (C) 2014-2021 K. Lange <klange@toaruos.org>
  */
 #include <errno.h>
 #include <kernel/types.h>

modules/hda.c

@@ -2,6 +2,8 @@
  * @file kernel/audio/hda.c
  * @brief Driver for the Intel High Definition Audio.
  *
+ * @warning This is a stub driver.
+ *
  * @copyright
  * This file is part of ToaruOS and is released under the terms
  * of the NCSA / University of Illinois License - see LICENSE.md

modules/i965.c

@@ -1,11 +1,16 @@
 /**
- * @file  kernel/video/i965.c
+ * @file  modules/i965.c
  * @brief Bitbanged modeset driver for a ThinkPad T410's Intel graphics.
  *
  * This is NOT a viable driver for Intel graphics devices. It assumes Vesa
  * has already properly set up the display pipeline with the needed timings
  * for the panel on one particular model of Lenovo ThinkPad and then sets
  * a handful of registers to get the framebuffer into the right resolution.
+ *
+ * @copyright
+ * This file is part of ToaruOS and is released under the terms
+ * of the NCSA / University of Illinois License - see LICENSE.md
+ * Copyright (C) 2021 K. Lange
  */
 #include <errno.h>
 #include <kernel/printf.h>

modules/test.c

@@ -1,3 +1,15 @@
+/**
+ * @file modules/test.c
+ * @brief Test module.
+ *
+ * Load with various arguments to do things like crash the
+ * kernel or print tracebacks.
+ *
+ * @copyright
+ * This file is part of ToaruOS and is released under the terms
+ * of the NCSA / University of Illinois License - see LICENSE.md
+ * Copyright (C) 2021 K. Lange
+ */
 #include <kernel/printf.h>
 #include <kernel/module.h>
 #include <kernel/assert.h>

modules/vmware.c

@@ -4,8 +4,6 @@
  *
  * Supports absolute mouse cursor and resolution setting.
  *
- * FIXME The vmware display size adjustment is currently disabled.
- *
  * Mouse:
  *   Toggle off / on with ioctl 1 and 2 respectively to /dev/vmmouse.
  *   Supports mouse buttons, unlike the one in VirtualBox.

modules/xhci.c

@@ -1,5 +1,13 @@
 /**
  * @brief xHCI Host Controller Driver
+ * @file modules/xhci.c
+ *
+ * @warning This is a stub driver.
+ *
+ * @copyright
+ * This file is part of ToaruOS and is released under the terms
+ * of the NCSA / University of Illinois License - see LICENSE.md
+ * Copyright (C) 2021 K. Lange
  */
 #include <kernel/module.h>
 #include <kernel/printf.h>