Hi Alejandro,
I agree, that anything actually _done_ with the docs
(in any format), or with hbdoc can only help.
Brgds,
Viktor
On 2008.08.29., at 16:24, Alejandro de Garate wrote:
I was thinking about Harbour's documentacion and from what I can
recall
last time I build doc info, I found and noted the following:
NG doc:
---------
I have to bend some NG rules because in Harbour exists Functions &
Commands with more than 10 characters in its names, and the right
side of the screen, menus and other parts of the harbour.ng had to
be modificated.
So I see serius problems to use this format.
Changing to a New source format:
----------------------------------------
I don't know nothing about other popular formats like man or robocop
or...
whatever.
But if we switch to said.. robocop doc source and in the future, we
need to
change or switch to another tool we face it with the same problem.
My opinion is:
probably the better and more simple decision is to continue with the
NANFOR
format (which is quite simple) as the source doc format. And build the
docs as HTML (as first election) and PDF (I never make it) or other
format
as second choice).
Using a good template or config file we can change the current
format to fit
a standard like XTML and then if we find apropiate we can adopt it
in the
future as the new source doc format.
Of course it's imperative that we will make the Harbour doc easely
and as
soon as we can, but following some agreed rules.
But build it, is only a technical matter, and sooner or later we
will do it.
The other issue and it's not minor, is almost nobody is writing docs,
so the main problem still remains.
Anyway... we can get one step at a time
Alejandro
_________________________________________________________________
Connect to the next generation of MSN Messenger
http://imagine-msn.com/messenger/launch80/default.aspx?locale=en-us&source=wlmailtagline_______________________________________________
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