Thread overview | |||||
---|---|---|---|---|---|
|
July 26, 2007 Package-level DDoc? | ||||
---|---|---|---|---|
| ||||
As I write some package-level Javadoc, a thought just came to my mind: is there any way to create a package summary using DDoc (DMD or Candydoc)? Also, what's up with the "package" keyword? Does it just not work or is it doing some scary behavior modification stuff? |
July 27, 2007 Re: Package-level DDoc? | ||||
---|---|---|---|---|
| ||||
Posted in reply to Robert Fraser | Robert Fraser wrote: > As I write some package-level Javadoc, a thought just came to my mind: is there any way to create a package summary using DDoc (DMD or Candydoc)? Not AFAIK. > Also, what's up with the "package" keyword? Does it just not work or is it doing some scary behavior modification stuff? "package" is a protection attribute like "private", "public" and "protected". It makes something accessible to other modules in the same package, but not outside of that. If you have something declared "package" in the module, say, a.b, then it's accessible from a.a and a.c, but not from d, e.f or a.g.h -- Daniel |
July 27, 2007 Re: Package-level DDoc? | ||||
---|---|---|---|---|
| ||||
Posted in reply to Robert Fraser | "Robert Fraser" <fraserofthenight@gmail.com> wrote in message news:f8b5p0$1pfc$1@digitalmars.com... > Also, what's up with the "package" keyword? Does it just not work or is it doing some scary behavior modification stuff? Despite Daniel's explanation, your intuition is correct about package not working correctly. There are some bugs (143, 257) which have been sitting in the bugzilla for over a year with no resolution regarding the functionality of the package attribute. Furthermore, package makes any member functions it's applied to non-virtual -- which isn't documented and makes no sense. The interaction of package with other attributes is also undefined. *sigh* if only things like this got more attention than constness. |
Copyright © 1999-2021 by the D Language Foundation