Re: [fpc-devel] FPDoc and Lazarus
Hello, I think that one thing passed here unnoticed Michael, Hans-Peter is correct in pointing out that the fpdoc.css is missing and this prevents building the FCL docs and nothing is written about this in the README. I think it should be added to the subversion, but which fpdoc.css should I add? The one which Lazarus uses? Or do you have a more special version for fpc? I did just this: cd fpcdocs make rtl.chk make fcl.chk and I got: FPDoc - Free Pascal Documentation Tool Version 2.4.4 [2011/05/01] (c) 2000 - 2003 Areca Systems GmbH / Sebastian Guenther, s...@freepascal.org new alias #rtl.System.IInterface (IUnknown) new alias #rtl.System.IInterface (IUnknown) new alias #rtl.System.IInterface (IUnknown) new alias #rtl.System.IInterface (IUnknown) new alias #rtl.System.IInterface (IUnknown) exception at 000C1293: ../packages/fcl-base/src/iostream.pp. cp fpdoc.cst fcl/fpdoc.css cp: fcl/fpdoc.css: No such file or directory make: *** [fcl.chk] Error 1 I would also like to add to the README the syntax to pass a path to the CSS, but this command had no effect for me: make fcl.chk OPT=-css-file=/Users/felipe/Programas/lazarus/docs/html/fpdoc.css The only way that I could make it work was by creating a directory fcl and putting fpdoc.css from Lazarus inside it. Now it works for me with these commands: make rtl.chk make fcl.chk make html FPCSRCDIR=../fpctrunk/ Except for the fact that I have no latex installed, so the html generation fails. One more question: What is the output of make rtl.chk? I could find nothing... -- Felipe Monteiro de Carvalho ___ fpc-devel maillist - fpc-devel@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-devel
Re: [fpc-devel] FPDoc and Lazarus
I just added fpvectorial to Makefile.fpc ... I would be very happy if a gentle soul could rebuild the makefile =) I always have trouble with that... thanks, -- Felipe Monteiro de Carvalho ___ fpc-devel maillist - fpc-devel@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-devel
Re: [fpc-devel] FPDoc and Lazarus
Michael Van Canneyt schrieb: Have a look at the lcl grids How to... topic, and try to find out where a passage #text var #text might violate any fpdoc assumption. For starters, you can't have a ul in a table cell. That's allowed: tr tdTitleStyle/td td pChanges the 3D look of fixed cells. There are 3 settings:/p ul livartsLazarus/var The default look/li [...] The problem here was the plain text between td and ul, which must be wrapped into an paragraph p.../p (see above). The same for the DrawCell part. Thirdly li As the drawing process is running, the visual state of each cell is adjusted according to grid options and position within grid. The visual state table Bingo! Here I was misleaded by the indentation of table :-( As a rule, never put mix #Text (text blocks) at the same level as structural elements like p ul dl ol or table. Right. It would help a lot, when also the *next* tag were shown, which requires that the preceding text must be wrapped into an paragraph. I suggest you start submitting patches for all the issues that bother you. For now I only have feature requests or bug reports, no solutions. The programs seem to work well enough for me and other people. As evidence, I refer to the many pages of existing documentation. Following your logic, a compiler is good enough when it accepts only valid code, and stops with exceptions on errors? There seem to exist other people with different experience and expectations as well :-( DoDi ___ fpc-devel maillist - fpc-devel@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-devel
Re: [fpc-devel] FPDoc and Lazarus
On 05/09/2011, Felipe Monteiro de Carvalho I think that one thing passed here unnoticed Michael, Hans-Peter is correct in pointing out that the fpdoc.css is missing and this Wasn't there a built-in template inside fpdoc, that on generating the HTML output, it generated the fpdoc.css. I vaguely remember something like this - or maybe it was simply a feature request. should I add? The one which Lazarus uses? Or do you have a more special version for fpc? The one Lazaru uses is broken, so don't use that one. It causes double-spacing in the HTML output. Use the one I posted a URL link to, or use the one use by the freepascal.org website. http://www.freepascal.org/docs-html/rtl/index.html make rtl.chk make fcl.chk make html FPCSRCDIR=../fpctrunk/ Except for the fact that I have no latex installed, so the html generation fails. You are confused, or didn't read the README.DOCS file very well. The first two commands don't require LaTeX, because they use fpdoc XML files and the FPC source code as the documentation source. You would probably have to pass in the FPCSRCDIR parameter too though. The last command 'make html', generates the full documentation. That means RTL, FCL, Language Reference, User Guide, Programmer Guide etc... The last three are *.tex file, hence they need LaTeX or the LaTex-to-HTML tool to work. What is the output of make rtl.chk? I could find nothing... There should have been a 'rtl' directory created in the current directory, with the HTML class documentation for the RTL. -- Regards, - Graeme - ___ fpGUI - a cross-platform Free Pascal GUI toolkit http://fpgui.sourceforge.net ___ fpc-devel maillist - fpc-devel@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-devel
Re: [fpc-devel] FPDoc and Lazarus
On Mon, 5 Sep 2011, Felipe Monteiro de Carvalho wrote: Hello, I think that one thing passed here unnoticed Michael, Hans-Peter is correct in pointing out that the fpdoc.css is missing and this prevents building the FCL docs and nothing is written about this in the README. I think it should be added to the subversion, but which fpdoc.css should I add? The one which Lazarus uses? Or do you have a more special version for fpc? I did just this: cd fpcdocs make rtl.chk make fcl.chk and I got: FPDoc - Free Pascal Documentation Tool Version 2.4.4 [2011/05/01] (c) 2000 - 2003 Areca Systems GmbH / Sebastian Guenther, s...@freepascal.org new alias #rtl.System.IInterface (IUnknown) new alias #rtl.System.IInterface (IUnknown) new alias #rtl.System.IInterface (IUnknown) new alias #rtl.System.IInterface (IUnknown) new alias #rtl.System.IInterface (IUnknown) exception at 000C1293: ../packages/fcl-base/src/iostream.pp. cp fpdoc.cst fcl/fpdoc.css cp: fcl/fpdoc.css: No such file or directory make: *** [fcl.chk] Error 1 It is normal that this fails, since the fpdoc run gave an error and did not produce the fcl dir. What is strange is that the Makefile should not even run the command in that file. I would also like to add to the README the syntax to pass a path to the CSS, but this command had no effect for me: make fcl.chk OPT=-css-file=/Users/felipe/Programas/lazarus/docs/html/fpdoc.css Define CSSFILE make fcl.chk CSSFILE=/Users/felipe/Programas/lazarus/docs/html/fpdoc.css The only way that I could make it work was by creating a directory fcl and putting fpdoc.css from Lazarus inside it. Now it works for me with these commands: make rtl.chk make fcl.chk make html FPCSRCDIR=../fpctrunk/ Except for the fact that I have no latex installed, so the html generation fails. One more question: What is the output of make rtl.chk? I could find nothing... The rtl dir. Michael. ___ fpc-devel maillist - fpc-devel@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-devel
Re: [fpc-devel] FPDoc and Lazarus
Felipe Monteiro de Carvalho schrieb: I just added fpvectorial to Makefile.fpc ... I would be very happy if a gentle soul could rebuild the makefile =) I always have trouble with that... Also graph and systhreads should be added to the rtl docs, and sqldb to the fcl. DoDi ___ fpc-devel maillist - fpc-devel@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-devel
Re: [fpc-devel] FPDoc and Lazarus
On Mon, 5 Sep 2011, Felipe Monteiro de Carvalho wrote: I just added fpvectorial to Makefile.fpc ... I would be very happy if a gentle soul could rebuild the makefile =) I always have trouble with that... I have put it under a define FPVECTORIAL. Only completely documented units are added to the distributed docs, so if you want it added to the official distro, you'll have to complete the documentation first. Michael. ___ fpc-devel maillist - fpc-devel@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-devel
Re: [fpc-devel] FPDoc and Lazarus
On Mon, Sep 5, 2011 at 9:19 AM, michael.vancann...@wisa.be wrote: I have put it under a define FPVECTORIAL. Only completely documented units are added to the distributed docs, so if you want it added to the official distro, you'll have to complete the documentation first. It is already complete AFAIK. What are you missing? -- Felipe Monteiro de Carvalho ___ fpc-devel maillist - fpc-devel@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-devel
Re: [fpc-devel] FPDoc and Lazarus
On 05 Sep 2011, at 08:36, Felipe Monteiro de Carvalho wrote: I just added fpvectorial to Makefile.fpc ... I would be very happy if a gentle soul could rebuild the makefile =) I always have trouble with that... The procedure is: 1) perform make all in the top level FPC directory 2) use the newly generated utils/fpcm/fpcmake (utils\fpcm\fpcmake.exe) to perform a fpcmake -Tall in the directory where you want to regenerate the Makefile 3) there is no step 3 Jonas___ fpc-devel maillist - fpc-devel@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-devel
Re: [fpc-devel] FPDoc and Lazarus
On Mon, 5 Sep 2011, Hans-Peter Diettrich wrote: Michael Van Canneyt schrieb: Have a look at the lcl grids How to... topic, and try to find out where a passage #text var #text might violate any fpdoc assumption. For starters, you can't have a ul in a table cell. It would help a lot, when also the *next* tag were shown, which requires that the preceding text must be wrapped into an paragraph. I suggest you start submitting patches for all the issues that bother you. For now I only have feature requests or bug reports, no solutions. The programs seem to work well enough for me and other people. As evidence, I refer to the many pages of existing documentation. Following your logic, a compiler is good enough when it accepts only valid code, and stops with exceptions on errors? I would have absolutely no problems with it. The error must be fixed first anyway. I always look at the first error, fix it and recompile. I don't even look at the rest. That doesn't mean I don't consider a compiler that would try to continue and give more info as a better compiler, but for my purposes the first one is enough. There seem to exist other people with different experience and expectations as well :-( No problem with that either. But they should not expect me to solve their issues for them, unless they can convince me that it's really an issue. And so far, you have not convinced me. Well, at least not of the fact that there are serious issues with fpdoc. The issues with the style file, I already fixed as you should well know. Michael. ___ fpc-devel maillist - fpc-devel@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-devel
Re: [fpc-devel] FPDoc and Lazarus
On Mon, 5 Sep 2011, Felipe Monteiro de Carvalho wrote: On Mon, Sep 5, 2011 at 9:19 AM, michael.vancann...@wisa.be wrote: I have put it under a define FPVECTORIAL. Only completely documented units are added to the distributed docs, so if you want it added to the official distro, you'll have to complete the documentation first. It is already complete AFAIK. What are you missing? Content, of course. It's simply an empty skeleton file. That's not enough. Every identifier must be documented. !-- variable Visibility: default -- element name=TPath.Len short/short descr /descr seealso /seealso /element !-- variable Visibility: default -- element name=TPath.Points short/short descr /descr seealso /seealso /element !-- variable Visibility: default -- element name=TPath.PointsEnd short/short descr /descr seealso /seealso /element !-- variable Visibility: default -- element name=TPath.CurPoint short/short descr /descr seealso /seealso /element Michael. ___ fpc-devel maillist - fpc-devel@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-devel
Re: [fpc-devel] FPDoc and Lazarus
On Mon, 5 Sep 2011, Hans-Peter Diettrich wrote: Felipe Monteiro de Carvalho schrieb: I just added fpvectorial to Makefile.fpc ... I would be very happy if a gentle soul could rebuild the makefile =) I always have trouble with that... Also graph and systhreads should be added to the rtl docs, and sqldb to the fcl. Not unless they are completely documented. Michael. ___ fpc-devel maillist - fpc-devel@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-devel
Re: [fpc-devel] FPDoc and Lazarus
On Mon, Sep 5, 2011 at 9:32 AM, michael.vancann...@wisa.be wrote: It's simply an empty skeleton file. That's not enough. Every identifier must be documented. Is rev822 good enough? -- Felipe Monteiro de Carvalho ___ fpc-devel maillist - fpc-devel@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-devel
Re: [fpc-devel] FPDoc and Lazarus
On Mon, 5 Sep 2011, Felipe Monteiro de Carvalho wrote: On Mon, Sep 5, 2011 at 9:32 AM, michael.vancann...@wisa.be wrote: It's simply an empty skeleton file. That's not enough. Every identifier must be documented. Is rev822 good enough? Formally, yes. Michael. ___ fpc-devel maillist - fpc-devel@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-devel
Re: [fpc-devel] FPDoc and Lazarus
In our previous episode, Hans-Peter Diettrich said: Also graph and systhreads should be added to the rtl docs, and sqldb to the fcl. systhreads? ___ fpc-devel maillist - fpc-devel@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-devel
Re: [fpc-devel] FPDoc and Lazarus
In rev823 I modified the README to make more clear that the path to the sources is indispensable, hopefully avoiding confusion in the future. It seams that all of the errors that I had were related to the missing sources path... thanks, -- Felipe Monteiro de Carvalho ___ fpc-devel maillist - fpc-devel@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-devel
Re: [fpc-devel] FPDoc and Lazarus
On Mon, Sep 5, 2011 at 10:24 AM, michael.vancann...@wisa.be wrote: Formally, yes. So will you remove the define and add it to the fcl docs? thanks, -- Felipe Monteiro de Carvalho ___ fpc-devel maillist - fpc-devel@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-devel
Re: [fpc-devel] FPDoc and Lazarus
On Mon, 5 Sep 2011, Felipe Monteiro de Carvalho wrote: In rev823 I modified the README to make more clear that the path to the sources is indispensable, hopefully avoiding confusion in the future. The explanation you provided was aleady there, complete with example, but further in the readme. I adapted and simplified the text so it refers to the existing text. Michael. ___ fpc-devel maillist - fpc-devel@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-devel
Re: [fpc-devel] FPDoc and Lazarus
On Mon, 5 Sep 2011, michael.vancann...@wisa.be wrote: On Mon, 5 Sep 2011, Felipe Monteiro de Carvalho wrote: On Mon, Sep 5, 2011 at 10:24 AM, michael.vancann...@wisa.be wrote: Formally, yes. So will you remove the define and add it to the fcl docs? I will. Did you test your XML at all ? I had at least 3 errors in the XML structure. I fixed the XML, and then added fpvectorial. Michael. ___ fpc-devel maillist - fpc-devel@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-devel
Re: [fpc-devel] make clean problem with 2.6 fixes bracnh
On Tue, Aug 30, 2011 at 7:55 AM, Martin laza...@mfriebe.de wrote: very weird issue; I have a batch fiel, that does (sucesfull): make.exe clean distclean make.exe all LINKSMART=1 CREATESMART=1 OPTIMIZE=1 OPT=-gl -O3 -Or -CpPENTIUMM -OpPENTIUMM make.exe install INSTALL_PREFIX=c:\FPC\fix_2_6_0 COPYTREE=echo UPXPROG=echo Then the makefile should execute another make clean and that always fails. It appears to dislike the fpmake.exe in fcl-web, but that was created by the above (I did delete it before I started the overall process, so it was definetly reated by the above) The error I get: { .\fpmake.exe distclean --localunitdir=../.. --globalunitdir=.. --os=win32 --cpu=i386 -o -Ur -o -Xs -o -O2 -o -n -o -FuC:/FPC/SVN/fix_2_6/rtl -o -FuC:/FPC/SVN/fix_2_6/packages/hash -o -FuC:/FPC/SVN/fix_2_6/packages/paszlib -o -FuC:/FPC/SVN/fix_2_6/packages/fcl-process -o -FuC:/FPC/SVN/fix_2_6/packages/fpmkunit -o -FE. -o -FUunits/i386-win32 -o -di386 -o -dRELEASE --compiler=c:/FPC/SVN/ppc386_2_4_4.exe; if [ $? != 0 ]; then { echo Something wrong with fpmake exectable. Remove the executable and call make recursively to recover.; C:/FPC/SVN/trunk_build/ rm.exe -f .\fpmake.exe; make fpc_cleanall; }; fi; } '{' is not recognized as an internal or external command, the part of the fcl-web makefile that is probably responsibel The problem continues. There is a bugtrack for this? I found this http://bugs.freepascal.org/view.php?id=19140 Marcos Douglas ___ fpc-devel maillist - fpc-devel@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-devel
Re: [fpc-devel] make clean problem with 2.6 fixes bracnh
2011/9/5 Marcos Douglas m...@delfire.net: The problem continues. There is a bugtrack for this? I found this http://bugs.freepascal.org/view.php?id=19140 What is your PATH environment variable? Make sure that it contains at least one semicolon (;), otherwise the Makefile considers your target a unix like target. My PATH is change only inside the script like this: set PATH=%myBINUTILS_PATH%;%myFPC%\bin\%myTARGET% As you can see, there is one semicolon... but not at the end. Should have? Marcos Douglas ___ fpc-devel maillist - fpc-devel@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-devel
Re: [fpc-devel] FPDoc and Lazarus
Marco van de Voort schrieb: In our previous episode, Hans-Peter Diettrich said: Also graph and systhreads should be added to the rtl docs, and sqldb to the fcl. systhreads? Sorry: systhrds (see fpcdocs directory) DoDi ___ fpc-devel maillist - fpc-devel@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-devel
Re: [fpc-devel] FPDoc and Lazarus
In our previous episode, Hans-Peter Diettrich said: Also graph and systhreads should be added to the rtl docs, and sqldb to the fcl. systhreads? Sorry: systhrds (see fpcdocs directory) Afaik systhrds no longer exist for years. ___ fpc-devel maillist - fpc-devel@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-devel
[fpc-devel] freepascal support for debian armhf
First a bit of background, on arm ebi gcc has three options for -mfloat-abi soft: do all floating point in software, ignore the fpu type selection softfp: use the selected fpu type but use the same calling conventions as soft (that is parameters are passed using integer registers). This gives binary compatibility with soft float code but in the case of vfp it comes at a substantial performance cost as all parameters must be moved between fpu and integer registers which causes pipeline stalls hard: use the selected fpu type and use fpu type specific calling conventions. Debian is in the process of introducing a new port called armhf which uses -mfloat-abi=hard with VFP (which seems to be become the dominant FPU now). Afaict from quick tests freepascal does support vfp but based on my tests always uses the soft calling convention. So it won't link correctly with C code that uses floating point parameters on debian armhf. 1: can someone who knows the fpc arm code confirm the above statement? 2: does anyone have any idea what it would take to add support for the eabi vfp calling convention and for building fpc binaries that use it by default (just as armel FPC binaries use eabi by default) 3: does anyone have any plans to actually do so (I might attempt it but i'm not a compiler developer nor am I an arm assembly programmer, just someone who uses both freepascal and debian on an arm system that could benefit from armhf) ___ fpc-devel maillist - fpc-devel@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-devel