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?
Mailing lists / fpc-pascal / 2012-07
Should FCL documentation be splitted?
6 messages · 3 people · –
- Lleledumbo 3
- RReinier Olislagers 2
- UUnknown author 1
Reply by email Subscribe to this list Your subscription
Read-only archive. Use j and k to move between messages.
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 .
leledumbo wrote 5 lines
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.
OK, I'll keep it that way.
View this message in context: http://free-pascal-general.1045716.n5.nabble.com/Should-FCL-documentation-be-splitted-tp5710248p5710250.html
Sent from the Free Pascal - General mailing list .
I would like to document some of the FCL, however the layout is still like the first time…
leledumbo wroteI would like to document some of the FCL,
... if that work includes the zip functionality in the paszlib unit, I'm still (slowly) working on it at
https://bitbucket.org/reiniero/fpc_laz_patch_playground/src directory docs
Please feel free to use it ;)
If not, I'll keep on adding missing data until I'm done and submit it...
No, I only want to (and am capable to) document FCL :p
View this message in context: http://free-pascal-general.1045716.n5.nabble.com/Should-FCL-documentation-be-splitted-tp5710248p5710252.html
Sent from the Free Pascal - General mailing list .
leledumbo wroteNo, I only want to (and am capable to) document FCL :p
Mmm yes, I thought paszlib was part of the FCL ;)
