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