[fpc-pascal] Re: fpdoc executable both in bin and utils\fpdoc - but not fpdoc.css
Tomas Hajny
XHajT03 at hajny.biz
Wed Aug 15 09:19:14 CEST 2012
On Wed, August 15, 2012 04:07, waldo kitty wrote:
> On 8/14/2012 09:47, michael.vancanneyt at wisa.be wrote:
>> On Tue, 14 Aug 2012, Tomas Hajny wrote:
>>> Actually, the file is more a configuration file for fpdoc than its
>>> documentation, isn't it? From this point of view, shouldn't
>>> SysUtils.GetAppConfigDir serve as the most reasonable location?
>>
>> It is definitely not a config file. It is a file that must be copied to
>> every project you want to document with fpdoc.
>
> does that include FPC itself?
>
> it seems to me that folks questioning this install problem are talking
> specifically about fpc documenting itself and where this file needs to be
> for
> the fpc documentation to work and look proper in an out of the box
> installation
> whether that is from some sort of installation program thing or whether it
> is
> via downloading the sources from SVN and building them with the make
> system...
>
> the task of placing it correctly for one's own projects is another matter
> completely...
Please, re-read the thread. The "folks questioning this install problem"
have explicitly been mentioning the use for documentation generation using
the fpdoc tool, not issues with reading FPC docs in HTML format (which do
include the file, but not all fpdoc users need to have FPC docs installed
or use their HTML version plus they wouldn't know that they should refer
to the docs directory for the CSS file when invoking fpdoc even if it is
there for the HTML documentation reading).
Tomas
More information about the fpc-pascal
mailing list