Re: [fpc-pascal] Documentation typo?

2024-07-27 Thread Michael Van Canneyt via fpc-pascal
On Tue, 23 Jul 2024, Thomas Kurz via fpc-pascal wrote: Hello, in `https://www.freepascal.org/docs-html/current/rtl/sockets/netaddrtostr6.html`, it is written: NetAddrToStr6 converts the IPV6 network address in Entry to a string representation in human-readable form. Basically, it is th

[fpc-pascal] Documentation typo?

2024-07-23 Thread Thomas Kurz via fpc-pascal
Hello, in `https://www.freepascal.org/docs-html/current/rtl/sockets/netaddrtostr6.html`, it is written: NetAddrToStr6 converts the IPV6 network address in Entry to a string representation in human-readable form. Basically, it is the same as NetAddrToStr6, but with the bytes in correct order.

Re: [fpc-pascal] Documentation or compiler bug?

2023-07-08 Thread Hairy Pixels via fpc-pascal
> On Jul 8, 2023, at 3:57 PM, Michael Van Canneyt via fpc-pascal > wrote: > > You must put the cdecl (which is the calling convention) before the external: o so the order is the problem. That error message is misleading and should be changed. I know c library functions are external and

Re: [fpc-pascal] Documentation or compiler bug?

2023-07-08 Thread Michael Van Canneyt via fpc-pascal
On Sat, 8 Jul 2023, Michael Van Canneyt via fpc-pascal wrote: On Sat, 8 Jul 2023, Hairy Pixels via fpc-pascal wrote: In fact I filed a bug today which was related. Notice how I didn't use cdecl in the program but another user tried to compile and had problems with cdecl also. https://g

Re: [fpc-pascal] Documentation or compiler bug?

2023-07-08 Thread Michael Van Canneyt via fpc-pascal
On Sat, 8 Jul 2023, Hairy Pixels via fpc-pascal wrote: In fact I filed a bug today which was related. Notice how I didn't use cdecl in the program but another user tried to compile and had problems with cdecl also. https://gitlab.com/freepascal.org/fpc/source/-/issues/40342

Re: [fpc-pascal] Documentation or compiler bug?

2023-07-08 Thread Hairy Pixels via fpc-pascal
In fact I filed a bug today which was related. Notice how I didn't use cdecl in the program but another user tried to compile and had problems with cdecl also. https://gitlab.com/freepascal.org/fpc/source/-/issues/40342

Re: [fpc-pascal] Documentation or compiler bug?

2023-07-08 Thread Michael Van Canneyt via fpc-pascal
On Sat, 8 Jul 2023, Hairy Pixels via fpc-pascal wrote: I get the error "Procedure directive "CDECL" cannot be used with "EXTERNAL"" when I use "cdecl" with external modifiers yet the docs at https://www.freepascal.org/docs-html/ref/refsu73.html say": When compiling this, and linking to the C

[fpc-pascal] Documentation or compiler bug?

2023-07-07 Thread Hairy Pixels via fpc-pascal
I get the error "Procedure directive "CDECL" cannot be used with "EXTERNAL"" when I use "cdecl" with external modifiers yet the docs at https://www.freepascal.org/docs-html/ref/refsu73.html say": When compiling this, and linking to the C-library, the strlen function can be called throughout the

Re: [fpc-pascal] Documentation patch for fcl/netdb

2021-04-17 Thread Michael Van Canneyt via fpc-pascal
Thank you. I will check it out ASAP. Before publishing, I will need to document all identifiers in the unit. Michael. On Sat, 17 Apr 2021, Noel Duffy via fpc-pascal wrote: I've added a documentation patch to bug 0037906 in the bug tracker. This covers the new code that I added to fcl/netdb

[fpc-pascal] Documentation patch for fcl/netdb

2021-04-17 Thread Noel Duffy via fpc-pascal
I've added a documentation patch to bug 0037906 in the bug tracker. This covers the new code that I added to fcl/netdb for DNS resolution as well most of the other functions and procedures in the unit. The patch also adds examples that showcase the new functions. I've tested these on Fedora 32

Re: [fpc-pascal] Documentation bug - Language Ref - Ordinal types

2020-12-27 Thread Graeme Geldenhuys via fpc-pascal
On 27/12/2020 4:53 pm, Graeme Geldenhuys via fpc-pascal wrote: > > According to this HTML page: >https://freepascal.org/docs-html/ref/refsu4.html Oh wait, the table I was looking at is titled "Integer constant type mapping", so it's how the compile maps constants to a data type. It's not the

[fpc-pascal] Documentation bug - Language Ref - Ordinal types

