#320011 by lilou, snufkin, and karschp: Add consistent @file declarations to all .install files.

32 files changed, 152 insertions, 2 deletions

diff --git a/modules/aggregator/aggregator.install b/modules/aggregator/aggregator.install
index 7954baea6..f83ae332d 100644
--- a/modules/aggregator/aggregator.install
+++ b/modules/aggregator/aggregator.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the aggregator module.
+ */
+
+/**
  * Implementation of hook_install().
  */
 function aggregator_install() {
diff --git a/modules/block/block.install b/modules/block/block.install
index 628e9160d..cc2dd690d 100644
--- a/modules/block/block.install
+++ b/modules/block/block.install
@@ -3,7 +3,7 @@
 
 /**
  * @file
- * Install instructions for the block module
+ * Install, update and uninstall functions for the block module.
  */
 
 /**
diff --git a/modules/blogapi/blogapi.install b/modules/blogapi/blogapi.install
index a8bb46d9b..22820ea4a 100644
--- a/modules/blogapi/blogapi.install
+++ b/modules/blogapi/blogapi.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the blogapi module.
+ */
+
+/**
  * Implementation of hook_install().
  */
 function blogapi_install() {
diff --git a/modules/book/book.install b/modules/book/book.install
index bac5bfd2b..2b1b57de0 100644
--- a/modules/book/book.install
+++ b/modules/book/book.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the book module.
+ */
+
+/**
  * Implementation of hook_install().
  */
 function book_install() {
diff --git a/modules/color/color.install b/modules/color/color.install
index 165d13158..6af5f7261 100644
--- a/modules/color/color.install
+++ b/modules/color/color.install
@@ -1,6 +1,11 @@
 <?php
 /* $Id$ */
 
+/**
+ * @file
+ * Install, update and uninstall functions for the color module.
+ */
+
 function color_requirements($phase) {
   $requirements = array();
 
diff --git a/modules/comment/comment.install b/modules/comment/comment.install
index 0ae7e1980..1f4767af9 100644
--- a/modules/comment/comment.install
+++ b/modules/comment/comment.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the comment module.
+ */
+
+/**
  * Implementation of hook_install().
  */
 function comment_install() {
diff --git a/modules/contact/contact.install b/modules/contact/contact.install
index 559e0733b..dc0d210cc 100644
--- a/modules/contact/contact.install
+++ b/modules/contact/contact.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the contact module.
+ */
+
+/**
  * Implementation of hook_install().
  */
 function contact_install() {
diff --git a/modules/dblog/dblog.install b/modules/dblog/dblog.install
index a1dbbf344..3c9afb61d 100644
--- a/modules/dblog/dblog.install
+++ b/modules/dblog/dblog.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the dblog module.
+ */
+
+/**
  * Implementation of hook_install().
  */
 function dblog_install() {
diff --git a/modules/field/field.install b/modules/field/field.install
index 49972a4d0..059376b43 100644
--- a/modules/field/field.install
+++ b/modules/field/field.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the field module.
+ */
+
+/**
  * Implementation of hook_install().
  */
 function field_install() {
diff --git a/modules/field/modules/field_sql_storage/field_sql_storage.install b/modules/field/modules/field_sql_storage/field_sql_storage.install
index c92a8e72d..b31a94539 100644
--- a/modules/field/modules/field_sql_storage/field_sql_storage.install
+++ b/modules/field/modules/field_sql_storage/field_sql_storage.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the field_sql_storage module.
+ */
+
+/**
  * Implementation of hook_install().
  */
 function field_sql_storage_install() {
diff --git a/modules/filter/filter.install b/modules/filter/filter.install
index caf908390..fb2a2ddeb 100644
--- a/modules/filter/filter.install
+++ b/modules/filter/filter.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the filter module.
+ */
+
+/**
  * Implementation of hook_schema().
  */
 function filter_schema() {
diff --git a/modules/forum/forum.install b/modules/forum/forum.install
index cc6963e98..2d2e1a9bd 100644
--- a/modules/forum/forum.install
+++ b/modules/forum/forum.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the forum module.
+ */
+
+/**
  * Implementation of hook_install().
  */
 function forum_install() {
diff --git a/modules/locale/locale.install b/modules/locale/locale.install
index d9ef10afb..97d8f0978 100644
--- a/modules/locale/locale.install
+++ b/modules/locale/locale.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the locale module.
+ */
+
+/**
  * Implementation of hook_install().
  */
 function locale_install() {
diff --git a/modules/menu/menu.install b/modules/menu/menu.install
index dc96c84d1..34af84afe 100644
--- a/modules/menu/menu.install
+++ b/modules/menu/menu.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the menu module.
+ */
+
+/**
  * Implementation of hook_install().
  */
 function menu_install() {
diff --git a/modules/node/node.install b/modules/node/node.install
index 2aefeb09e..486826920 100644
--- a/modules/node/node.install
+++ b/modules/node/node.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the node module.
+ */
+
+/**
  * Implementation of hook_schema().
  */
 function node_schema() {
diff --git a/modules/openid/openid.install b/modules/openid/openid.install
index 9e482fc50..5e0f9d9bb 100644
--- a/modules/openid/openid.install
+++ b/modules/openid/openid.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the openid module.
+ */
+
+/**
  * Implementation of hook_install().
  */
 function openid_install() {
diff --git a/modules/openid/tests/openid_test.install b/modules/openid/tests/openid_test.install
index 4f1ba3540..6f6e319b9 100644
--- a/modules/openid/tests/openid_test.install
+++ b/modules/openid/tests/openid_test.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the openid_test module.
+ */
+
+/**
  * Implementation of hook_install().
  */
 function openid_test_install() {
diff --git a/modules/php/php.install b/modules/php/php.install
index e758391b6..16f67db82 100644
--- a/modules/php/php.install
+++ b/modules/php/php.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the php module.
+ */
+
+/**
  * Implementation of hook_install().
  */
 function php_install() {
diff --git a/modules/poll/poll.install b/modules/poll/poll.install
index c64683e98..99d8954fc 100644
--- a/modules/poll/poll.install
+++ b/modules/poll/poll.install
@@ -3,7 +3,7 @@
 
 /**
  * @file
- * Install file for poll module.
+ * Install, update and uninstall functions for the poll module.
  */
 
 /**
diff --git a/modules/profile/profile.install b/modules/profile/profile.install
index a4c1fd24f..3cfcf3733 100644
--- a/modules/profile/profile.install
+++ b/modules/profile/profile.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the profile module.
+ */
+
+/**
  * Implementation of hook_install().
  */
 function profile_install() {
diff --git a/modules/search/search.install b/modules/search/search.install
index c0dbee74c..5333d8166 100644
--- a/modules/search/search.install
+++ b/modules/search/search.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the search module.
+ */
+
+/**
  * Implementation of hook_install().
  */
 function search_install() {
diff --git a/modules/simpletest/simpletest.install b/modules/simpletest/simpletest.install
index b61416093..2cfc41a77 100644
--- a/modules/simpletest/simpletest.install
+++ b/modules/simpletest/simpletest.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the simpletest module.
+ */
+
+/**
  * Implementation of hook_install().
  */
 function simpletest_install() {
diff --git a/modules/simpletest/tests/database_test.install b/modules/simpletest/tests/database_test.install
index 0a51d57fd..30dd238c0 100644
--- a/modules/simpletest/tests/database_test.install
+++ b/modules/simpletest/tests/database_test.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the database_test module.
+ */
+
+/**
  * Implementation of hook_schema().
  *
  * The database tests use the database API which depends on schema
diff --git a/modules/simpletest/tests/field_test.install b/modules/simpletest/tests/field_test.install
index d64886b5d..7faa5ee56 100644
--- a/modules/simpletest/tests/field_test.install
+++ b/modules/simpletest/tests/field_test.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the field_test module.
+ */
+
+/**
  * Implementation of hook_schema().
  */
 function field_test_schema() {
diff --git a/modules/simpletest/tests/taxonomy_test.install b/modules/simpletest/tests/taxonomy_test.install
index 0369763d6..131a6b459 100644
--- a/modules/simpletest/tests/taxonomy_test.install
+++ b/modules/simpletest/tests/taxonomy_test.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the taxonomy_test module.
+ */
+
+/**
  * Implementation of hook_schema().
  */
 function taxonomy_test_schema() {
diff --git a/modules/statistics/statistics.install b/modules/statistics/statistics.install
index 4b3141d80..6106751b8 100644
--- a/modules/statistics/statistics.install
+++ b/modules/statistics/statistics.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the statistics module.
+ */
+
+/**
  * Implementation of hook_install().
  */
 function statistics_install() {
diff --git a/modules/system/system.install b/modules/system/system.install
index dad1775f5..260bbcde6 100644
--- a/modules/system/system.install
+++ b/modules/system/system.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the system module.
+ */
+
+/**
  * Test and report Drupal installation requirements.
  *
  * @param $phase
diff --git a/modules/taxonomy/taxonomy.install b/modules/taxonomy/taxonomy.install
index caa0e2c15..4e8a0907e 100644
--- a/modules/taxonomy/taxonomy.install
+++ b/modules/taxonomy/taxonomy.install
@@ -1,6 +1,11 @@
 <?php
 // $Id$
 
+/**
+ * @file
+ * Install, update and uninstall functions for the taxonomy module.
+ */
+
  /**
  * Implementation of hook_install().
  */
diff --git a/modules/trigger/trigger.install b/modules/trigger/trigger.install
index db360507d..d95dfe623 100644
--- a/modules/trigger/trigger.install
+++ b/modules/trigger/trigger.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the trigger module.
+ */
+
+/**
  * Implementation of hook_install().
  */
 function trigger_install() {
diff --git a/modules/update/update.install b/modules/update/update.install
index 95208ccb7..1833f5dec 100644
--- a/modules/update/update.install
+++ b/modules/update/update.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the update module.
+ */
+
+/**
  * Implementation of hook_install().
  */
 function update_install() {
diff --git a/modules/upload/upload.install b/modules/upload/upload.install
index 22334d7d6..6a7765714 100644
--- a/modules/upload/upload.install
+++ b/modules/upload/upload.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the upload module.
+ */
+
+/**
  * Implementation of hook_install().
  */
 function upload_install() {
diff --git a/modules/user/user.install b/modules/user/user.install
index b8d6d9cb7..5e871f9e3 100644
--- a/modules/user/user.install
+++ b/modules/user/user.install
@@ -2,6 +2,11 @@
 // $Id$
 
 /**
+ * @file
+ * Install, update and uninstall functions for the user module.
+ */
+
+/**
  * Implementation of hook_schema().
  */
 function user_schema() {