[Harbour-users] Re: Harbour Documentation

Suporte - Tribal Brasil suporte at tribalbrasil.com
Wed Feb 17 08:18:38 EST 2010


Pete,

    Try to contact Vailton. He is one of those who help to mantain the 
www.harbour-project.org webpage.
    His email address: vailtom at gmail.com

Qatan

----- Original Message ----- 
From: "Pete" <pete_westg at yahoo.gr>
To: <harbour-users at harbour-project.org>
Sent: Wednesday, February 17, 2010 7:36 AM
Subject: [Harbour-users] Re: Harbour Documentation


> Daniel Gonçalves <daniel at ...> writes:
>
>>
>> Hello,
>> Why not use ReST [1] (Restructured Text) using the excelent Sphinx [2]
>> documentation tool. These are the tools used to document the Python
>> project [3][4].
>> If I can help in any way, I'm available and very insterested in a
>> better/accessible Harbour documentation.
>>
>> [1] http://docutils.sourceforge.net/rst.html
>> [2] http://sphinx.pocoo.org/
>> [3] http://www.python.org/
>> [4] http://docs.python.org/library/index.html
>>
>> In the page [4], look at the "Show source" link on the left, to see
>> how the source documents looks like.
>>
>> Regards,
>>
>
> hello Daniel,
>
> I do also have spent some hours examining documentation tools like 
> 'doxygen',
> 'LyX' and others, although the ones you have suggested are very good, i'd 
> say
> more interesting than those i did refer. But the sure thing is, that they 
> demand
> advanced experience and good usage knowledge to get a good result. and 
> time! and
> the most important,  we need well formed/edited texts which is the core 
> material
> of any documentation. On the other hand, i do see that into harbour's 
> website
> there are already a lot of documentation pages. perhaps some of the topics
> there, are outdated/obsolete due to newer 
> implementation/changes/enhancements
> and need revision/correction. but this place and this material could be a 
> good
> base point to start (re-)working on documentation. I don't know who is
> responsible to maintain these pages, but it's time to ask the webmasters 
> (if
> anyone of them is reading this thread), in what way somebody (like
> you,me,anyone) willing to help in harbours documentation could involve and 
> start
> working on. Then we could make a plan about specific things that must be 
> done.
>
> regards,
>
> ---
> Pete
>
> _______________________________________________
> Harbour-users mailing list (attachment size limit: 40KB)
> Harbour-users at harbour-project.org
> http://lists.harbour-project.org/mailman/listinfo/harbour-users 



More information about the Harbour-users mailing list