Sign in Join

Live chat for Free Pascal, Lazarus, Delphi and every Pascal programmer.

Mailing lists / fpc-pascal / 2013-05

Moving packages\fcl-res docs to main fpcdocs?

6 messages · 2 people · –

Reply by email Subscribe to this list Your subscription

Read-only archive. Use j and k to move between messages.

Reinier Olislagers

Noticed that fcl-res has documentation in an XML subfolder of $(fpcdir)\packages\fcl-res

Shouldn't these be moved into the general fpcdocs repository (and generated as part of the fcl docs)?
(I know that not all xml files will apply to all platforms; IMO it's easier here to indicate some doc is specific to one platform/file format and just include everything... makes devs more aware of cross-platform possibilities/issues)

Regards,
Reinier

Reply by email

Michael Van Canneyt
to Reinier Olislagers
Reinier Olislagers wrote 9 lines
Noticed that fcl-res has documentation in an XML subfolder of $(fpcdir)\packages\fcl-res Shouldn't these be moved into the general fpcdocs repository (and generated as part of the fcl docs)? (I know that not all xml files will apply to all platforms; IMO it's easier here to indicate some doc is specific to one platform/file format and just include everything... makes devs more aware of cross-platform possibilities/issues)

Their content is so sparse that I didn't (or still don't) see the need.

Michael.

Reply by email

Reinier Olislagers
to Michael Van Canneyt
Michael Van Canneyt wrote 13 lines
On Thu, 23 May 2013, Reinier Olislagers wrote: > Noticed that fcl-res has documentation in an XML subfolder of > $(fpcdir)\packages\fcl-res > > Shouldn't these be moved into the general fpcdocs repository (and > generated as part of the fcl docs)? > (I know that not all xml files will apply to all platforms; IMO it's > easier here to indicate some doc is specific to one platform/file format > and just include everything... makes devs more aware of cross-platform > possibilities/issues) Their content is so sparse that I didn't (or still don't) see the need.

Not going to reply, a bit too flabbergasted.

Reply by email

Michael Van Canneyt
to Reinier Olislagers
Reinier Olislagers wrote 16 lines
On 23-5-2013 13:18, Michael Van Canneyt wrote: > On Thu, 23 May 2013, Reinier Olislagers wrote: > >> Noticed that fcl-res has documentation in an XML subfolder of >> $(fpcdir)\packages\fcl-res >> >> Shouldn't these be moved into the general fpcdocs repository (and >> generated as part of the fcl docs)? >> (I know that not all xml files will apply to all platforms; IMO it's >> easier here to indicate some doc is specific to one platform/file format >> and just include everything... makes devs more aware of cross-platform >> possibilities/issues) > > Their content is so sparse that I didn't (or still don't) see the need. Not going to reply, a bit too flabbergasted.
Your reply made me suspicious. So I checked, you are of course right;
I don't know what package I was thinking about when sending my initial reply.

Hm. Yes, we should move it for the time being.
The original idea was that each package would have its own documentation included. fpmake can handle the build, but not yet the install.

Michael.

Reply by email

Reinier Olislagers
to Michael Van Canneyt
Michael Van Canneyt wrote 6 lines
On Thu, 23 May 2013, Reinier Olislagers wrote: > On 23-5-2013 13:18, Michael Van Canneyt wrote: Hm. Yes, we should move it for the time being. The original idea was that each package would have its own documentation included. fpmake can handle the build, but not yet the install.

Ok, that sounds good ;)

Reply by email

Reinier Olislagers
to Michael Van Canneyt: Your reply made me suspicious. So I checked, you are of course right; I don't know what…
Michael Van Canneyt wrote 9 lines
On Thu, 23 May 2013, Reinier Olislagers wrote: > On 23-5-2013 13:18, Michael Van Canneyt wrote: >> On Thu, 23 May 2013, Reinier Olislagers wrote: >> >>> Noticed that fcl-res has documentation in an XML subfolder of >>> $(fpcdir)\packages\fcl-res >>> >>> Shouldn't these be moved into the general fpcdocs repository (and >>> generated as part of the fcl docs)?

<snip>

Hm. Yes, we should move it for the time being.

Thanks.
Submitted
http://bugs.freepascal.org/view.php?id=24490
to keep track ;)

Reply by email