HMGforum.com

Hi:
I've made some test with hmg documents, based on that we discuss in
the message http://hmgforum.com/viewtopic.php?f=32&t=1897&start=30.

I've made a tool to produce htm documents from txt. Is very similar
than hbdoc, just with small changes to make it more flexible to fit with our needs.
It's not finished, I want to produce pdf documents with this tool,
but I don't know how to build the tree in a pdf doc. (if someone know it, please let me know)
Before spend more time on this tool, I want to know if we continue with hmg docs as we discuss in
previous message.
If the answer is yes, then:

HbDoc is strict with indentation, which cause some troubles with viewers if the doc is not ok.
As you know harbour use docs with this format:
/* $DOC$
* $TEMPLATE$
* Function
* $NAME$
* __setcentury()
* $CATEGORY$
* API
* $ONELINER$
* Set the Current Century
...
* $END$
*/

Instead of this we can use docs as below.
We don't need C-style tags comments, /* * */ in txt docs.
Indentation is almost free.
BTW HMGdoc builder can read and write docs in harbour format, but I think is easier in this way.
It's possible to use the same section name several times in one document. f.e. $REMARKS$
We have to discuss about section names, but is possible expand them or reduce them.
Sections suggested by Esgici were added. $NOTES$, $HINTS$, $SEE ALSO$, $SOURCE$, $SAMPLES$, and others, read more about this in the htm.

$DOC$

$NAME$
Button

$CATEGORY$
Control

$ONELINER$
button gui object ...

...

$END$

Below there is a package to test this.
This package is to see more clear about what I'm talking about.
Please unzip it in ../hmg.4/svn/doc/
There you'll find some few source txt files, the output in htm format and the exe tool to make test.

I'll wait for your feedback.

Carlos Britos wrote: I've made some test with hmg documents, ...

Very well, Carlos; thanks a lot

I've made a tool to produce htm documents from txt. Is very similar
than hbdoc, just with small changes to make it more flexible to fit with our needs.

Yet another very well news, thanks separately

Sections suggested by Esgici were added ...

One more thanks for this also

I'll wait for your feedback.

Please don't wait much, only continue please

Saludos cordiales and muchas gracias.

--

Esgici

What a great job and contribution!

Thanks Rathinagiri, Esgici.

Rathinagiri if you are agree, I can start to create txt from hmg3 docs and commit them. Of course they must be updated later. What you think about this?

Yes please. You can do it as early as possible.

Thanks a lot.

2011-04-23 14:34 UTC-0300 Carlos Britos ( <bcd12a(a_t)yahoo.com.ar> )

60 txt files were added to HMG SVN, to build HMG docs. Still missing more.
At this moment these documents are just a very rough draft.
Feel free to edit/add as much as you like to these and new txt files.
Most files are blank or copy paste from HMG3, so must be edited.
If you don't know enough to contribute just fill them with that you know.
Don't be afraid about your mistakes. Another contributor will clean up after you.
If your english is not perfect is not a problem. Most of the users and developers are not native english speakers.
Others who know better english (as you see, not me) will edit the txt files.

Hoping this could be usefull for all of us, I encourage you to edit and/or commit txt.

If you think the estructure of docs need changes, please post it here, in this topic.

If you need it, below is the hmgdoc.exe. version 20110422 compressed with some small changes from previous one.

Carlos Britos wrote: 60 txt files were added to HMG SVN, to build HMG docs.

Thanks a lot Carlos

Saludos / Regards

--

Esgici

I forgot to say, unzip hmgdoc.zip in ../harbour/bin/

Thanks a lot. I will check this out.

Images used by docs at this time. Unzip it in /doc/res/