[fpc-pascal] fpdoc questions
L505
fpc505 at z505.com
Mon Jul 4 18:40:13 CEST 2005
|
| Normally, relative paths should work. Try using ./system.pp
Yes that worked on linux. Well, I'll try some things on win32 .. not sure what
the equivilent of ./ is on windows.
is there a:
.\
on windows?
| That is one of the principal reasons why fpdoc was developed:
| strict separation of sources and documentation.
| Sources with _serious_ documentation embedded are not really easy to browse or
maintain.
|
Yes I agree. it seems to be a temptation to want to place the docs right in the
source for some people. All one has to do is open up a text editor along side of
the source code, and document it side by side. If one was ambitious enough, a
program could be created so that the descriptor file automatically opened up
when a source code unit was opened.
The only way I see embedded source as a possible solution is if the IDE has a
switch or setting on it where you can turn off or hide all the embedded
documentation. But I'd still rather keep it separate, because that would just
add more bloat to the IDE code.
More information about the fpc-pascal
mailing list