In eclipse

Since package-info.java isn't a valid identifier for a class it cannot be created as a class in Eclipse.

I found that when you create a new package there is a check box to check if you want a package-info.java.

To create a package-info.java file in an existing package:

1. Right-click on the package where you want a package-info.java.
2. Select New->Package.
3. Check the Create package-info.java check box.
4. Click on Finish.

Summary from the article here

In package-info.java:

@PackageLevelAnnotationpackage blammy; // package with a package level annotation.import blammy.annotation.PackageLevelAnnotation;

In PackageLevelAnnotation.java

package blammy.annotation;@Retention(RetentionPolicy.CLASS)@Target(ElementType.PACKAGE)public @interface PackageLevelAnnotation{  // stuff as required.}

Edit: more package level info.Here is a link to the package chapter in the Java Language Spec: packages

package-info.java

The package-info.java is a Java file that can be added to any Java source package. Its purpose is to provide a home for package level documentation and package level annotations.

Simply create the package-info.java file. Add the package declaration in the file. In fact, the only thing the package-info.java file must contain is the package declaration.

Example of a minimal package info file:

package com.example.myapp.backend.data;

Example of a package-level annotation, @ParametersAreNonnullByDefault:

@ParametersAreNonnullByDefaultpackage com.example.myapp.backend.data;import javax.annotation.ParametersAreNonnullByDefault;

For more info, see the Java specifications, in The Java® Language Specification, section 7.4.1 Named Packages.