2020-12-27 Thread Graeme Geldenhuys via fpc-pascal
According to this HTML page: https://freepascal.org/docs-html/ref/refsu4.html The data types Byte, Word and Cardinal (LongWord) has the following ranges: 128..255Byte 32768..65535Word 2147483648..4294967295 Cardinal (longword) Those should be 0.. Regards, Graeme -- fpGUI

Re: [fpc-pascal] Documentation generation

2019-08-18 Thread Graeme Geldenhuys
On 18/08/2019 10:43 am, Michael Van Canneyt wrote: > One wonders why these README files are created. No-one seems to read them > anyway. Yeah, I've been wondering that same thing for years. Maybe we should create a README.1st file. :-P Regards, Graeme -- fpGUI Toolkit - a cross-platform G

Re: [fpc-pascal] Documentation generation

2019-08-18 Thread Marco van de Voort
Op 2019-08-18 om 11:43 schreef Michael Van Canneyt: On Sat, 17 Aug 2019, leledumbo via fpc-pascal wrote: How are the FPC RTL documentations generated? I wanted to see if I could generate .docsets files from them also. A starting point: https://wiki.freepascal.org/FPCDocs_Tutorial I believe

Re: [fpc-pascal] Documentation generation

2019-08-18 Thread Michael Van Canneyt
On Sat, 17 Aug 2019, leledumbo via fpc-pascal wrote: How are the FPC RTL documentations generated? I wanted to see if I could generate .docsets files from them also. A starting point: https://wiki.freepascal.org/FPCDocs_Tutorial I believe that "write me" part is not far from calling make wit

Re: [fpc-pascal] Documentation generation

2019-08-17 Thread leledumbo via fpc-pascal
> How are the FPC RTL documentations generated? I wanted to see if I could generate .docsets files from them also. A starting point: https://wiki.freepascal.org/FPCDocs_Tutorial I believe that "write me" part is not far from calling make with certain options. -- Sent from: http://free-pascal-ge

[fpc-pascal] Documentation generation

2019-08-17 Thread Ryan Joseph
How are the FPC RTL documentations generated? I wanted to see if I could generate .docsets files from them also. Regards, Ryan Joseph ___ fpc-pascal maillist - fpc-pascal@lists.freepascal.org https://lists.freepascal.org/cgi-bin/mailman/listi

Re: [fpc-pascal] Documentation confusion or error

2019-05-08 Thread Graeme Geldenhuys
On 08/05/2019 12:58 pm, Michael Van Canneyt wrote: > Can you please create a bugreport so I will not forget ? No problem. https://bugs.freepascal.org/view.php?id=35542 Regards, Graeme ___ fpc-pascal maillist - fpc-pascal@lists.freepascal.org h

Re: [fpc-pascal] Documentation confusion or error

2019-05-08 Thread Michael Van Canneyt
On Wed, 8 May 2019, Graeme Geldenhuys wrote: Hi, https://www.freepascal.org/docs-html/rtl/sysutils/longrec.html I'm referring to the documentation shown in the URL above. As far as I know the fpdoc is sensitive to which platform it is running on (unless explicitly told otherwise), and will g

[fpc-pascal] Documentation confusion or error

2019-05-08 Thread Graeme Geldenhuys
Hi, https://www.freepascal.org/docs-html/rtl/sysutils/longrec.html I'm referring to the documentation shown in the URL above. As far as I know the fpdoc is sensitive to which platform it is running on (unless explicitly told otherwise), and will generate documentation according to that platform.

Re: [fpc-pascal] Documentation typo

2019-02-15 Thread Michael Van Canneyt
On Fri, 15 Feb 2019, Marco Borsari via fpc-pascal wrote: In the online html documentation, in the Programmer's Guide, at 1.2.4, it reads: "If it is + (the default) then the compiler will only evaluate as many terms as are necessary to determine the result of the complete expression." Obviously

[fpc-pascal] Documentation typo

2019-02-15 Thread Marco Borsari via fpc-pascal
In the online html documentation, in the Programmer's Guide, at 1.2.4, it reads: "If it is + (the default) then the compiler will only evaluate as many terms as are necessary to determine the result of the complete expression." Obviously it should be "If it is - (the default)" Regards, Marco -- Si

Re: [fpc-pascal] Documentation example error

2016-01-26 Thread Graeme Geldenhuys
On 2016-01-26 10:13, Jonas Maebe wrote: > The rttiobj unit is compiled in Delphi mode Ah, I missed that one. Thanks for pointing that out. >, hence > http://wiki.freepascal.org/User_Changes_2.6.0#Sizes_of_sets_in_TP.2FDelphi_mode Many thanks for the link. Regards, - Graeme - My public P

Re: [fpc-pascal] Documentation example error

