[fpc-pascal] Should FCL documentation be splitted?

2012-07-05 Thread leledumbo
I would like to document some of the FCL, however the layout is still like
the first time it appears in FPC. Current FCL are splitted into many
subpackages, and since the number of units is HUGE (which I guess the same
reason why the package was splitted) would it be better to split the
documentation as well?

--
View this message in context: 
http://free-pascal-general.1045716.n5.nabble.com/Should-FCL-documentation-be-splitted-tp5710248.html
Sent from the Free Pascal - General mailing list archive at Nabble.com.
___
fpc-pascal maillist  -  fpc-pascal@lists.freepascal.org
http://lists.freepascal.org/mailman/listinfo/fpc-pascal


Re: [fpc-pascal] Should FCL documentation be splitted?

2012-07-05 Thread michael . vancanneyt



On Thu, 5 Jul 2012, leledumbo wrote:


I would like to document some of the FCL, however the layout is still like
the first time it appears in FPC. Current FCL are splitted into many
subpackages, and since the number of units is HUGE (which I guess the same
reason why the package was splitted) would it be better to split the
documentation as well?


No, it's better to keep it together:
1. to have an overview of what is available.
2. cross-referencing across packages in documentation is not easy.

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