src/share/classes/javax/lang/model/element/package-info.java

changeset 778
23fc45d3a572
parent 554
9d9f26857129
child 1484
7612fe48be90
equal deleted inserted replaced
777:acb02e1d5119 778:23fc45d3a572
1 /* 1 /*
2 * Copyright (c) 2005, 2006, Oracle and/or its affiliates. All rights reserved. 2 * Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 * 4 *
5 * This code is free software; you can redistribute it and/or modify it 5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as 6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation. Oracle designates this 7 * published by the Free Software Foundation. Oracle designates this
64 * artifacts outside of this model. 64 * artifacts outside of this model.
65 * 65 *
66 * <p>During annotation processing, operating on incomplete or 66 * <p>During annotation processing, operating on incomplete or
67 * erroneous programs is necessary; however, there are fewer 67 * erroneous programs is necessary; however, there are fewer
68 * guarantees about the nature of the resulting model. If the source 68 * guarantees about the nature of the resulting model. If the source
69 * code is not syntactically well-formed, a model may or may not be 69 * code is not syntactically well-formed or has some other
70 * provided as a quality of implementation issue. If a program is 70 * irrecoverable error that could not be removed by the generation of
71 * syntactically valid but erroneous in some other fashion, the 71 * new types, a model may or may not be provided as a quality of
72 * returned model must have no less information than if all the method 72 * implementation issue.
73 * bodies in the program were replaced by {@code "throw new 73 * If a program is syntactically valid but erroneous in some other
74 * RuntimeException();"}. If a program refers to a missing type XYZ, 74 * fashion, any returned model must have no less information than if
75 * all the method bodies in the program were replaced by {@code "throw
76 * new RuntimeException();"}. If a program refers to a missing type XYZ,
75 * the returned model must contain no less information than if the 77 * the returned model must contain no less information than if the
76 * declaration of type XYZ were assumed to be {@code "class XYZ {}"}, 78 * declaration of type XYZ were assumed to be {@code "class XYZ {}"},
77 * {@code "interface XYZ {}"}, {@code "enum XYZ {}"}, or {@code 79 * {@code "interface XYZ {}"}, {@code "enum XYZ {}"}, or {@code
78 * "@interface XYZ {}"}. If a program refers to a missing type {@code 80 * "@interface XYZ {}"}. If a program refers to a missing type {@code
79 * XYZ<K1, ... ,Kn>}, the returned model must contain no less 81 * XYZ<K1, ... ,Kn>}, the returned model must contain no less

mercurial