lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Otis Gospodnetic <otis_gospodne...@yahoo.com>
Subject Re: javadoc language
Date Sat, 20 Jun 2009 04:32:24 GMT

+1 for English as much as I like language variety.

Otis



----- Original Message ----
> From: Grant Ingersoll <gsingers@apache.org>
> To: java-dev@lucene.apache.org
> Sent: Friday, June 19, 2009 7:33:05 PM
> Subject: Re: javadoc language
> 
> 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


---------------------------------------------------------------------
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