Re: [fpc-pascal] Where and how is the FPC documentation created?

2012-02-29 Thread michael . vancanneyt



On Wed, 29 Feb 2012, Frank Church wrote:


A few months ago I inquired and got some info about FPC docs - discussed in
this thread
http://lists.lazarus.freepascal.org/pipermail/lazarus/2011-November/068595.html,
the result of which can be found here - http://fpdocs.rca2.net and here  -
http://fpdocs.rca2.net/user/user.html, when FPC was at 2.4.4

When I visit the source page
http://www.freepascal.org/docs-html/user/user.html it is not on 2.6.0.

1. Are the created by a tool or hand edited?


Depends on what you mean. The docs are made by hand. When we make a release,
we manually upload the new version.



2. Is there some page where the original docs are created?


No.



3. Are they text files that are stored under version control?


Yes.



4. Is there some page where previous versions are available?


No.



PS. After some searching questions 2, 3 and 4 are answered -
http://svn.freepascal.org/svn/fpcdocs/.

One more thing is there some other page where the commit messages for the
files are noted? I can only see plain text.


No.

Michael.
___
fpc-pascal maillist  -  fpc-pascal@lists.freepascal.org
http://lists.freepascal.org/mailman/listinfo/fpc-pascal


Re: [fpc-pascal] Where and how is the FPC documentation created?

2012-02-29 Thread Tomas Hajny
On Wed, February 29, 2012 16:44, michael.vancann...@wisa.be wrote:
 On Wed, 29 Feb 2012, Frank Church wrote:

 A few months ago I inquired and got some info about FPC docs - discussed
 in
 this thread
 http://lists.lazarus.freepascal.org/pipermail/lazarus/2011-November/068595.html,
 the result of which can be found here - http://fpdocs.rca2.net and here
 -
 http://fpdocs.rca2.net/user/user.html, when FPC was at 2.4.4

 When I visit the source page
 http://www.freepascal.org/docs-html/user/user.html it is not on 2.6.0.
 .
 .
 4. Is there some page where previous versions are available?

 No.

To amend Michael's answer a bit - previous releases of the compiled
documentation are obviously available for download in the standard way and
the source files for the documentation can be accessed via the SVN
repository in a standard way to check for differences to some older
revisions.

Tomas


___
fpc-pascal maillist  -  fpc-pascal@lists.freepascal.org
http://lists.freepascal.org/mailman/listinfo/fpc-pascal


Re: [fpc-pascal] Where and how is the FPC documentation created?

2012-02-29 Thread Frank Church
On 29 February 2012 15:44, michael.vancann...@wisa.be wrote:



 On Wed, 29 Feb 2012, Frank Church wrote:

  A few months ago I inquired and got some info about FPC docs - discussed
 in
 this thread
 http://lists.lazarus.**freepascal.org/pipermail/**
 lazarus/2011-November/068595.**htmlhttp://lists.lazarus.freepascal.org/pipermail/lazarus/2011-November/068595.html
 ,
 the result of which can be found here - http://fpdocs.rca2.net and here
  -
 http://fpdocs.rca2.net/user/**user.htmlhttp://fpdocs.rca2.net/user/user.html,
 when FPC was at 2.4.4

 When I visit the source page
 http://www.freepascal.org/**docs-html/user/user.htmlhttp://www.freepascal.org/docs-html/user/user.htmlit
  is not on 2.6.0.

 1. Are the created by a tool or hand edited?


 Depends on what you mean. The docs are made by hand. When we make a
 release,
 we manually upload the new version.



 2. Is there some page where the original docs are created?


 No.



 3. Are they text files that are stored under version control?


 Yes.



 4. Is there some page where previous versions are available?


 No.



 PS. After some searching questions 2, 3 and 4 are answered -
 http://svn.freepascal.org/svn/**fpcdocs/http://svn.freepascal.org/svn/fpcdocs/
 .

 One more thing is there some other page where the commit messages for the
 files are noted? I can only see plain text.


 No.

 Michael.
 __**_
 fpc-pascal maillist  -  
 fpc-pascal@lists.freepascal.**orgfpc-pascal@lists.freepascal.org
 http://lists.freepascal.org/**mailman/listinfo/fpc-pascalhttp://lists.freepascal.org/mailman/listinfo/fpc-pascal



