On Mon, 7 Sep 2009, Graeme Geldenhuys wrote:
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.
If there is a more or less consensus about such things, I don't see why
we couldn't rename them.
The names actually stem from the TP documentation, which was divided into 3
books:
Language Reference
User's manual
Programmer's manual
Michael.
_______________________________________________
fpc-pascal maillist - fpc-pascal@lists.freepascal.org
http://lists.freepascal.org/mailman/listinfo/fpc-pascal
