[haiku-doc] Re: Getting up to speed...

  • From: Bruno Antunes <sardaukar.siet@xxxxxxxxx>
  • To: "Alan Smale" <ajsmale@xxxxxxxxx>
  • Date: Mon, 23 Apr 2007 13:05:55 +0100

Hello,

A  getting  started doc would be nice. I'm going to check out the full
trunk, but maybe this is overkill for just the docs?

--
 Regards,
 Bruno mailto:sardaukar.siet@xxxxxxxxx

Monday, April 23, 2007, 12:29:25 PM, you wrote:

> Hi Bruno,

> The svn info is detailed on the Haiku website at:

> http://haiku-os.org/documents/dev/getting_started

> The Berlios server where the source is hosted has been down over this
> weekend so obtaining the source files may not be possible yet.

> I've been having fun over this weekend trying to get things running.
> I'll try and put together a small how-to for the team, if people would
> find this beneficial?

> You can see the current state of the Haiku Documentation from this webpage

> http://factory.haiku-os.org/documentation/Haiku_Book_doxygen/html/

> Thanks

> Alan

> On 23/04/07, Bruno Antunes <sardaukar.siet@xxxxxxxxx> wrote:
>> Hello,
>>
>>  Where  can  I  get  more  information  on the SVN checkout specifics?
>>  (server, trunk...)
>>
>>
>> --
>> Regards,
>>  Bruno
>>
>> Sunday, April 22, 2007, 11:36:28 AM, you wrote:
>>
>> > Hello,
>> >
>> >   I used Cygwin/Windows combination (I'll have a BeOS system up
>> > soon though) with Subversion and Doxygen todo an anonymous checkout and 
>> > generate the documentation.
>> >
>> >   Please let me know if I am on the right track in terms of understanding 
>> > though.
>> >
>> >   1. The Doxygen commands are not in the source but are in separate
>> > .dox files. Our job is to build these .dox files by hand for each class.
>> >
>> >   2. I can understand how we create the shell of the documentation
>> > -- listing the names of the classes, methods and members, and
>> > showing classrelationships. But where are we getting the technical 
>> > explanations ?
>> >
>> >   The purpose ofsome of the methods are not obvious to me from
>> > looking at the source code. Is there an externalsource of
>> > information(BeBook?) ? Or is one of the joys of doing the
>> > documentation, the opportunity to learn the technical details of
>> > everything ? [Which is fine too since my goal is to develop some desktop 
>> > apps for Haiku.]
>> >
>> >   Thanks !
>> >
>> >   - Rich
>> >
>> >
>>
>> > Ahhh...imagining that irresistible "new car" smell?
>> >  Check out new cars at Yahoo! Autos.
>>
>>
>>
>>




Other related posts: