Mailing-List: contact harmony-dev-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: harmony-dev@incubator.apache.org
Received-SPF: neutral (herse.apache.org: 202.81.18.155 is neither permitted
 nor denied by domain of paulex.yang@gmail.com)
Message-ID: <4549DD7A.2060708@gmail.com>
Date: Thu, 02 Nov 2006 11:58:50 +0000
From: Paulex Yang <paulex.yang@gmail.com>
User-Agent: Thunderbird 1.5.0.7 (Windows/20060909)
MIME-Version: 1.0
To: harmony-dev@incubator.apache.org
Subject: Re: [classlib][portlib] Docs?
References: 
 <523F3D8D8C97554AA47E53DF1A05466A587F3C@nnsmsx411.ccr.corp.intel.com>
	 <4548A062.6070006@gmail.com>
 <c3755b3a0611010541n704c37cfn8cc79efc6d7e0810@mail.gmail.com>
 <4548B0E8.8010309@pobox.com> <4548D2AC.7070609@gmail.com>
 <45497246.5090505@pobox.com>
In-Reply-To: <45497246.5090505@pobox.com>
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset=UTF-8; format=flowed

Geir Magnusson Jr. wrote:
>
>
> Paulex Yang wrote:
>> Geir Magnusson Jr. wrote:
>>> yeah - someone generate, and we can hang them on the website.  I'm 
>>> not sure we'd want to check them in though...
>> Is it possible to add documents into website but not to commit them 
>> in SVN?
>
> Yep.  I was thinking the same for the Doxygen docs.
>
> Basically, you just create locally, review, and then tar and put up on 
> site manually.
+1 to go for that
>
> It does remove the ability for group oversight (IOW, no commit msgs), 
> but if the generation process isn't very stale (small changes to one 
> page have repercussions all over...) then it keeps the SVN churn to a 
> minimum.
Actually I have no idea what kind of commit msgs needed for API 
document...they are just generated by tools from codes. I think the most 
important information is the svn revision number against which the 
document is generated, any doxygen guru can help to find a way? Any 
chance to pass a revision number to doxygen and to get it added into 
footer of every page?
>
> geir
>
>
>  We removed them from classlib/trunk/doc because the SVN metadata
>> get in the way when updating the document.
>>>
>>> I've done this before for API docs...
>>>
>>> geir
>>>
>>>
>>> Alexey Petrenko wrote:
>>>> Having these docs on website will be really good!
>>>>
>>>> SY, Alexey
>>>>
>>>> 2006/11/1, Paulex Yang <paulex.yang@gmail.com>:
>>>>> If you get Doxygen installed, you can create it by running "ant
>>>>> doxygen-natives" in classlib/trunk/doc. There were discussions to 
>>>>> move
>>>>> the document to somewhere on website, but seems it is still to be 
>>>>> done.
>>>>>
>>>>> Morozova, Nadezhda wrote:
>>>>> > Not that I know of :( bits of things are in the devguide, maybe. 
>>>>> But you
>>>>> > probably won't find that of much notice.
>>>>> > Anyone, please tell me it's not true!
>>>>> >
>>>>> > Thank you,
>>>>> > Nadya Morozova
>>>>> >
>>>>> >
>>>>> > -----Original Message-----
>>>>> > From: Alexey Petrenko [mailto:alexey.a.petrenko@gmail.com]
>>>>> > Sent: Wednesday, November 01, 2006 4:15 PM
>>>>> > To: harmony-dev@incubator.apache.org
>>>>> > Subject: [classlib][portlib] Docs?
>>>>> >
>>>>> > Guys,
>>>>> >
>>>>> > do we have any docs on portlib?
>>>>> >
>>>>> > SY, Alexey
>>>>> >
>>>>> >
>>>>>
>>>>>
>>>>> -- 
>>>>> Paulex Yang
>>>>> China Software Development Lab
>>>>> IBM
>>>>>
>>>>>
>>>>>
>>>>
>>>
>>
>>
>


-- 
Paulex Yang
China Software Development Lab
IBM