i want refer a good documentation regarding harbour as chm/html 
http://www.oohg.org/manual/harbour/(x)harbour.html

It is made by free helpmaker (http://www.vizacc.com/Default.aspx ) HelpMaker is 
a good  Help Authoring tool.It can export htm,pdf,rtf
This documentation is made by Janusz in the oop minigui project and i have his 
agreement on upload on Harbour csv.

Can we include this documentation on next harbour distribution?

-----Messaggio originale-----
Da: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED] Per conto di bill robertson
Inviato: giovedì 21 agosto 2008 22.06
A: Harbour Project Main Developer List.
Oggetto: Re: [Harbour] hbmake

----- Original Message ----- 
From: "Szakáts Viktor" <[EMAIL PROTECTED]>
To: "Harbour Project Main Developer List." <harbour@harbour-project.org>
Sent: Thursday, August 21, 2008 2:11 PM
Subject: Re: [Harbour] hbmake


> Hi Bill,
>
> Can you send me a patch for the current version
> of hbmake, with your fixes?
>
Hi Viktor,

I never patched hbmake, only hbdoc and the fixes for hbdoc were for 
DOS/Windows only tools which are fairly limited in scope. I was hoping that 
someone would have answered your request in Dec for input about using a more 
modern documentor such as robodoc or natural doc.

I thought about adding a module to hbdoc to produce robodoc files. However, 
when I looked at the document files, their format and quality was 
inconsistent. Some of the better docs didn't have any of the tags that hbdoc 
used. For example, none of the text files in \harbour\doc\ have the $tag$ 
format and they contain quite useful information. Most, but not all, of the 
text files in the en/ and es/ directories have $tag$ formats. To a lesser 
extent, the same is true of the .prg and .c files.

Some of the files have no more than the following information. This isn't in 
the standard hbdoc format and while my changes handled this OK; it's of very 
limited use.
 * $Doc$
 * $Description$  Debug function tests.
 *                Based on classes.prg
 * $Requirement$  source\tools\stringp.prg
 *                source\rtl\objfunc.prg
 *                source\rtl\asort.prg
 * $End$

Because of these little problems, I loaded the windows version of the groff 
document processing packages and looked at the old macros I used to use with 
UNIX System V. Those macros (man, me, ms, mm) seem pretty dated to me now. 
Even the new mom macro didn't seem to produce much improvement without a lot 
of effort. No wonder xHarbour had such a cost overrun with their manual 
produced by Dr. Ziegler.

As it stands, your idea of moving hbdoc and hbmake out of the main stream 
may be best. I might be able to make some small improvements in hbdoc and 
hbmake, but I'm quite novice compared to the harbour developers. 

_______________________________________________
Harbour mailing list
Harbour@harbour-project.org
http://lists.harbour-project.org/mailman/listinfo/harbour
_______________________________________________
Harbour mailing list
Harbour@harbour-project.org
http://lists.harbour-project.org/mailman/listinfo/harbour

Reply via email to