[fpc-pascal] The names of the various FPC documentation
Graeme Geldenhuys
graemeg at opensoft.homeip.net
Mon Sep 7 08:53:53 CEST 2009
Hi,
Maybe it's just me (please let me know if it is), but looking at the
various FPC .pdf files in a folder, I am never sure which one I should
open for whatever I am looking for.
We currently have:
ref.pdf
user.pdf
rtl.pdf
prog.pdf
fcl.pdf
fpdoc.pdf
Out of those 3 seems to have logical names. rtl, fcl and fpdoc. The
problem I have is the 'user', 'ref' and 'prog' names. Maybe somebody
can explain to me how I can remember the various information in each of
these. For example, if I want to know about a Compiler Parameter, or a
Language syntax, it is never clear which document I should open.
Now seeing that all (half-descent) OSes support long filenames these
days, couldn't we name them better.
For example:
ref.pdf is actually about the Object Pascal Language. So why not name
it Language_Reference_Guide.pdf or Language_Guide.pdf?
prog.pdf is actually about the compiler support options like
parameters etc... So name this Free_Pascal_Compiler_Guide.pdf
user.pdf is actually and installation guide. So why not name
it FPC_Installation_Guide.pdf
Yes I know I can rename them locally, but I also thing it makes sense to
give the documents better "default" names than ref, prog, user.
Just my 2c worth!
Regards,
- Graeme -
--
fpGUI Toolkit - a cross-platform GUI toolkit using Free Pascal
http://opensoft.homeip.net/fpgui/
More information about the fpc-pascal
mailing list