g**********y
发帖数: 14569 | 1 1. It doesn't matter where you create the program and where you run javadoc,
result should be the same. BTW, if you create program under JBuilder, you may
miss some .jar/.zip files to run/compile/javadoc it on UNIX.
There is no difference between folling if there is only MyProgram.java in
that directory --
javadoc MyProgram.java
javadoc *.java
some interesting option --
-d: specify document path (where you want to store generated html)
-private: will include private metho |
|
c*****t
发帖数: 1879 | 2 The thing is, from my understanding of JavaDoc API, essentially I have
to do it in two step process:
1. write a Doclet that extract the information from the Java code and
output information to a disk file.
2. execute JavaDoc with the Doclet. Then load the information from the
disk file.
I am wondering if I could execute JavaDoc within the same JVM, possibly
multiple times so that I could directly manipulate RootDoc structure
rather than pass data through a disk file. |
|
c*****t
发帖数: 1879 | 3 nvm, I got it solved. The question was basically related to
Running the Standard Doclet Programmatically
http://java.sun.com/j2se/1.4.2/docs/tooldocs/javadoc/standard-doclet.html#runningprogrammatically
which solved my problems. I can now get all the information within
the same JVM. Call JavaDoc multiple times as well... and suppress
warnings/errors.
What's so cool is that now I can write my own doclet for custom XML
parsers created using CookXml. The doclet generates a JavaDoc like
web page |
|
y**w
发帖数: 8 | 4 I tried to run the following:
javadoc test.java
i can only get :
AllNames.html
packages.html
test.html
tree.html
i think i should also get a file as index.html, right? how come i didn't get
it? ( i program my java file in jBuilder and run "javadoc" on unix.
and also i want post my java file on my webpage, i use a link to that java
file, then on my webpage, the file showed up without '\n', it looks like:
'1/x' private Button b0 = new Button("0"); private Button b1 = new
Button("1"); private Butt |
|
m******t
发帖数: 2416 | 5
[snip]
come to think of it, I have never run javadoc against one single
file, but I'm guessing that's what caused your problem. try
javadoc *.java. |
|
b*******a
发帖数: 26 | 6 在别人的机器上用Eclipse，键入System.out.，提示methods，
然后选中print以后，会有相应的Javadoc信息。然后自己装了
一个Eclipse 3.0.1，却只有signature，没有Javadoc信息，
请问这个问题如何解决？（我猜肯定是配置出了问题）
谢谢！ |
|
m******t
发帖数: 2416 | 7
Try this: go to Windows->Preferences->Java->Installed JREs,
select the JRE you want to use, click on Edit, then specify
your javadoc location in "Javadoc URL". |
|
b*******a
发帖数: 26 | 8 Thank you, my question must've been confusing ...
I was asking how to configure for javadoc hover.
Finally I got the answer by googling:
Instead of put a JRE into the "Installed JREs", put a
Java sdk with src.zip instead, and then the javadoc hover
would work.
Thank you anyway. |
|
c******f
发帖数: 243 | 9 public api都写,因为写的framework别人要用到
而且查javadoc方便 |
|
c*****t
发帖数: 1879 | 10 I am writing a program which needs to extract JavaDoc comments from
given source files. The thing is, I need to do it dynamically, like
showing the comment as a tooltip etc.
I know Eclipse/IntelliJ IDEA have the feature, I am wondering how
they did it, since I need to do the same for my program. I certainly
do not wish to write my own Java parser.
Any pointers? Thanks. |
|
m******t
发帖数: 2416 | 11 I have never actually done this, but I imagine you can probably call the
javadoc API at run-time and plugin your own doclet to capture the tag
information. |
|
g*****g
发帖数: 34805 | 12 I don't know much about JavaDoc API, but I believe it will allow
you to output to some OutputStream rather than files. |
|
c*****t
发帖数: 1879 | 13 I need to know if it is possible to execute javadoc within the
same JVM multiple times, and how to launch it within JVM without
calling Runtime.exec... |
|
t**r
发帖数: 3428 | 14 【 以下文字转载自 JobHunting 讨论区 】
发信人: taar (taar), 信区: JobHunting
标 题: 问一下在flg的，你们写java代码 要求写这陀注釋 javadoc什么的么？
发信站: BBS 未名空间站 (Sun Jun 28 14:32:34 2015, 美东)
/**
* {@link LogEntry} storage service.
*
* Stores a sequence of {@code LogEntry} instances
* indexed by a {@code long >= 0} referred to as a "log index".
* Any two consecutive {@code LogEntry} instances satisfy
* the log property LP: {@code logIndex(LogEntry0) + 1 = logIndex(LogEntry1)
}.
* Implementations need only guarantee that each
* 阅读全帖 |
|
f*****g
发帖数: 31 | 15
。
容
同
。
要
吗
具
。
Task is not a part of "Javadoc" though you can add your own "task" to
your Javadoc. You can also add xdoclet annotations to your javadoc, but
obviously xdoclet is not a part of "Javadoc" as well.
Also, there is not a standard of "Task". Eclipse has its own Task(s).
Actually it supports 2 types of "Task"s: Java comment "TODO" and
Eclipse project Task.
"TODO" can be put into Javadoc, but not necessary. You can add your "TODO"
annotation in normay comment:
//TODO: remove this todo |
|
z****e
发帖数: 54598 | 16 这个例子不是特别好，严格说来，不应该看源代码学习的
这个严重违背软件工程最基本的规范
最早都认为应该看文档，然后搞出了一堆规范，一堆阿三往里面灌水
后来发现，coding monkeys都不愿意写文档，这些规范几乎没用
目前最有效的文档是javadoc，至少我能看javadoc就看javadoc
除非万不得已，不看源代码，而且要搜索源代码，一般通过ide完成 |
|
f********h
发帖数: 149 | 17 yes. There is a place you can hook the javadoc into eclipse
and when your mouse is over some function, it will show
the javadoc. I have done that in eclipse 3.1 but forgot where
I did that exactly. Someplace like specifying a javadoc directory
and eclipse will validate it for you. |
|
c*****t
发帖数: 1879 | 18 I mean for such a small project where the hell is the documentation?
Sure there is a link, but it contains practically nothing, not even
a sample code, not even JavaDoc. It's basically saying just read
the damn code.
Rhino, BeanShell, Jython all have plenty of code examples and JavaDoc
that at least get you started. I could get involved in 5 minutes,
but BSF?
Reminds me of Eclipse, which doesn't have online JavaDoc either. Is
it the culture of IBM to have poor documentation?
sigh. |
|
c*****t
发帖数: 1879 | 19 While the idea is good, the implementation can be a serious issue,
since how are you going to test it to make sure things are okay?
Its JavaDoc API is quite useful. For my XML data binding tool, I
use it to extract documentation in JavaDoc comments and tags.
You can see a sample at
http://cookxml.yuanheng.org/tagdoc/
Other creative uses of it's tools API is for your own code generator.
One idea that I was thinking was to use JavaDoc comment, or maybe
the annotations to specify the conditions an |
|
d****i
发帖数: 4809 | 20 好虫有没有觉得JDK 7的javadoc的style不如以前1.0-6.0版本的看上去醒目？新的
javadoc用的是新的CSS，反而降低了对比度，眼镜看着有点累，不如以前的plain的
javadoc那么清晰明爽。不知有没有办法调回来原来的白纸黑字的那种plain style。 |
|
d****i
发帖数: 4809 | 21 javadoc是给程序员看的，不是给爱打扮的小妞看的。你难道不知道1995年Java诞生的
时候，正好是internet商业化的第一年，那时候网页标准的颜色就是白底黑字蓝色链接
，exactly就是javadoc 1-6的样子，所以说保持javadoc原生态式样很重要，Java还是
历史基因上和internet是紧相连的，而且对比度好，眼睛看着不累。 |
|
d****i
发帖数: 4809 | 22 现在很多新的Java项目，在发布javadoc的时候又重新回到JDK6时候的plain javadoc
style了，这样便于customize成不同色彩和边框而又不影响白底黑字醒目的文字颜色，
估计是对JDK7以后javadoc style的彻底否定。 |
|
l**********n
发帖数: 8443 | 23 我已经厌烦了读JavaDoc。你看那个String.replace一堆method，大多大同小异，那个
JavaDoc又臭又长，这种情况我自己放弃用String.replace，直接自己写个算法得了。
当然以后要注意读源码（要赞一下Maven），这是真正有帮助的，读那个javaDoc就是浪
费时间。 |
|
z****e
发帖数: 54598 | 24 其实如何让员工更好滴阅读代码是构架的事
但是未必所有公司的构架都那么合理
有几个我们也许有点办法
1）一定要用上ide，无论什么ide，index，自动补全，快速查找，快速定位等功能非常
重要
还有debug，自动断点etc.，如果连ide都不会用，这说不过去
2）学会看javadoc，并猜出各种方法是做什么的，自己试试就是了
javadoc上都有相应的注释，多阅读
3）opengrok，希望你们已经安装了，这样全局查找代码会容易许多
4）confluence，希望你们已经有了，多看看其他人的解释
5）各种框架的官方文档，比如spring mvc，google一下应该有很多，还有jsf这些 |
|
c*****t
发帖数: 1879 | 25 1. the Override/Implement method option have arguments that just don't
make sense (arg0, arg1, etc), how to make them the same as parent
class or interface arguments?
2. the javadoc imported from Overrride/Implement method is like
/* (non-Javadoc)
* @see java.awt.image.ImageObserver#imageUpdate(java.awt.Image, int, int, int, int, int)
*/
which is merely a pointer. It would be nice to have the original
java doc for the function. how?
3. will Eclipse display hints of fu |
|
c*****t
发帖数: 1879 | 26 I just wanted to download the javadoc. Compiling javadoc can
be very troublesome. |
|
m**c
发帖数: 192 | 27 javadoc.exe in JDK is easier.
他问的是怎么在源文件里面写注释吧 如果写好了生成javadoc当然容易了 |
|
j******o
发帖数: 82 | 28 Is there a way to search a word in the entire javadoc from a browser?
I wish Javadoc has some kind of searching script built-in. |
|
T********i
发帖数: 2416 | 29 http://www.mitbbs.com/article_t1/Programming/31283973_0_1.html
发信人: goodbug (好虫), 信区: Programming
标 题: Re: Goodbug这个人头重脚轻，嘴尖皮厚；不但学问浮夸，而且人品恶
发信站: BBS 未名空间站 (Mon Nov 25 16:02:11 2013, 美东)
就写这么个程序，随便你怎么优化，随便你用啥语言。在你那1万的机器上benchmark大
家看看，别光说不练。
int count = 100000;
for(int i = 0; i < 100000; i++){
int count = readCounter();
count--;
write(counter);
flush();
}
发信人: TeacherWei (TW), 信区: Programming
标 题: Re: Goodbug这个人头重脚轻，嘴尖皮厚；不但学问浮夸，而且人
发信站: BBS 未名空间站 (Mon Nov 25 16:08:41 2013, 美东)
就6行... 阅读全帖 |
|
T********i
发帖数: 2416 | 30 发信人: goodbug (好虫), 信区: Programming
标 题: Re: Goodbug这个人头重脚轻，嘴尖皮厚；不但学问浮夸，而且人品恶
发信站: BBS 未名空间站 (Mon Nov 25 16:02:11 2013, 美东)
就写这么个程序，随便你怎么优化，随便你用啥语言。在你那1万的机器上benchmark大
家看看，别光说不练。
int count = 100000;
for(int i = 0; i < 100000; i++){
int count = readCounter();
count--;
write(counter);
flush();
}
发信人: TeacherWei (TW), 信区: Programming
标 题: Re: Goodbug这个人头重脚轻，嘴尖皮厚；不但学问浮夸，而且人
发信站: BBS 未名空间站 (Mon Nov 25 16:08:41 2013, 美东)
就6行程序你还写错了。不明白fflush和fsync有啥差别是吧？
说呢基本功不扎实还真不是盖的。CS是体育老师教的吧？
发信人: ... 阅读全帖 |
|
T********i
发帖数: 2416 | 31 发信人: goodbug (好虫), 信区: Programming
标 题: Re: Goodbug这个人头重脚轻，嘴尖皮厚；不但学问浮夸，而且人品恶
发信站: BBS 未名空间站 (Mon Nov 25 16:02:11 2013, 美东)
看看GoogBug 6行程序犯了多少错误。
就写这么个程序，随便你怎么优化，随便你用啥语言。在你那1万的机器上benchmark大
家看看，别光说不练。
int count = 100000;
for(int i = 0; i < 100000; i++){
int count = readCounter();
count--;
write(counter);
flush();
}
发信人: TeacherWei (TW), 信区: Programming
标 题: Re: Goodbug这个人头重脚轻，嘴尖皮厚；不但学问浮夸，而且人
发信站: BBS 未名空间站 (Mon Nov 25 16:08:41 2013, 美东)
就6行程序你还写错了。不明白fflush和fsync有啥差别是吧？
说呢基本功不扎实还真... 阅读全帖 |
|
z****e
发帖数: 54598 | 32 你也写过python，没准你知道点东西
比如我拿到一个第三方类库
名字都有可能，比如有个类叫Human
那么我想看看里面有啥方法
在java里面，最简单的就是Human human;
human.
打出.后，ide就会自动罗列所有的方法
我找到我需要的填入就可以了
现在用python我没有办法找出来
因为dynamic type，ide不能帮我定位这是一个什么东西
所以我总会在我需要帮忙的时候卡壳
然后不得不去google或者是看文档
这样效率就下来了，尤其是对于那些不常用的类库
文档很多还不全不说，pydoc经常是没有
我的天，很多人连自动文档都懒得做
java的类库一般都至少有javadoc
我看看javadoc这种一般就能搞定了
有啥办法没有？
今天搞了三个类库，么有一个成功的，最后不得不用excel做图了
-_-!!! |
|
z*******3
发帖数: 13709 | 33 java做后端好处在于ecosystem大
你遇到任何瓶颈，网络上一搜，很容易的，到处都是别人的做法
ejb怎么做，spring怎么做，core java怎么做
文档多得一塌糊涂，而且javadoc是所有语言中最完整得一个
基本上没有java得project会不提供javadoc的
但是其他语言，嘿嘿
现在做后端，主要是一点python，但是实际下放生产
都是apache那些project，完全没有竞争对手
对于apache那些projects来说，比如hadoop
python在生产上还是过于缓慢了
go的话，google自己用，其他人不懂go，没有文档这些，我也没有办法
其实将白了这一块就是google先做
然后apache用java抄，然后其他公司用apache的 |
|
z****e
发帖数: 54598 | 34 java文档也是自动生成的，javadoc很多时候能帮很多忙
比你跑网上去问强多了，java经常可以用eclipse配合盲狙
很准的，很多时候不google，我就用eclipse帮我找方法
一路看下来，看方法名大概就知道是啥意思做啥的了
实在不行，去javadoc上找下这个方法，看看写的人有什么建议或者提示啥的
然后再做两个例子，就搞定啦，效率高很多
如果都是var的话，这种当场查阅的手段很多时候就无效了
因为机器不知道这个var到底是啥
所以我看到var就想杀人 |
|
z****e
发帖数: 54598 | 35
概念必然是先于framework提出的
如果概念都不懂，你指望通过阅读src读懂，这个我看不太可能
顺序明显颠倒了，因为人的自然语言可读性显然要强过src code
正确的学习顺序应该先google
其次javadoc，javadoc里面有大量的例子和原作者的解释
最后才是src code
src code可读性也是java最强，其次才是其他语言 |
|
b***i
发帖数: 3043 | 36 不用多说， 你居然觉得javadoc是header?
C的头文件是给编译器看的，javadoc是给人看的，象参考书一样。现在vs也是这样吧注
释内容现实出来，就是抄java的。
另外， 你又假定java设计者后悔了，其实c++/c的 include是短板，恰恰和你想的相反
，是c始祖设计的不足。java设计比c++晚了好几年，很多高手研究了c++的不足才设计
出java。我一开始也是瞧不起java，知道写了几万行java才发现是我错了。你要是Java
没写到几万行，还是不配评论这两个语言优劣的
还有， eclipse.msvc都做不到你说的自动更改文件名
再说了， c++学好有啥用，浪费时间，不如学java
but
too.
class |
|
b***i
发帖数: 3043 | 37 不用多说， 你居然觉得javadoc是header?
C的头文件是给编译器看的，javadoc是给人看的，象参考书一样。现在vs也是这样吧注
释内容现实出来，就是抄java的。
另外， 你又假定java设计者后悔了，其实c++/c的 include是短板，恰恰和你想的相反
，是c始祖设计的不足。java设计比c++晚了好几年，很多高手研究了c++的不足才设计
出java。我一开始也是瞧不起java，知道写了几万行java才发现是我错了。你要是Java
没写到几万行，还是不配评论这两个语言优劣的
还有， eclipse.msvc都做不到你说的自动更改文件名
再说了， c++学好有啥用，浪费时间，不如学java
but
too.
class |
|
z*******3
发帖数: 13709 | 38 程序员工作从来都不轻松
20w一定要赶紧出活
否则会被踢出去的，天下没有免费的午餐
java后台虽然轮子很多，但是文档很少，很多东西google都google不到
很多时候是靠看javadoc硬猜
一个后来想起来很容易的小bug，耗一个晚上很正常
leetcode算法题做一下对提高还是很有帮助的 |
|
z****e
发帖数: 54598 | 39
经过某种方式，翻译成机器能看懂的方式
这个不重要，总之机器最终能够看懂就行了
计算机语言的目的就是让机器和人能够看懂
至于什么方式，不重要，就像java真的项目中的话
要让人能够看懂，也多少需要ide或者javadoc的帮忙一样
用vi看，看晕过去 |
|
m*******l
发帖数: 12782 | 40 例如下面有关java的
Addison.Wesley.Algorithms.In.Java.3rd.Ed.Part5.Graph.Algorithms.eBook-LiB.ch
m
Addison.Wesley.Applying.Enterprise.JavaBeans.2nd.Edition.eBook-LiB.chm
Addison.Wesley.A.Programmers.Guide.To.Java.Certification.2nd.Edition.chm
Addison.Wesley.A.Programmers.Guide.To.Java.Certification.2nd.Edition.eBook-L
iB.chm
Addison.Wesley.Developing.Enterprise Java Applications with J2EE and UML.pdf
Addison.Wesley.Dot.NET For Java Developers Migrating To C Sharp.chm
Addison.Wesley.Dot.NET.For.Java.Deve... 阅读全帖 |
|
m*******l
发帖数: 12782 | 41 例如下面有关java的
Addison.Wesley.Algorithms.In.Java.3rd.Ed.Part5.Graph.Algorithms.eBook-LiB.ch
m
Addison.Wesley.Applying.Enterprise.JavaBeans.2nd.Edition.eBook-LiB.chm
Addison.Wesley.A.Programmers.Guide.To.Java.Certification.2nd.Edition.chm
Addison.Wesley.A.Programmers.Guide.To.Java.Certification.2nd.Edition.eBook-L
iB.chm
Addison.Wesley.Developing.Enterprise Java Applications with J2EE and UML.pdf
Addison.Wesley.Dot.NET For Java Developers Migrating To C Sharp.chm
Addison.Wesley.Dot.NET.For.Java.Deve... 阅读全帖 |
|
r*****d
发帖数: 1924 | 42 【 以下文字转载自 WashingtonDC 讨论区 】
发信人: Westridge (西岭), 信区: WashingtonDC
标 题: Java开发人员知识点（更新）
发信站: BBS 未名空间站 (Wed Apr 18 00:03:19 2012, 美东)
Java开发人员知识点
1.听说过James Gosling，SUN和Oracle公司。知道网上下载Java的地址，在哪讨论Java
。练习过Java在Windows下的安装和配置。知道Java应用系统中常见的几种license和JCP。了
解bytecode和Java在不同系统下可以轻松移植的原理。
2.懂得基本的Java编程和行命令格式。了解面向对象的编程思路。
几个基本点：Java基本语法和控制结构，命名和代码风格，结构化，对象封装，继承，
抽象，多态，接口，异常处理，堆空间，栈空间，垃圾回收器，static，this，
synchronized，annotations，JUnit，JDBC，JSP/servlet
Java Core APIs: java.lang，java.util，java.io，java.a... 阅读全帖 |
|
w***o
发帖数: 109 | 43 Java has buildin PriorityQueue. google javadoc priorityqueue |
|
t****a
发帖数: 1212 | 44 我也能理解很多朋友对这种方法的质疑。毕竟它从提出开始有30年了，目前为止没有大
规模应用。可是我们知道很多学术概念到应用之间会相隔很久。比如OO的概念是60年代
就提出的。80年代C++出现之后才开始逐渐开始大规模应用。
Literature Programming (LP)的过程，就我的体会，更象是设计的过程，而且把设计
贯穿了整个编程序的始终。它强迫我在写程序之前仔细思考描述程序的逻辑，在整个项
目中的地位等。
在网上我看到了很多对LP的质疑，其中一种质疑是，程序并不是论文，不能够按照文章
的形式来组织程序逻辑。这里就问了一个很好的问题：程序究竟是以什么形式组织的？
文章又是以什么形式组织的？两者有相似之处么？
在我看来，两者都采用的是数据结构中的LIST(散列表)形式来组织。论文分为章，节，
小节，段落；程序也可以分为不同的逻辑分块，每个逻辑分块又分为各个小块，上层的
逻辑分块调用下层的逻辑小块，其中也存在交叉调用，就好像一篇论文内部的交叉引用
。从这个意义上说，LP的过程是自顶向下的设计过程。
支持我的论点的，经典的例子就是java里包的树状结构。
事实上，LP并不反对test... 阅读全帖 |
|
s*******e
发帖数: 1630 | 45 是啊，以前同组一三姐，平时我手把手教她可谓辛苦，连java里边一个class的method
怎么用都问我，我就找个javadoc的链接发给她，过了个把月她老板催进度，她居然敢
说我什么都不教她净让她自己上网看 |
|
c*********w
发帖数: 65 | 46 Use LinkedHashMap, check its javadoc. |
|
z****e
发帖数: 54598 | 47 hadoop是java的东西
有python接口，但是hadoop的很多东西都要自己去implement
而且一般文档都是java的文档，javadoc那些
很多概念也都是java上的概念
hadoop只是一个framework，不会java的话，你搞hadoop够呛
要想用hadoop+python，你需要对java&python都熟悉才行
那这样成本就比java developer要高了
你要搞java的类库，不会java，很难搞
python一般是scipy, numpy这些库
而不是hadoop，ecosystem不一样 |
|
l***i
发帖数: 1309 | 48 对于面试做题，很多同学关心的是我做了多少真题，leetcode刷了多少遍，还有用特定
的programming language刷。个人感觉面试做题其实不完全是你写的code能不能
compile，能不能过所有的testcase，面试是一个跟人交流的过程，对方是在考虑这个
candidate是不是能跟自己，还有自己的team合作。一个什么都不问，听完题目， 甚至
题目都没有听完就开始敲code，或者在白板上开写的candidate绝对不是一个好的
candidate。一个好的面试过程应该是能让对方知道你的thinking process，你写code
的习惯，还有你跟teammate沟通的能力。有人说只要我写出bugfree对方能不让我过么
，这个还真不一定。一个是很难背熟150题，另外一个是如果面试官认真准备过他的题
，总能找到一些办法让你做一些extension。
下面是我总结的做题流程，抛个砖。
1. draw a picture
2. understand the problem, ask any questions if the problem is not clear. I... 阅读全帖 |
|
|
j*********s
发帖数: 61 | 50 同意普通中国人英文没这么好
不光是能看javadoc的问题，要能过面试。国内有这个能力的挣的也不少。
要么就是你有能力把人硬塞到用人的公司。 |
|
