Hi all,
is in Harbour docs an ordered list of Harbour extensions/substitute Clipper
functions ?
I searched among the various document but I haven't found anything. Maybe I
haven't searched deeply...
Furthermore, in the doc files the documentation of each function is not
described in depth: many times it's not enough to learn its use and also some
code snippet is missing. To find informations in changelog can be a solution
but, like in these days, functions and functionality change very quickly and
it's hard to find useful informations this way. I know that it's not easy to
write a proper documentation and it's precious time that a developer can't
spend, but who can document the use of a function/class/project, if not the
developer itself?
Sometimes in the past I used C# (for very very very little time) and by using a
triple slash /// I could document each code that I was writing. The C# IDE
parsed each file in search of those tags and when we needed help over a
particular function, It showed us the informations that we put after those
tags.
Perhaps, we could use the same construct to help us to make a better
auto-documentation. It may be used in any part of Harobur code, .c, .prg and
other files (not only in the header) and it's not so far the // that a Clipper
programmer is used to use in its code.
Best regards,
Marco
> Subject: Re: [Harbour] hbct FILEATTR() function not working.
> From: harbour...@syenar.hu
> Date: Sat, 30 Jan 2010 12:42:27 +0100
> To: harbour@harbour-project.org
>
> Hi,
>
> Aside from the bug, I suggest to use Harbour core functions
> wherever they exist, in this case they are HB_FGETATTR() and
> HB_FSETATTR(). There is also HB_FGETDATETIME(), HB_FSETDATETIME().
>
> There is also HB_FSIZE(), etc.
>
> Many time these are documented in ChangeLog.
>
> Brgds,
> Viktor
>
> On 2010 Jan 30, at 10:19, smu johnson wrote:
>
> > It appears the FILEATTR() function doesn't work.
> >
> > According to http://www.ousob.com/ng/tools1-3/ng935ab.php , it says it
> > should return a bit-wise decimal number. I tried a few different ways...
> > absolute path, relative, and a piece of code my brother found from the
> > Harbour source files.
> >
> > ___Pre-test:
> >
> > C:\hbm>attrib hello.prg
> > A H C:\hbm\hello.prg
> >
> > ___Result:
> >
> > C:\hbm>hello.exe
> >
> > 0
> > 0
> > 0
> >
> > ___code
> >
> > FUNCTION main()
> >
> > ? FILEATTR("hello.prg")
> > ? FILEATTR("C:\hbm\hello.prg")
> >
> > cFile := FILESEEK("hello.prg")
> > DO WHILE .NOT. EMPTY (cFile)
> > ? cFile, FILEATTR()
> > cFile := FILESEEK()
> > ENDDO
> >
> > return
> > // end
> >
> >
> > Have I found a bug? :3
> >
> > --
> > smu johnson <smujohn...@gmail.com>
> >
> > _______________________________________________
> > Harbour mailing list (attachment size limit: 40KB)
> > Harbour@harbour-project.org
> > http://lists.harbour-project.org/mailman/listinfo/harbour
>
> _______________________________________________
> Harbour mailing list (attachment size limit: 40KB)
> Harbour@harbour-project.org
> http://lists.harbour-project.org/mailman/listinfo/harbour
_________________________________________________________________
Non sei a casa? Prova il nuovo Web Messenger
http://www.messenger.it/web/default.aspx_______________________________________________
Harbour mailing list (attachment size limit: 40KB)
Harbour@harbour-project.org
http://lists.harbour-project.org/mailman/listinfo/harbour
