You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@lucene.apache.org by Robert Muir <rc...@gmail.com> on 2009/06/19 18:49:43 UTC
javadoc language
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
Re: javadoc language
Posted by Robert Muir <rc...@gmail.com>.
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<ot...@yahoo.com> wrote:
>
> +1 for English as much as I like language variety.
>
> Otis
>
>
>
> ----- Original Message ----
>> From: Grant Ingersoll <gs...@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
Re: javadoc language
Posted by Otis Gospodnetic <ot...@yahoo.com>.
+1 for English as much as I like language variety.
Otis
----- Original Message ----
> From: Grant Ingersoll <gs...@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
Re: javadoc language
Posted by Grant Ingersoll <gs...@apache.org>.
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