2016-01-26 Thread Jonas Maebe
Graeme Geldenhuys wrote on Tue, 26 Jan 2016: To make the typeinfex/*.pp examples compilable, I had to make some changes as shown below. I don't hope text wrapping screws this up, but just in case, I attached the patch too. Before, it seems it was valid to typecast a Set as Integer(), but testin

Re: [fpc-pascal] Documentation example error

2016-01-26 Thread Graeme Geldenhuys
On 2016-01-25 16:32, Michael Van Canneyt wrote: > They should definitely be compilable. Complete patch attached in Mantis: http://mantis.freepascal.org/view.php?id=29513 Regards, - Graeme - -- fpGUI Toolkit - a cross-platform GUI toolkit using Free Pascal http://fpgui.sourceforge.net/ My

Re: [fpc-pascal] Documentation example error

2016-01-26 Thread Graeme Geldenhuys
On 2016-01-25 16:32, Michael Van Canneyt wrote: > > They should definitely be compilable. To make the typeinfex/*.pp examples compilable, I had to make some changes as shown below. I don't hope text wrapping screws this up, but just in case, I attached the patch too. Before, it seems it was vali

Re: [fpc-pascal] Documentation example error

2016-01-26 Thread Graeme Geldenhuys
On 2016-01-25 16:44, Stephen Chrzanowski wrote: > You could possibly just replace it with a tedit or > tlistbox or something. No, that would make the example GUI and GUI Toolkit dependant. Free Pascal doesn't include any GUI dependencies. Regards, - Graeme - -- fpGUI Toolkit - a cross-platfor

Re: [fpc-pascal] Documentation example error

2016-01-26 Thread Stephen Chrzanowski
I looked at the example, and it isn't compilable by my eye ball, however, the idea I think is to replace that not found class def'n with something you already know about. You could possibly just replace it with a tedit or tlistbox or something. On Mon, Jan 25, 2016 at 11:32 AM, Michael Van Canney

Re: [fpc-pascal] Documentation example error

2016-01-25 Thread Graeme Geldenhuys
On 2016-01-25 16:32, Michael Van Canneyt wrote: > They should definitely be compilable. OK, I found more. I'll send through a patch via Mantis. Regards, - Graeme - My public PGP key: http://tinyurl.com/graeme-pgp ___ fpc-pascal maillist - fpc-pas

Re: [fpc-pascal] Documentation example error

2016-01-25 Thread Michael Van Canneyt
On Mon, 25 Jan 2016, Graeme Geldenhuys wrote: Hi, I was always under the impression that the examples included in the FPC documentation should be compilable examples. Looking at the following example code included with the GenEnumName() documentation, it will not compile because TMyTestObjec

[fpc-pascal] Documentation example error

2016-01-25 Thread Graeme Geldenhuys
Hi, I was always under the impression that the examples included in the FPC documentation should be compilable examples. Looking at the following example code included with the GenEnumName() documentation, it will not compile because TMyTestObject is undefined. http://www.freepascal.org/docs-h

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-12 Thread Michael Van Canneyt
On Sat, 11 Jan 2014, Marco van de Voort wrote: In our previous episode, Michael Van Canneyt said: Am 2014-01-11 13:14, schrieb Michael Van Canneyt: I meant that I use a diagram typesetting package for LaTeX. This package definitely works like that. Then something is wrong with this package

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-11 Thread Marco van de Voort
In our previous episode, Michael Van Canneyt said: > > Am 2014-01-11 13:14, schrieb Michael Van Canneyt: > >> I meant that I use a diagram typesetting package for LaTeX. This package > >> definitely works like that. > > > > Then something is wrong with this package. > > Which one is it? > > listi

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-11 Thread Michael Van Canneyt
On Sat, 11 Jan 2014, Jürgen Hestermann wrote: Am 2014-01-11 13:14, schrieb Michael Van Canneyt: I meant that I use a diagram typesetting package for LaTeX. This package definitely works like that. Then something is wrong with this package. Which one is it? listings.sty I didn't write thi

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-11 Thread Jürgen Hestermann
Am 2014-01-11 13:14, schrieb Michael Van Canneyt: I meant that I use a diagram typesetting package for LaTeX. This package definitely works like that. Then something is wrong with this package. Which one is it? And as I wrote, there are diagrams which do *not* repeat the header (diagram name)

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-11 Thread Michael Van Canneyt
On Fri, 10 Jan 2014, Jürgen Hestermann wrote: Am 2014-01-10 09:09, schrieb Michael Van Canneyt: But why is the heading part of the diagram? Because that is how the typesetting mechanism for syntax diagrams work. That's not true (at least not in diagrams other than in Free Pascal). I mean

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-10 Thread Jürgen Hestermann
Am 2014-01-10 09:09, schrieb Michael Van Canneyt: >> But why is the heading part of the diagram? > Because that is how the typesetting mechanism for syntax diagrams work. That's not true (at least not in diagrams other than in Free Pascal). It is very illogical to begin a diagram with the name of

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-10 Thread Michael Van Canneyt
On Fri, 10 Jan 2014, Constantine Yannakopoulos wrote: On Thu, Jan 9, 2014 at 9:55 AM, Sven Barth wrote: Am 08.01.2014 22:01, schrieb Michael Van Canneyt: You can preview the result at http://www.freepascal.org/~michael/ref/refch3.html You might additionally men

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-10 Thread Michael Van Canneyt
On Thu, 9 Jan 2014, Jürgen Hestermann wrote: Am 2014-01-09 08:26, schrieb Michael Van Canneyt: That what should be declared is repeated in the declaration itself which makes no sense to me. A syntax diagram for 'type declaration' (which is written in the heading already) The heading is a c

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-09 Thread Sven Barth
On 10.01.2014 00:32, Constantine Yannakopoulos wrote: On Thu, Jan 9, 2014 at 9:55 AM, Sven Barth mailto:pascaldra...@googlemail.com>> wrote: Am 08.01.2014 22:01, schrieb Michael Van Canneyt: You can preview the result at http://www.freepascal.org/~__michael/ref/refch3.html

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-09 Thread Constantine Yannakopoulos
On Thu, Jan 9, 2014 at 9:55 AM, Sven Barth wrote: > Am 08.01.2014 22:01, schrieb Michael Van Canneyt: > > You can preview the result at >> >> http://www.freepascal.org/~michael/ref/refch3.html >> > You might additionally mention that these type aliases also allow > different operator and (AFAIK a

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-09 Thread Jürgen Hestermann
Am 2014-01-09 08:26, schrieb Michael Van Canneyt: >> That what should be declared is repeated in the declaration >> itself which makes no sense to me. >> A syntax diagram for 'type declaration' (which is written in the heading already) > The heading is a caption. > In typesetting, normally that i

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-09 Thread Michael Van Canneyt
On Thu, 9 Jan 2014, Sven Barth wrote: Am 08.01.2014 22:01, schrieb Michael Van Canneyt: You can preview the result at http://www.freepascal.org/~michael/ref/refch3.html You might additionally mention that these type aliases also allow different operator and (AFAIK also) function overloads.

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-08 Thread Sven Barth
Am 08.01.2014 22:01, schrieb Michael Van Canneyt: You can preview the result at http://www.freepascal.org/~michael/ref/refch3.html You might additionally mention that these type aliases also allow different operator and (AFAIK also) function overloads. Regards, Sven __

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-08 Thread Michael Van Canneyt
On Thu, 9 Jan 2014, Jürgen Hestermann wrote: Am 2014-01-08 21:12, schrieb Sven Barth: I don’t know whether the first 'type' is the standard type definition entry keyword but if so it should be typed in bold font. No, it's not the keyword, it's a "reference" to the syntax diagram named "type"

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-08 Thread Sven Barth
On 09.01.2014 07:22, Jürgen Hestermann wrote: >> Where can I find the documentation for my original question about the double TYPE keyword? > This link explains it a bit: http://docwiki.embarcadero.com/RADStudio/XE5/en/Type_Compatibility_and_Identity But that's not part of the Free Pascal doc

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-08 Thread Jürgen Hestermann
Am 2014-01-08 21:12, schrieb Sven Barth: >> I don’t know whether the first 'type' is the standard type definition >> entry keyword but if so it should be typed in bold font. > No, it's not the keyword, it's a "reference" to the syntax diagram named > "type" directly below it (though I have to admi

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-08 Thread Sven Barth
Am 08.01.2014 22:11 schrieb "Jürgen Hestermann" : > But why is it not part of the documentation? We are all just human beings that make mistakes. Nobody is perfect and so is the documentation. > If nobody takes care of the documentation anymore > then it should better be removed at all. It's act

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-08 Thread Michael Van Canneyt
On Wed, 8 Jan 2014, Jürgen Hestermann wrote: Am 08.01.2014 21:01, schrieb Sven Barth: No, an alias would be === code begin === type Real = Double; === code end === Using the "type" behind the "=" tells the compiler to declare a new type based on the right side. So a "Double" and a "Real"

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-08 Thread Jürgen Hestermann
Am 08.01.2014 21:01, schrieb Sven Barth: > No, an alias would be > === code begin === > type > Real = Double; > === code end === > Using the "type" behind the "=" tells the compiler to declare a new type based on the right side. > So a "Double" and a "Real" are not assignment compatible and can

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-08 Thread Michael Van Canneyt
On Wed, 8 Jan 2014, Howard Page-Clark wrote: On 08/01/2014 20:01, Sven Barth wrote: On 08.01.2014 19:40, Howard Page-Clark wrote: On 08/01/2014 18:16, Jürgen Hestermann wrote: Today I found this type definition in some FreePascal sources: TypeReal =type Double; I wondered what the second

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-08 Thread Michael Van Canneyt
On Wed, 8 Jan 2014, Jürgen Hestermann wrote: Today I found this type definition in some FreePascal sources: TypeReal =type Double; I wondered what the second “type” keyword means here (I have never seen this before). So I looked at http://www.freepascal.org/docs-html/ref/refch3.html#re

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-08 Thread Howard Page-Clark
On 08/01/2014 20:01, Sven Barth wrote: On 08.01.2014 19:40, Howard Page-Clark wrote: On 08/01/2014 18:16, Jürgen Hestermann wrote: Today I found this type definition in some FreePascal sources: TypeReal =type Double; I wondered what the second “type” keyword means here (I have never seen thi

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-08 Thread Sven Barth
On 08.01.2014 19:16, Jürgen Hestermann wrote: Today I found this type definition in some FreePascal sources: TypeReal =type Double; I wondered what the second “type” keyword means here (I have never seen this before). So I looked at http://www.freepascal.org/docs-html/ref/refch3.html#refse17

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-08 Thread Sven Barth
On 08.01.2014 19:40, Howard Page-Clark wrote: On 08/01/2014 18:16, Jürgen Hestermann wrote: Today I found this type definition in some FreePascal sources: TypeReal =type Double; I wondered what the second “type” keyword means here (I have never seen this before). You are being rather obtuse

Re: [fpc-pascal] Documentation, syntax diagrams

2014-01-08 Thread Howard Page-Clark
On 08/01/2014 18:16, Jürgen Hestermann wrote: Today I found this type definition in some FreePascal sources: TypeReal =type Double; I wondered what the second “type” keyword means here (I have never seen this before). You are being rather obtuse. Ignore the diagrams in the docs if they don't

[fpc-pascal] Documentation, syntax diagrams

2014-01-08 Thread Jürgen Hestermann
Today I found this type definition in some FreePascal sources:   Type  Real  =   type Double;   I wondered what

[fpc-pascal] Documentation site: incorrect manual name

2013-05-16 Thread Reinier Olislagers
On http://www.freepascal.org/docs-html/ I find FCL (Free Class Library) reference manual. however the doc itself (and the 2.6 PDF) specifies Free Component Library Could this be changed on the site? Does this need to be changed in Lazarus default online help settings as well? Thanks, Reinier ___

Re: [fpc-pascal] Documentation

2012-12-22 Thread dev . dliw
> Well, I have planned a inline-to-external conversion for fpdoc for exactly > this reason. That's nice to hear... [Sorry for late reply] d.l.l.i.w ___ fpc-pascal maillist - fpc-pascal@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/f

Re: [fpc-pascal] Documentation

2012-12-18 Thread Graeme Geldenhuys
On 18/12/12 01:25, luciano de souza wrote: > But my question is: FPDoc can be used without > an IDE? Yes, fpdoc is a command line tool, just the fpc (The free pascal compiler). Some get confused between the fpdoc program, and the FPDoc Editor (add-on) included within Lazarus IDE. The latter is us

Re: [fpc-pascal] Documentation

2012-12-17 Thread luciano de souza
I have never used FPDoc, but I'd like to understand how it would work in my specific case. I am blind. I use screen reader. I compile my projects without the intervenience of an IDE. No Lazarus, No FPC console ID, I compile my projects with commands like that: fpc myprog.pp If Myprog.pp has the P

Re: [fpc-pascal] Documentation

2012-12-17 Thread Graeme Geldenhuys
On 17/12/12 21:45, Mattias Gaertner wrote: > > I thought that was fixed? OK, my apologies for the false alarm. The XML generation seems fixed now. There are other issues with the FPDoc Editor dialog though. Off the top of my head: - It allows you to enter long descriptions for method arguments

Re: [fpc-pascal] Documentation

2012-12-17 Thread Graeme Geldenhuys
On 17/12/12 21:45, Mattias Gaertner wrote: > > I thought that was fixed? Umm, I'll have to double check. Regards, - Graeme - -- fpGUI Toolkit - a cross-platform GUI toolkit using Free Pascal http://fpgui.sourceforge.net/ ___ fpc-pascal maillist

Re: [fpc-pascal] Documentation

2012-12-17 Thread Mattias Gaertner
On Mon, 17 Dec 2012 20:44:08 + Graeme Geldenhuys wrote: > On 17/12/12 17:57, dev.d...@gmail.com wrote: > > > > Btw. I really like the lazarus fpdoc GUI... > > Compared to Documentation Insight (a Delphi IDE add-on), the UI of FPDoc > Editor has a lot to be desired for. Plus the fact that FP

Re: [fpc-pascal] Documentation

2012-12-17 Thread Graeme Geldenhuys
On 17/12/12 17:57, dev.d...@gmail.com wrote: > > Btw. I really like the lazarus fpdoc GUI... Compared to Documentation Insight (a Delphi IDE add-on), the UI of FPDoc Editor has a lot to be desired for. Plus the fact that FPDoc Editor generates undesired formatted XML for fpdoc is not so nice. Th

Re: [fpc-pascal] Documentation

2012-12-17 Thread Michael Van Canneyt
On Mon, 17 Dec 2012, dev.d...@gmail.com wrote: Hi, as the question whether inline or external source docs are the way to go (again?) came up, here are my thoughts (currently searching for the "best" solution :) ): I personally prefer external docs (and thus started to use fpdoc); reasons are

[fpc-pascal] Documentation

2012-12-17 Thread dev . dliw
Hi, as the question whether inline or external source docs are the way to go (again?) came up, here are my thoughts (currently searching for the "best" solution :) ): I personally prefer external docs (and thus started to use fpdoc); reasons are uncluttered source, less scrolling and (if you str

Re: [fpc-pascal] Documentation differences...

2010-06-23 Thread Marco van de Voort
In our previous episode, Graeme Geldenhuys said: > Ah, it seems Lazarus is using the broken 'fpdoc' to generate the > online help. fpdoc recently fails to generate docs for most units > because of various changes in the source parses (fcl-passrc) that it > uses. I had the same problem generating t

Re: [fpc-pascal] Documentation differences...

2010-06-23 Thread Graeme Geldenhuys
On 23 June 2010 10:40, Torsten Bonde Christiansen wrote: > > From what i can see Lazarus (trunk version) does by default open the Lazarus > CCR version of the documentation file, this was my main reason for asking on > the list since TComponent does not exists in the CCR version. Ah, it seems Laz

Re: [fpc-pascal] Documentation differences...

2010-06-23 Thread Torsten Bonde Christiansen
On 2010-06-23 10:29, Graeme Geldenhuys wrote: Op 2010-06-23 10:15, Torsten Bonde Christiansen het geskryf: The official FPC documentation is: (http://www.freepascal.org/docs-html/rtl/) FPC does not show "skeleton" or partial documented units in it's documentation. It is all or nothi

Re: [fpc-pascal] Documentation differences...

2010-06-23 Thread Graeme Geldenhuys
Op 2010-06-23 10:15, Torsten Bonde Christiansen het geskryf: The official FPC documentation is: > (http://www.freepascal.org/docs-html/rtl/) FPC does not show "skeleton" or partial documented units in it's documentation. It is all or nothing. > (http://lazarus-ccr.sourceforge.net/docs/rtl/)

Re: [fpc-pascal] Documentation differences...

2010-06-23 Thread Michael Van Canneyt
On Wed, 23 Jun 2010, Torsten Bonde Christiansen wrote: Hi List. I have been wondering for some time now what the difference is between the source documentation (online versions) on the pascal website (http://www.freepascal.org/docs-html/rtl/) and the one placed on the Lazarus CCR website (

[fpc-pascal] Documentation differences...

2010-06-23 Thread Torsten Bonde Christiansen
Hi List. I have been wondering for some time now what the difference is between the source documentation (online versions) on the pascal website (http://www.freepascal.org/docs-html/rtl/) and the one placed on the Lazarus CCR website (http://lazarus-ccr.sourceforge.net/docs/rtl/) - this goes

Re: [fpc-pascal] Documentation strangeness

2010-04-05 Thread Graeme Geldenhuys
On 5 April 2010 21:26, John Coppens wrote: > > I'm sure the selection of IPF/INF caused some discussion at the time, > particularly at a time where xml is the magic recipe for everything ;-) As Marco said, the class documentation is in XML and gets transformed to other "final" formats via the 'fpd

Re: [fpc-pascal] Documentation strangeness

2010-04-05 Thread Marco van de Voort
In our previous episode, John Coppens said: > Graeme Geldenhuys wrote: > > > Wikipedia has some information on IPF. > > http://en.wikipedia.org/wiki/Information_Presentation_Facility > > Thanks for the extensive answer, Graeme! > > I'm sure the selection of IPF/INF caused some discussion at t

Re: [fpc-pascal] Documentation strangeness

2010-04-05 Thread John Coppens
On Mon, 5 Apr 2010 17:25:44 +0200 Graeme Geldenhuys wrote: > Wikipedia has some information on IPF. > http://en.wikipedia.org/wiki/Information_Presentation_Facility Thanks for the extensive answer, Graeme! I'm sure the selection of IPF/INF caused some discussion at the time, particularly at a

Re: [fpc-pascal] Documentation strangeness

2010-04-05 Thread Graeme Geldenhuys
On 5 April 2010 16:19, John Coppens wrote: > > Sorry for my ignorance - what are INF files? Google seems confused too. INF files are compiled (binary) IPF [Information Presentation Facility] help files. It is the help file and digital document format originally created by IBM for the OS/2 operati

Re: [fpc-pascal] Documentation strangeness

2010-04-05 Thread John Coppens
On Mon, 5 Apr 2010 00:07:07 +0200 Graeme Geldenhuys wrote: > Luckily (no offence meant) the documentation doesn't change that much > or that quickly. I'll probably keep to the same release cycle as FPC - > whenever a new FPC is released, release new FPC INF docs too. Hi Graeme, Sorry for my ign

Re: [fpc-pascal] Documentation strangeness

2010-04-05 Thread Graeme Geldenhuys
On 05/04/2010, Michael Van Canneyt wrote: >> Yes, it's still on my todo list. > > One day, you should publish this list. :-) By the sounds of things, I don't think your list is going to be much smaller than mine. ;-) -- Regards, - Graeme - ___ fpG

Re: [fpc-pascal] Documentation strangeness

2010-04-05 Thread Michael Van Canneyt
On Mon, 5 Apr 2010, Graeme Geldenhuys wrote: On 4 April 2010 18:21, Michael Van Canneyt wrote: The disadvantage being that they are not updated when the documentation is updated. Luckily (no offence meant) the documentation doesn't change that much or that quickly. I'll probably keep to t

Re: [fpc-pascal] Documentation strangeness

2010-04-04 Thread Graeme Geldenhuys
On 4 April 2010 18:21, Michael Van Canneyt wrote: > > The disadvantage being that they are not updated when the documentation > is updated. Luckily (no offence meant) the documentation doesn't change that much or that quickly. I'll probably keep to the same release cycle as FPC - whenever a new F

Re: [fpc-pascal] Documentation strangeness

2010-04-04 Thread Michael Van Canneyt
On Sun, 4 Apr 2010, Graeme Geldenhuys wrote: On 4 April 2010 12:11, Michael Van Canneyt wrote: That depends on the PDF reader. Searching is virtually instantaneous on Mac OS X with its default PDF reader (but it's indeed fairly slow with at least Acrobat Reader). I guess Mac has better PD

Re: [fpc-pascal] Documentation strangeness

2010-04-04 Thread Graeme Geldenhuys
On 4 April 2010 12:11, Michael Van Canneyt wrote: >> >> That depends on the PDF reader. Searching is virtually instantaneous on >> Mac OS X with its default PDF reader (but it's indeed fairly slow with at >> least Acrobat Reader). I guess Mac has better PDF support than any other platform. Acroba

Re: [fpc-pascal] Documentation strangeness

2010-04-04 Thread Graeme Geldenhuys
On 4 April 2010 12:24, Michael Van Canneyt wrote: > > The community version ("with comments") should be simply deleted; it causes > only confusion and more work without any benefit. +1 for the confusion bit. > I have removed the links to them. A good decision. -- Regards, - Graeme - ___

Re: [fpc-pascal] Documentation strangeness

2010-04-04 Thread John Coppens
On Sun, 4 Apr 2010 12:24:36 +0200 (CEST) Michael Van Canneyt wrote: > The community version ("with comments") should be simply deleted; > it causes only confusion and more work without any benefit. > > I have removed the links to them. Proof of concept: I hadn't found the 'good' one - just the

Re: [fpc-pascal] Documentation strangeness

2010-04-04 Thread Michael Van Canneyt
On Sun, 4 Apr 2010, John Coppens wrote: On Sat, 3 Apr 2010 20:36:56 +0200 (CEST) mar...@stack.nl (Marco van de Voort) wrote: The refered documentation (on the FPC community server) is from 2006: Reference guide for Free Pascal, version 2.2 Document version 2.0 August 2006 Yep... But that

Re: [fpc-pascal] Documentation strangeness

2010-04-04 Thread Michael Van Canneyt
On Sun, 4 Apr 2010, Jonas Maebe wrote: On 03 Apr 2010, at 22:48, Graeme Geldenhuys wrote: I must agree. PDF's looks good on paper, but is terrible to search on screen (very slow) That depends on the PDF reader. Searching is virtually instantaneous on Mac OS X with its default PDF reader

Re: [fpc-pascal] Documentation strangeness

2010-04-03 Thread John Coppens
On Sat, 3 Apr 2010 20:36:56 +0200 (CEST) mar...@stack.nl (Marco van de Voort) wrote: > The refered documentation (on the FPC community server) is from 2006: > > Reference guide for Free Pascal, version 2.2 > Document version 2.0 > August 2006 Yep... But that is the manual which is on-line at the

Re: [fpc-pascal] Documentation strangeness

2010-04-03 Thread Jonas Maebe
On 03 Apr 2010, at 22:48, Graeme Geldenhuys wrote: > I must agree. PDF's looks good on paper, but is terrible to search on > screen (very slow) That depends on the PDF reader. Searching is virtually instantaneous on Mac OS X with its default PDF reader (but it's indeed fairly slow with at least

Re: [fpc-pascal] Documentation strangeness

2010-04-03 Thread Graeme Geldenhuys
On 3 April 2010 20:36, Marco van de Voort wrote: > > The PDF is mostly good for printing, nothing else. I must agree. PDF's looks good on paper, but is terrible to search on screen (very slow), hyperlinks/cross-linking is not always available, no context sensitive help integration from IDE's etc.

Re: [fpc-pascal] Documentation strangeness

2010-04-03 Thread Marco van de Voort
In our previous episode, Michael Van Canneyt said: > > http://sayamindu.randomink.org/conv_guide/ch01s02.html > > I am aware of the ligature problem; The main problem is that it requires > re-configuration of tex4ht to fix it. I did it once, maybe an update > destroyed this work :/ The refered

Re: [fpc-pascal] Documentation strangeness

2010-04-03 Thread Graeme Geldenhuys
On 3 April 2010 18:10, Michael Van Canneyt wrote: > > The good news is that the PDF documentation is correct, and > is still - as it always been - the preferred format. On a side note: The INF version of the Language Reference is also correct. Just a few more sections to complete, then I'll make

Re: [fpc-pascal] Documentation strangeness

2010-04-03 Thread Michael Van Canneyt
On Sat, 3 Apr 2010, Graeme Geldenhuys wrote: On 3 April 2010 17:33, John Coppens wrote: I was using the Pascal reference manual, and found that 'fi' was replaced by some strange character... Modifiers came out as Modi???ers etc. This seems to have happened all over the document at: Clearl

Re: [fpc-pascal] Documentation strangeness

2010-04-03 Thread Graeme Geldenhuys
On 3 April 2010 17:33, John Coppens wrote: > > I was using the Pascal reference manual, and found that 'fi' was replaced > by some strange character... Modifiers came out as Modi�ers etc. This > seems to have happened all over the document at: Clearly the export as HTML from LaTeX doesn't support

[fpc-pascal] Documentation strangeness

2010-04-03 Thread John Coppens
Hi people, I was using the Pascal reference manual, and found that 'fi' was replaced by some strange character... Modifiers came out as Modi�ers etc. This seems to have happened all over the document at: http://community.freepascal.org:1/docs-html/ref/ref.html This is just a little frustrati

[fpc-pascal] Documentation for the UTF-8 Functions

2009-06-09 Thread David B Copeland
Can anyone point me to where the utf-8 functions are documented? I have tried looking in the docs for the RTL but could not find them. Thanks, Dave. ___ fpc-pascal maillist - fpc-pascal@lists.freepascal.org http://lists.freepascal.org/mailman/listin

Re: [fpc-pascal] Documentation and posts suggestions [LONG]

2009-03-16 Thread Michael Van Canneyt
On Sun, 15 Mar 2009, Francisco Reyes wrote: > Tomas Hajny writes: > > > I'm not sure if Francisco meant the Reference Guide or possibly some > > examples appearing in the other documents; > > I was looking specifically about the rtl pdf. > > > >if it's the latter, a more concrete example wou

Re: [fpc-pascal] Documentation and posts suggestions [LONG]

2009-03-16 Thread Michael Van Canneyt
On Sun, 15 Mar 2009, Tomas Hajny wrote: > > > * In cases were some code needs a particular mode other than the default > > > mode > > > we can include which mode is needed. > > > > There is no need for this: Classes and exception handling always need mode > > objfpc > > or Delphi. Regular fu

Re: [fpc-pascal] Documentation and posts suggestions [LONG]

2009-03-15 Thread Jonas Maebe
On 15 Mar 2009, at 23:20, Francisco Reyes wrote: Michael Van Canneyt writes: or Delphi. Regular functions do not need a mode at all. This is a simple rule, which can easily be remembered, no ? If those are the only two cases sure, but if there are other instances that may suffer from the

Re: [fpc-pascal] Documentation and posts suggestions [LONG]

2009-03-15 Thread Francisco Reyes
Tomas Hajny writes: I'm not sure if Francisco meant the Reference Guide or possibly some examples appearing in the other documents; I was looking specifically about the rtl pdf. if it's the latter, a more concrete example would be probably useful. Where are the examples? I recall seem the

  1   2   >