lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Robert Muir <rcm...@gmail.com>
Subject Re: javadoc language
Date Sun, 28 Jun 2009 22:11:29 GMT
Thanks for both of your feedback. I'm starting to work on a patch so
if you are opposed please speak up :)

On Sat, Jun 20, 2009 at 12:32 AM, Otis
Gospodnetic<otis_gospodnetic@yahoo.com> wrote:
>
> +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
>
>



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


Mime
View raw message