[fpc-pascal] Re: fpdoc executable both in bin and utils\fpdoc - but not fpdoc.css

[michael.vancanneyt at wisa.be]

On Tue, 14 Aug 2012, Reinier Olislagers wrote:

> On 14-8-2012 13:50, michael.vancanneyt-0Is9KJ9Sb0A at public.gmane.org wrote:
>>
>>
>> On Tue, 14 Aug 2012, Reinier Olislagers wrote:
>>
>>> On 14-8-2012 11:34, Marco van de Voort wrote:
>>>> In our previous episode, Reinier Olislagers said:
>>>>>> in packages\fcl-res\xml) but not in the bin directory.
>>>>>>
>>>>>> IIRC, fpdoc picks up fpdoc.css when generating HTML/CHM output.
>>>>>> Shouldn't fpdoc.css be also present under the bin directory then?
>>>>>>
>>>>>> Thanks,
>>>>>> Reinier
>>>>>>
>>>>> Bump.
>>>>>
>>>>> Any reactions?
>>>>
>>>> The scripts that generate have their own locations set to the fpdoc.css
>>>>
>>>> Since generating docs requires additional repositories (like fpcdoc),
>>>> it is
>>>> not a standard feature of installs anyway.
>>> True for fpc source docs...
>>>
>>> So you're saying FPC users who don't have the source installed (e.g. on
>>> Debian) should get the source, download fpdoc.css separately or create
>>> their own if they want to generate HTML documentation of their own code.
>>> Doesn't seem user friendly.
>>
>> There is no discussion that fpdoc.css should be distributed.
> Yes, you told me. I'm asking because I'm not sure what Marco wanted (and
> anybody else).
>
>> The only question is: where should we put it ?
> Apparently the bin directory is not satisfactory (though I don't see why)?

2 reasons:

1. I do not think you should put such files there. I know that there are
    some historic reasons for putting some 'extra' things there, but I
    think we should change that DOS habit.

2. fpdoc.exe will not search it there. By putting it there you will create the
    expectation that it will search for it there (as some of the other utils do),
    but it will not.

> On my Laz install (installed by Win installer) I only have bin,msg,units
> under the fpc directory.
> Perhaps there are others in other versions...
>
> What about the fpc root directory then?

I think it is better to have it in fpc/docs.

Michael.