I am asking because if there some changes to some of the pages because of
new language facilities etc, some features, deprecated etc commit messages
would make it easier to track what is new and what has been changed. The
pages are also not dated so it is difficult to find out what may be
pertinent in the present and what is old and perhaps little used.

Another question, are you and Florian Klaempfl the main or only
contributors? Is it open to only a few people and do you upload it for
general viewing only when it is ready? In a nutshell is it possible to non
contributors to view the changes as they are happening?

-- 
Frank Church

===
http://devblog.brahmancreations.com
___
fpc-pascal maillist  -  fpc-pascal@lists.freepascal.org
http://lists.freepascal.org/mailman/listinfo/fpc-pascal

Re: [fpc-pascal] Where and how is the FPC documentation created?

2012-02-29 Thread michael . vancanneyt



On Wed, 29 Feb 2012, Frank Church wrote:



I am asking because if there some changes to some of the pages because of
new language facilities etc, some features, deprecated etc commit messages
would make it easier to track what is new and what has been changed. The
pages are also not dated so it is difficult to find out what may be
pertinent in the present and what is old and perhaps little used.

Another question, are you and Florian Klaempfl the main or only
contributors?


I am virtually the only one, but I do receive and apply minor patches 
from time to time.



Is it open to only a few people and do you upload it for
general viewing only when it is ready? In a nutshell is it possible to non
contributors to view the changes as they are happening?


Everything is in subversion, the fpcdocs repository.

Michael.
___
fpc-pascal maillist  -  fpc-pascal@lists.freepascal.org
http://lists.freepascal.org/mailman/listinfo/fpc-pascal


Re: [fpc-pascal] Where and how is the FPC documentation created?

2012-02-29 Thread Frank Church
On 29 February 2012 16:07, michael.vancann...@wisa.be wrote:



 On Wed, 29 Feb 2012, Frank Church wrote:


 I am asking because if there some changes to some of the pages because of
 new language facilities etc, some features, deprecated etc commit messages
 would make it easier to track what is new and what has been changed. The
 pages are also not dated so it is difficult to find out what may be
 pertinent in the present and what is old and perhaps little used.

 Another question, are you and Florian Klaempfl the main or only
 contributors?


 I am virtually the only one, but I do receive and apply minor patches from
 time to time.


  Is it open to only a few people and do you upload it for
 general viewing only when it is ready? In a nutshell is it possible to non
 contributors to view the changes as they are happening?


 Everything is in subversion, the fpcdocs repository.


 Michael.
 __**_
 fpc-pascal maillist  -  
 fpc-pascal@lists.freepascal.**orgfpc-pascal@lists.freepascal.org
 http://lists.freepascal.org/**mailman/listinfo/fpc-pascalhttp://lists.freepascal.org/mailman/listinfo/fpc-pascal



So it means that if I want to check on updates I have to download the
repository and link it with something like ViewVC or ViewSVN?

How often do you update it?




-- 
Frank Church

===
http://devblog.brahmancreations.com
___
fpc-pascal maillist  -  fpc-pascal@lists.freepascal.org
http://lists.freepascal.org/mailman/listinfo/fpc-pascal

Re: [fpc-pascal] Where and how is the FPC documentation created?

2012-02-29 Thread Vincent Snijders
Op 29 februari 2012 16:29 heeft Frank Church vfcli...@gmail.com het
volgende geschreven:
 4. Is there some page where previous versions are available?

 PS. After some searching questions 2, 3 and 4 are answered -
 http://svn.freepascal.org/svn/fpcdocs/.

or: http://svn.freepascal.org/cgi-bin/viewvc.cgi/?root=docs

Vincent
___
fpc-pascal maillist  -  fpc-pascal@lists.freepascal.org
http://lists.freepascal.org/mailman/listinfo/fpc-pascal


Re: [fpc-pascal] Where and how is the FPC documentation created?

2012-02-29 Thread Vincent Snijders
Op 29 februari 2012 18:57 heeft Frank Church vfcli...@gmail.com het
volgende geschreven:

 How often do you update it?

See:
http://svn.freepascal.org/svn/logs/fpcdocs-trunk.log

(also available with viewvc).

Vincent
___
fpc-pascal maillist  -  fpc-pascal@lists.freepascal.org
http://lists.freepascal.org/mailman/listinfo/fpc-pascal