i agree documentation, is the biggest Harbour need, so i want invite
anybody to contribute,the steep are very easy using hbide.
H*ow read harbour documentation with hbide*
1 Point to <Docks> option on <Main Menu> and click on <Document Viewer>
2 A right-side "Document Viewer" window will appear.
3 Provide Harbour's installation root path in "Harbour Installation Root:"
field, i.e., C:\harbour
4 Click "Refresh" icon on the toolbar of "Document Viewer" window" only once
and wait a couple of seconds. "Contents" tab will be populated with /doc and
/doc/en folders.
*How write harbour documentation with hbide*
1 Click on "Documentation Writer" icon on the right-toolbar,
2. Open some source in the editor,
3. Position cursor somewhere inside a function body,
4. Click on "Load from current function" icon on the top-toolbar of
"Document Writer" widget,
5. Look at the contents, few fields will be auto filled with various info
from current function
6. Complete the other fields with relevent information,
7.1 Click on "Save the documentation with current function",
7.2 Look at the function body in the editor,The NANFORUM compliant
documentation
will be inserted at the top of function's prototype.
8.1 Click on "Save written/updated documentation" icon,and provide the
filename to save ,
8.2 Copy such generated .txt in /harbour/doc/en,
8.3 Open "Harbour Document Viewer" and you should be viweing newly written
documentation
8.4 Such generated file is ready to be uploaded to SVN, just send it to the
list and group will decide if it needs something extra.
2010/4/6 Antonio Maniero <mani...@klip.net>:
> Hello everybody
> First of all I really sorry by my bad and poor English. I made my best.
> I am a software developer for 26 years working with several programming
> languages mostly building Line Of Business applications in Brazil.
> I worked with Clipper since Clipper exists. I used the first copy sold in
> Brazil by Softcorp (succeeded by Officer and after Nantucket Brasil and CA
> Brasil). I worked on a company (one of the major business software
companies
> in the world) that was practically the only VO beta tester in Brazil. It's
a
> shame a good idea turns trash :-) As 1996 on internet era I change my
career
> and dropped Clipper in favor of other solutions. Now I am back to LOB
> applications with total freedom to choose my way. I decided modernize my
old
> Clipper applications "porting" to Harbour. I was a big lover of Clipper,
> specially 5.2 and I had supported the way Nantucket did think Clipper
> evolution and some aspects of Visual Objects developed by CA. I liked to
see
> Clipper near to syntax and some semantics of C. Yes, I am not a typical
> Clipper developer. I think dBase style is a bad thing although is
> a necessary evil to carry.
> I want fix some errors and bad style which I made on 80's and use improved
> features available on Harbour. I need rewrite my C functions, throw away
> some, rethink about UI (console to GUI) and databases (transition from DBF
> to MySQL and others RDBMS).
> I think harbor 2.0 is a wonderful piece of software. It's not perfect
> because the heavy legacy to honor. I like the design of a clean core with
> extensions. I want publicly prize Viktor and PC (I can´t write his name
:-)
> ). I agree with most of their decisions and I strongly appreciate their
> work. Ok, now I can criticize some points without fear :-) I want to see
> Harbour moving forward, not in xHarbour style, but in smart Harbour style.
> In Brazil we have a popular expression: The hasty eating raw :-)
> I want to make it clear: I want help Harbour development. Now I can mainly
> give my opinions, try to influence some decisions, suggest enhancements,
> report bugs. I need to get experience with C99 and GCC. My C experience is
> about MS-C 5.0 (I give you a candy if you know why :-) ). I need to get
time
> to help with code. I will try to contribute with some thing later.
> I can't help too much with documentation, IMHO the biggest Harbour
> need, because my bad English. I am improving Wikipedia's article now. I
> invite you to contribute too. It's an initial work. I will contribute more
> on Portuguese article. I am writing about Harbour on a variety of articles
> (xBase, programming languages comparison, etc). See my contribs logged as
> bigown. Please, feel free to add new information or edit and delete wrong
or
> bad text. I am reviewing text bring from xHarbour. It's a good way to
learn
> more about Harbour. Viktor, I think now the article is very bad, but not a
> shame anymore ;-)
> In the next days I will try reply some old messages with my opinions.
> I would like help with HBIDE but I have a very different programming style
> and my major problem as developer is difficulty of adaptation on other
> style. Totally my fault. Anyway I would like to see HBIDE evolution
mainly
> in code editor and debugger. In fact I hope to get HBIDE compiled. Four
days
> trying and nothing :-) But I can't get any application using Qt or MySQL
> compiled. Maybe my Harbour build is wrong. I still trying.
> Well, I have to learn a lot about Harbour, try it on Linux and I hope PC
> (druzus) can get some time to answer some doubts about PP. I have special
> interest about it because I am thinking to write a transformation software
> to change my legacy code. I love Clipper/Harbour PP and I abuse it, but I
> know what I am doing.
> Now I have a lot of work to do.
> Thanks to everyone efforts. Harbour community need to be more active to
> "sell" Harbour on the web. IMHO most xBase programmer is individualist too
> much, including. I hope change this.
> Feel free to write me in private when the list is not adequate place.
> []'s
> Antonio Maniero
>
--
Massimo Belgrano
_______________________________________________
Harbour mailing list (attachment size limit: 40KB)
Harbour@harbour-project.org
http://lists.harbour-project.org/mailman/listinfo/harbour
