Javadoc question about top-level specification

Quoting
http://java.sun.com/j2se/javadoc/writingapispecs/index.html#top-level
Top-Level Specification
The top-level specification is composed of those specifications that apply to the entire set of packages. It can include assumptions that underlie the other specifications, such as all objects are presumed to be thread-safe unless otherwise specified.
In addition to the class specific requirements, there are overall Java platform API documentation requirements with respect to handling unchecked exceptions (exceptions that derive from java.lang.RuntimeException). It would be helpful to develop some blanket statements that describe the general situations when a Java application should be prepared to encounter one or more RuntimeExceptions.
My question is how do you get an HTML file included in the Javadocs so they show at the top level where the packages are listed?
Thanks
Bill

Yes, that would seem to be apply, but I had some questions.
1. This seems to suggest that overview.html will be added to the package-summary generated for each class. That is not what I want.
2. I could not make it work. Here is the command I am using to build the javadocs.
javadoc -d docs -author -overview overview.html -doctitle "CkEntry / CkViewer Application and APIs" -sourcepath d:\workspace\ckviewer\src cprs.as400 cprs.ckentry cprs.ckviewer cprs.pc5250 cprs.roi cprs.util neva vistech.imageviewer vistech.jai.render vistech.util 1>jdocs_out1.txt 2>jdocs_out2.txtjavadoc has a problem with overview.html. This is the single line in jdocs_out2.txt:
javadoc: Error while reading file overview.htmlNot very informative. Overview.html is in the folder identified by -sourcepath
Thanks for looking at this. I appreciate the help.

Similar Messages

EP About top level navigation

We are designing that many roles are assigned to one user.
(about 7-8 roles per user)
When many roles are assigned to the user, tabs in top level navigation bar can not be displayed without scroll horizontally.
We want to display all roles at once, without scroll.
To realize the above, roles must be displayed on 2 records
in the one top level navigation bar.
Is ther someone who knows whether top level navigation can
be displayed at 2 records on a bar, or not.
Any help or information would be appreciated.
Thank you.
Mizuka Aoyama
SAP Japan Netweaver Consulting.

