O pacote-info.java é um arquivo Java que pode ser adicionado a qualquer pacote de origem Java. É usado para fornecer informações em um nível de "pacote" de acordo com seu nome. Ele contém documentação e anotações usadas no pacote.
O exemplo do javadoc já é fornecido na resposta, a parte abaixo explica como funciona no caso de anotações.
Por exemplo, no arquivo abaixo, ele é usado para "substituir" a ocorrência de joda.time.DateTime por org.jadira.usertype.dateandtime.joda.PersistentDateTime
@TypeDefs({
@TypeDef(name = "PersistentDateTime", typeClass = PersistentDateTime.class, defaultForType=DateTime.class)})
package xyz.abc;
import org.hibernate.annotations.TypeDef;
import org.hibernate.annotations.TypeDefs;
import org.jadira.usertype.dateandtime.joda.PersistentDateTime;
import org.joda.time.DateTime;
Existem várias anotações disponíveis com as quais podem ser usadas para realizar coisas diferentes no nível de "pacote". Ele pode ser encontrado em https://docs.jboss.org/hibernate/orm/3.5/api/org/hibernate/annotations/package-summary.html