gov.sandia.cognition.annotation
Annotation Type PublicationReference


@CodeReview(reviewer="Kevin R. Dixon",
            date="2008-02-08",
            changesNeeded=false,
            comments="Interface looks fine.")
@Retention(value=RUNTIME)
@Documented
public @interface PublicationReference

The PublicationReference annotation describes a reference to a publication from a journal, conference, etc. The purpose of this annotation is to provide a reference to a publication so that someone would be able to find it on the Internet using a search engine; not to automatically produce a full bibliography that contains all the data that publishers require.

Since:
2.1
Author:
Kevin R. Dixon, Justin Basilico

Required Element Summary
 String[] author
          The full names of the author(s) of the publication.
 String title
          The title of the publication.
 PublicationType type
          The type of the publication.
 int year
          The year of publication.
 
Optional Element Summary
 String[] notes
          Optional notes regarding this reference.
 int[] pages
          The pages on which the publication can be found.
 String publication
          The title of the larger publication where the article was published.
 String url
          An optional URL reference where the publication can be found.
 

Element Detail

author

public abstract String[] author
The full names of the author(s) of the publication. For example, { "Kevin R. Dixon", "Justin D. Basilico" }.

Returns:
The full names of the author(s).

title

public abstract String title
The title of the publication. For example, "Cognitive Foundry: How did it become perfect?".

Returns:
The title of the publication.

type

public abstract PublicationType type
The type of the publication. For example, Journal, Conference, Book.

Returns:
The type of the publication.
See Also:
PublicationType

year

public abstract int year
The year of publication.

Returns:
The year of publication.

publication

public abstract String publication
The title of the larger publication where the article was published. For example, "Learning Kernel Classifiers" or "Proceedings of the Twenty-First International Conference on Machine Learning (ICML)".

Returns:
The title of the larger publication where the article was published.
Default:
""

pages

public abstract int[] pages
The pages on which the publication can be found. For example, {10, 100}.

Returns:
The range of pages on which the publication can be found.
Default:
0

url

public abstract String url
An optional URL reference where the publication can be found. Defaults to "".

Returns:
A URL where the reference can be found.
Default:
""

notes

public abstract String[] notes
Optional notes regarding this reference.

Returns:
Optional notes regarding this reference.
Default:
""