Mizuka,
first, you might want to reorganize your roles and possibly have a look at the "merging" feature.
Next, you might change the portals theme to use a smaller font for the top level tabs.
If both options are unsuitable, you can develop your own top level navigation component by writing some java code. Then you can make it look whatever you like to (and I mean it, it's extremely flexible, I did it early in the time of EP6 SP 0 ramp-up, but definitely takes some time).
Regards,
Dominik

Question about the JDO specification

Hey,
I'm testing Kodo transactional behavior and it occurs to me that I'm not
sure what the correct behavior should be... Does anyone know the answer to
the following questions:
1.
get a PersistenceManager
start a transaction
call getObjectById to get an object Foo
now... JDOHelper.isTransactional ( Foo ) will return... ( true or
false? )
2. do steps in part 1.
call pm.makeTransactional ( Foo )
get another object, Bar, by calling Foo.getBar ()
now... JDOHelper.isTransactional ( Bar ) will return... ( true or
false? )
The spec seems to say that it depends on whether you are using
optimistic transactions or not (argh). Sorry if I am repeating already
asked
questions, I can't seem to find an earlier post about this. Thanks for the
help.
-Eric

Hi Eric,
Yup, if the transaction is Optimistic, then the objects fetched by object ID or by a query are
not made transactional (but they may already be transactional due to prior work within the
transaction). If the object is changed, then it is made transactional. If the object is passed to
makeTransactional() then it becomes transactional. If the transaction started is not Optimistic,
then every object reached that is persistent becomes transactional. This may cause a refresh from
the datastore. Unmanaged objects (JDO transient) are not subject to these rules, but they also are
not returned from fetches or queries either.
David
Eric Lindauer wrote:
>
Hey,
I'm testing Kodo transactional behavior and it occurs to me that I'm not
sure what the correct behavior should be... Does anyone know the answer to
the following questions:
1.
get a PersistenceManager
start a transaction
call getObjectById to get an object Foo
now... JDOHelper.isTransactional ( Foo ) will return... ( true or
false? )
2. do steps in part 1.
call pm.makeTransactional ( Foo )
get another object, Bar, by calling Foo.getBar ()
now... JDOHelper.isTransactional ( Bar ) will return... ( true or
false? )
The spec seems to say that it depends on whether you are using
optimistic transactions or not (argh). Sorry if I am repeating already
asked
questions, I can't seem to find an earlier post about this. Thanks for the
help.
-Eric

A question about search level

In the parameter :"DEADLOCK_DETECTION".
It's explain include a substantive it's named :"search depth".
I can't find the explain about "search depth". Please help me.
thanks

Hi,
the search depth specifies how far the deadlock detection should search for the reason of the deadlock. A higher value would search deeper for the reason, but would also increase the time needed to search (and find).
We normally recommend <b>against</b> changing the default value of this parameter. Normally also share locks are used, where we can't really specify all tasks that hold sharelocks (as opposed to deadlocks consisting only of tasks holding only exclusive locks), but only the number of tasks in total. If the deadlock isn't found, the Request_Timeout comes into effect.
Does that help you understand this parameter?

Question about top case

Hi there,
I'd like to know if the "top case/keyboard" part also includes the trackpad?
I'm asking because I just had the top case replaced (was interfering with the fan that produced a clicking sound) and it looks like they replaced it with a used one?! For example, the bottom left corner shows a 1.5 inch square, lighter gray patch (as if there was a sticker there?), and the middle of the trackpad button is very shiny compared to the sides, like it's been used...
Thanks for any input!
whitebook 2.0Ghz - 4H622 Mac OS X (10.4.7) 2GB RAM

The top case includes the trackpad and trackpad button.
This is at the moment a bit of a sore subject with me. After my MacBook was returned from being repaired for the random shutdown problem, the trackpad button does not respond at all to clicks in the lower right corner. (The repair consisted of replacing the top case and heat sink.) So half the time when I click the button, it doesn't work, because the right end is where I click most often.
Yesterday I talked to AppleCare phone support, and the Product Specialist suggested I talk to a store Genius, that maybe it could be fixed or else the turnaround for a new top case would be faster than shipping.
I did that this morning, and the Genius claimed that the behavior was within specs, that it would not bother his typing since you're supposed to click in the middle of the button, that it was equivalent to complaining about a couple of dead pixels.
I haven't had a return call yet from the Product Specialist, and I'm currently planning on trying a different Apple store tomorrow.
I see "mushy trackpad button" is one of the common complaints on web forums:
http://www.mymac.com/showarticle.php?do=something&id=1572

Question about VOLUME LEVELS for BURNING...

when i download music from the itunes store, the volume levels sound fine when i play them from itunes or the ipod. but when i burn the albums to CD, the volume is significantly LOWER than other audio CD's. the same is true when i burn them in mp3 format. does anyone know how to adjust the sound levels (turn them up) when i burn the albums, or is this a common problem with music downloaded through itunes? i don't encounter this when i copy directly from an audio CD and burn to another. someone HAS to know something about this. it's really frustrating. help me out, friends.
Dell E1505 Windows XP

With all due respect, I have burned alot of CDs with soundcheck checked and the recipients of my 'mixes' all complained. I noticed it as well. Perhaps there is another place where user checks soundcheck...?
I know soundcheck can make playing disparate tracks in itunes level, but that does me no good for burning.
Thanks for the reply.
PS: here are reviews I read re: ivolume. I have no idea whether or not they reflect the views of others, but they do exist (source: http://www.macupdate.com/reviews.php?id=12687&pid=142223). I hesitated considering ivolume because some of the problems seem to be linked with itunes 7, which I use.
Original Review:
Type: Review
Author: adfasdfasdfasdf
Overall:
Features:
Ease of Use:
Value:
Stability: It still can't process iTMS files.
So, what is it good for, if you have music you encoded yourself, and music you bought? Try to listen to such a playlist: your ears will fall off...
It's a good idea, but without m4p support: forget it. (2/15/2006, Version: 2.0.2)
[ Write Reply ]
and another:
Type: Review
Author: gryphonent
Overall:
Features:
Ease of Use:
Value:
Stability: I purchased this almost a year ago. Had great expectations, and initially the sound level seemed indeed more consistent on my iPod. However, with iTunes 7 this changed. I also found some bugs in the app that were never fixed. The developer is non-responsive and hasn't delivered an update for a while now. I for one have deleted the app from my system and can only warn people not to waste their money on iVolume. (1/13/2007, Version: 2.0.2)
[ Write Reply ]

Question about "top-down" web services development

I tried to follow the Oracle "RPC literal top-down web services how-to" to develop a web service with a top-down approach but I have error when I try to compile with Ant the provided example.
This howto is located at: http://www.oracle.com/technology/sample_code/tech/java/codesnippet/webservices/rpc-lit/index.html
The error I have is:
D:\Franck\WebServices\prototype\projectAS10g\exemple\rpc-lit>ant
Buildfile: build.xml
env-check:
check-oracle-home:
check-j2ee-home:
init:
sub-init:
gen-service:
[echo] Generating service artifacts
env-check:
check-oracle-home:
check-j2ee-home:
init:
wsa:
[java] java.util.zip.ZipException: The system cannot find the file specified
[java] at java.util.zip.ZipFile.open(Native Method)
[java] at java.util.zip.ZipFile.<init>(ZipFile.java:112)
[java] at java.util.jar.JarFile.<init>(JarFile.java:127)
[java] at java.util.jar.JarFile.<init>(JarFile.java:65)
[java] Exception in thread "main"
BUILD FAILED
D:\Franck\WebServices\prototype\projectAS10g\exemple\rpc-lit\build.xml:21: The following error occurred while executing this line:
D:\Franck\WebServices\prototype\projectAS10g\exemple\rpc-lit\config\common.xml:63: Java returned: 1
Total time: 1 second
When I look at the common.xml file which is used by the build.xml one I have a class like:
<pathelement location="${ws.lib.dir}/orasaaj.jar"/>
The problem is that I do not have this jar file on my disk and I can't find it on the net. Maybe it is one of the root cause of my build failed.
Does anyone experience this howto successfully and if someone can tell me where to find this jar file it would be great.
Thanks

I tried to follow the Oracle "RPC literal top-down web services how-to" to develop a web service with a top-down approach but I have error when I try to compile with Ant the provided example.
This howto is located at: http://www.oracle.com/technology/sample_code/tech/java/codesnippet/webservices/rpc-lit/index.html
The error I have is:
D:\Franck\WebServices\prototype\projectAS10g\exemple\rpc-lit>ant
Buildfile: build.xml
env-check:
check-oracle-home:
check-j2ee-home:
init:
sub-init:
gen-service:
[echo] Generating service artifacts
env-check:
check-oracle-home:
check-j2ee-home:
init:
wsa:
[java] java.util.zip.ZipException: The system cannot find the file specified
[java] at java.util.zip.ZipFile.open(Native Method)
[java] at java.util.zip.ZipFile.<init>(ZipFile.java:112)
[java] at java.util.jar.JarFile.<init>(JarFile.java:127)
[java] at java.util.jar.JarFile.<init>(JarFile.java:65)
[java] Exception in thread "main"
BUILD FAILED
D:\Franck\WebServices\prototype\projectAS10g\exemple\rpc-lit\build.xml:21: The following error occurred while executing this line:
D:\Franck\WebServices\prototype\projectAS10g\exemple\rpc-lit\config\common.xml:63: Java returned: 1
Total time: 1 second
When I look at the common.xml file which is used by the build.xml one I have a class like:
<pathelement location="${ws.lib.dir}/orasaaj.jar"/>
The problem is that I do not have this jar file on my disk and I can't find it on the net. Maybe it is one of the root cause of my build failed.
Does anyone experience this howto successfully and if someone can tell me where to find this jar file it would be great.
Thanks

Basic question about a level 2 switch when adding an IPv4 Address

Wow, you are all awesome!!!

I am studying for the Network Plus exam and I have a lab that is showing me how to run simple commands on a switch. In the lab, it has me go to the switch, enter enable mode, then configure the switch. It then has me enter an IP address and Subnet. What I would like to know is what is the IP address configured for? Is that the PC's IP address and Subnet? Sorry if the question is remedial, but I really would like to know what the switches IP and Subnet correspond to.
This topic first appeared in the Spiceworks Community

Question about volume level automation (GB newbie here)

I know how volume level automation works for the master track, i.e. in and out and such, but can you do this with a single track? basically one of the tracks in a song I've recorded has a bit of hiss at the end of it, which I would like to fade out. I've tried to cut that bit out completely, but it ruins the feel of that particular track, so I was wondering if there was a way to make that track fade out.

on the right end of the row of buttons just under the track name, there is a triangle. click it and the automation of the track will become visible. you can automate volume and pan using points on the line that runs throgh the timeline.
before you start playing with complex curves, make sure you've got the level of the loudest part set to where you want it using the slider - otherwise, you'll have to adjust each point on the automation curve to adjust overall volume... that's troublesome (if someone has a work around/key command i'd love to hear it!).

Question about Top button being stuck

My power button stopped working on my iphone 4s. I turned on the soft key function so i could lock my screen. I made the mistake of turning off my phone, now I cannot figure out how to turn it back on without that top button working. Help!

Plug your phone into a power source, & it should come on.

Question about setting track level

Hi I finally got my new macbook pro and moto 8 pre and have just today tried a bit of recording just to get used to it. I am at the moment using garage band. I have a question about track levels. In Garage Band when I select a track to record there is a slider for input level or an option of clicking the automatic level control. But for some reason they are both just that color of grey you get when something can not be selected on a computer. How do I activate this? It's strange as I did actually manage to record the track, I just can't seem to really adjust the level. I thought maybe it has to do with the motu and I can only select the track level there, and that garage band level setting are (rightfully) disabled? Maybe that's what I should be doing, but just a bit confused. Anyway, thanks in advance for whoever takes the time to help out a newbie.

Ah, ok. Good to know. Thanks for the info.

Top level class ?

hi,
i am preparing the sun certified java progammer, there's some questions involving "top level class", i don't understand what is a top level class ? can anyone give me some information about it ? is it a class at the top of a package hierarchie like class Object ????
thanks for your help

hi,
i am preparing the sun certified java progammer,
there's some questions involving "top level class", i
don't understand what is a top level class ? can
anyone give me some information about it ? is it a
class at the top of a package hierarchie like class
Object ????No. See
http://java.sun.com/docs/books/jls/second_edition/html/packages.doc.html#26783
Jim S.

How do I find my earlier questions about PSE organiser?

I have asked a couple of questions about Pse13 ,one specifically deleting duplicates from organiser. If no one answers the question and I do not receive an email, what can I do but keep asking? I paid good money for this new version but there is no chat support and they just refer you to the forums. If no one answers the question then I might as well go back to Pacasa.
Any comments from Adobe?
Col.

Hi,
This is a user to user forum so we are just users like yourself - Adobe staff do sometimes visit and add comments.
To se your own questions, log in to the forum and click on the down arrow next to your avatar on the top row. From the drop down, select Activities and Inbox and that should bring up a list of the questions you asked.
It can be worthwhile bookmarking the page so that you can quickly go to it later.
Hope that helps.
Brian

Question on field level help and bookmarking

Hi All
I have a question about field level help and bookmarking fields. I did this before but i can't remember how. Right now, when you click on a field in my help to access our software application the page displays but at the top and not at the exact field description. I don't remember how I did this in my other help files.
Please help me so I can bookmark my field level help to go exactly to my definition on the page and not just the top of the page everytime.
Thanks
Caryn

Hi Martin!
Take a look at these sites which will provide you more information about your problem.
[http://apex-at-work.blogspot.com/2008/10/apex-select-list-with-dynamic-help-text.html|http://apex-at-work.blogspot.com/2008/10/apex-select-list-with-dynamic-help-text.html]
TRICK: Dynamic Item Help Text as Tooltip
[http://apex.oracle.com/pls/otn/f?p=11933:121|http://apex.oracle.com/pls/otn/f?p=11933:121]
Regards,
Tobias
[http://apex-at-work.blogspot.com/]

Noob question about launching apps

Greetings all,
Just made the switch to a Powerbook with OS X Tiger, and have a question about launching applications; specifically how to do so without using the mouse. On my Linux boxes (one at home, one at work), I do most of my work from the keyboard, without resorting to the mouse, even in Gnome or KDE.
In Tiger, I can select applications on the desktop, but haven't been able to figure out how to launch them without "clicking"... I've Googled and searched these forums, but no luck so far. Under Linux, it's the Enter key. I assume in Tiger it's some key combination...
I know there's probably a simple answer, but I've not been able to happen upon the appropriate key combo it at random, so I thought I'd ask the experts.
Be gentle, I've only had my PB a week!

To help you in your quest to keep your hands on the keyboard you should check out apps like LaunchBar and Quick Silver. Your hands will never (well... rarely) leave the keyboard again.

Javadoc question about top-level specification

Similar Messages

Maybe you are looking for