Standardize @file comments in .test files

The .test files in general are not well documented -- many of the classes and methods in them do not conform to standards.

I have reviewed core modules Aggregator through Forum and have attached a Patch that adds the missing @file comments to .test files.

You need to set issues to "needs review" when you attach a patch. That alerts people there's a patch to review, and launches the test bot too.

Review of this patch: it's not standardized -- you've used different wording for the @file comments. At least pick one. It's also best if you refer to a module as "whatever.module" as api.drupal.org will make that into a link.

Thanks for your feedback jhodgdon.

I remade the patch that adds/standardizes the missing @file comments to .test files for all core modules Aggregator through User, using the standard @file comment structure:

/**
 * @file
 * Tests for some.module.
 */ 

Changing the version to 7.x so the test bot will fire.

The patch looks fine to me, except that the chunk headers are:

diff --git a/modules/update/update.test b/modules/update/update.test
index 6cb4491..af0d873 100644
--- a/modules/update/update.test
+++ b/modules/update/update.test

I don't think the testbot is going to be able to apply the patch with the a/ and b/ prefix on the paths. Normally those a/ and b/ should be removed.

Re-applying patch with a/ and b/ prefixes removed from chunk header paths.

Looks good, thanks!

The next step to fix up the .test files, if you are interested in continuing this work (on a separate issue probably), would be to make sure all the test classes and methods have a docblock header that meets our standards.

Always good to be consistent. Committed to CVS HEAD.