lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Grant Ingersoll <gsing...@apache.org>
Subject Re: javadoc language
Date Fri, 19 Jun 2009 23:33:05 GMT
I think they should be in English.  Keeping the Chinese would be fine  
as well, but seems kind of pointless given all the other javadocs are  
in English.


On Jun 19, 2009, at 12:49 PM, Robert Muir wrote:

> While hunting down some strange behavior in SmartChineseAnalyzer, I
> noticed the javadocs are in Chinese.
>
> some of these do not reflect the method params, which makes it a
> little harder to work with.
>
>  /**
>   * 设计上是SentenceTokenizer的下一处理层。将 
> SentenceTokenizer的句子读出,
>   * 利用HHMMSegment主程序将句子分词,然后将分词结果 
> 返回。
>   *
>   * @param in 句子的Token
>   * @param smooth 平滑函数
>   * @param dataPath 装载核心字典与二叉字典的目录
>   * @see init()
>   */
>  public WordTokenizer(TokenStream in, WordSegmenter wordSegmenter) {
>    this.in = in;
>    this.wordSegmenter = wordSegmenter;
>  }
>
> So I wonder, should the javadocs be in Chinese, English, or both?
>
> If they are in chinese, then developers that only speak english might
> have a tough time.
> If they are in english, chinese users might have a tough time, but
> then again the rest of lucene javadoc is in english.
> If they are in both, maintaining the chinese javadocs will be
> difficult for developers that only speak english, and vice-versa.
>
> Thanks!
>
> -- 
> Robert Muir
> rcmuir@gmail.com
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
> For additional commands, e-mail: java-dev-help@lucene.apache.org
>


---------------------------------------------------------------------
To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org


Mime
View raw message