Breaking News!

HMG announcements; Latest HMG-related news, releases, fixes and updates.

Moderator: Rathinagiri

User avatar
Roberto Lopez
HMG Founder
Posts: 3919
Joined: Wed Jul 30, 2008 6:43 pm
Has thanked: 15 times
Been thanked: 140 times

Re: Breaking News!

Post by Roberto Lopez » Mon Oct 19, 2009 1:24 pm

Roberto Lopez wrote:
apais wrote:Hi Rathi and Roberto

First of all thanks for the initiative.
But I haven't found it very friendly.
It's slow, the serach button doesn't work and the reference format doesn`t seem very usefull
Also I have found 2 missing items in the help page: "see also" and "code example".

This is not bad critic but my personal impressions in order to try to improve the quality of this document tool.

My best regards
Angel
Angel,

Was my idea to use current Harbour docs categories structure as a starting point.

A simpler alternative could be use the Clipper NG structure.

Perhaps we should do a poll to decide what docs structure is better.

Has do you any ideas?

Regards,

Roberto.
Regards/Saludos,

Roberto


(Veritas Filia Temporis)

User avatar
luisvasquezcl
Posts: 1099
Joined: Thu Jul 31, 2008 3:23 am
Location: Chile
Has thanked: 13 times
Been thanked: 14 times
Contact:

Post by luisvasquezcl » Mon Oct 19, 2009 2:16 pm

Estimado Roberto,
creo que es mejor utilizar la estructura de las ng de clipper ya que está hecho y es a lo que estamos acostumbrados.
además, la documentación avanzaría mucho si utilizamos eso mismo, sólo habría que dedicarse a lo nuevo de harbour.
saludos cordiales,
Luis Vasquez

I think it is better to use the structure of the clipper ng as it is done and what we are accustomed.
furthermore, the documents go a long way if we use that matter, would be devoted only to the new harbor.
best regards,

User avatar
apais
Posts: 282
Joined: Fri Aug 01, 2008 6:03 pm
Location: uruguay
Has thanked: 34 times
Been thanked: 22 times
Contact:

Post by apais » Mon Oct 19, 2009 2:49 pm

I agree with Luis, ng format is best for cross-referencing.
And of course a functional text search function.
I'd like also something easy translatable to other formats, pdf, etc
Also I'm wondering who will do corrections (grammar and syntaxis) to posts.
An english native speaker would be better.
I'm open to new ideas =).
The only thing I'm sure now is I don't like current wiki format =).

Regards
Angel

User avatar
mol
Posts: 3043
Joined: Thu Sep 11, 2008 5:31 am
Location: Myszków, Poland
Has thanked: 171 times
Been thanked: 92 times
Contact:

Post by mol » Mon Oct 19, 2009 4:13 pm

I prefer NG format.

User avatar
Roberto Lopez
HMG Founder
Posts: 3919
Joined: Wed Jul 30, 2008 6:43 pm
Has thanked: 15 times
Been thanked: 140 times

Post by Roberto Lopez » Mon Oct 19, 2009 5:06 pm

Luis, Angel,

I've created a poll to help on the decision of wiki categories structure.

Luis,
I think it is better to use the structure of the clipper ng as it is done and what we are accustomed.
furthermore, the documents go a long way if we use that matter, would be devoted only to the new harbor.
As I always say, I'm not specialist in a licenses, but AFAIK we can not (legally) copy/paste the official Clipper docs.

Regards,

Roberto.
Regards/Saludos,

Roberto


(Veritas Filia Temporis)

mbelgrano
Posts: 59
Joined: Sun Aug 03, 2008 8:47 pm
Been thanked: 2 times

Post by mbelgrano » Mon Oct 19, 2009 6:22 pm

we need a format with a future
hlp is basically a win only platform (also win same
ng is old dos (also win same win program)

pdf is the best way

Pdf have the search capability
and is multiplatform

User avatar
apais
Posts: 282
Joined: Fri Aug 01, 2008 6:03 pm
Location: uruguay
Has thanked: 34 times
Been thanked: 22 times
Contact:

Post by apais » Mon Oct 19, 2009 6:41 pm

Massimo:

Here we are talking about document structure and organization not about software format.
Software format is html.

Regards
Angel

User avatar
luisvasquezcl
Posts: 1099
Joined: Thu Jul 31, 2008 3:23 am
Location: Chile
Has thanked: 13 times
Been thanked: 14 times
Contact:

Post by luisvasquezcl » Mon Oct 19, 2009 7:28 pm

Dear Roberto,
I think there are no problems with that issue. Seeing the help of harbor at Harbor-project I find that the text is the same as the clipper ng http://www.harbour-project.org/doc/dbusearea.htm
if the sr. Linares use the text of the ng I do not think we will reuse problems.
I will not argue or lengthen the subject so if you decide you do not use ... we will give the keyboard no more :D .
Best Regards,
Luis Vasquez

Estimado Roberto,
Creo que no hay problemas con ese tema. Viendo la ayuda de harbour en harbour-project me encuentro con que el texto es el mismo de la ng de clipper http://www.harbour-project.org/doc/dbusearea.htm
si el sr. Linares usa el texto de la ng creo que no habrá problemas de reutilizarlo nosotros.
No quiero polemizar ni alargar el tema asi que si decides que no se usa... vamos a darle al teclado nomas. :D
Saludos cordiales,
Luis Vasquez

arroya2
Posts: 160
Joined: Thu Aug 06, 2009 7:16 am

Post by arroya2 » Mon Oct 19, 2009 7:39 pm

Roberto Lopez wrote:Hi All,

Based on an interesting idea from Massimo Belgrano we decided to add an specific area on the forum for Harbour compiler related issues.

We could help to determine if issues posted are true bugs and then, report to Harbour's SourceForge bug tracker to be analyzed by harbour developers.

Since HMG includes now the 'official' Harbour make tool (HBMK2) and unmodified versions of contrib libraries, the bug analisys should be 'transparent' to Harbour developers.

Another interesting Massimo idea is to have a Wiki to help to create a (really needed) Harbour documentation.

Rathinagiri already added a Wiki to the site (TikiWiki). You can access it in: wiki

Volunteers are welcome. We will succeed, only with your help.

Finally, we decided to, to add a Spanish language area in the forum ('HMG en Español') to avoid 'Spanglish' threads :).

All is already set and working.

Thanks in advance.


Rathinagiri S. & Roberto Lopez.
Hola a todos.

Me gusta mucho la idea y deseo que tenga mucho éxito.

Gracias Maestro

Saludos
Rafael Pérez

User avatar
Roberto Lopez
HMG Founder
Posts: 3919
Joined: Wed Jul 30, 2008 6:43 pm
Has thanked: 15 times
Been thanked: 140 times

Post by Roberto Lopez » Mon Oct 19, 2009 10:30 pm

luisvasquezcl wrote:Dear Roberto,
I think there are no problems with that issue. Seeing the help of harbor at Harbor-project I find that the text is the same as the clipper ng http://www.harbour-project.org/doc/dbusearea.htm
<...>

Estimado Roberto,
Creo que no hay problemas con ese tema. Viendo la ayuda de harbour en harbour-project me encuentro con que el texto es el mismo de la ng de clipper http://www.harbour-project.org/doc/dbusearea.htm
<...>
Please, note that the texts are very similar, but not the same:

http://www.itlnet.net/programming/progr ... 3575a.html

vs.

http://www.harbour-project.org/doc/dbusearea.htm

Besides that, AFAIK the original Clipper docs text are not being used in any commercial product.

Regards,

Roberto.
Regards/Saludos,

Roberto


(Veritas Filia Temporis)

Post Reply