On 14-8-2012 10:31, michael.vancann...@wisa.be wrote: > On Tue, 14 Aug 2012, Reinier Olislagers wrote: >> On 14-8-2012 9:46, michael.vancann...@wisa.be wrote: >>> On Tue, 14 Aug 2012, Reinier Olislagers wrote: >>>> On 12-8-2012 10:35, Reinier Olislagers wrote: >>>>> In my (Windows) SVN fpc installs, I can find the fpdoc executable both >>>>> under the bin directory as well as utils\fpdoc >>>>> >>>>> However, I've only found fpdoc.css in utils\fpdoc (and a different one >>>>> 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? >>> >>> No. You're responsible for putting this file wherever it needs to be >>> put. >>> >> Fine, I understand that, but what is fpdoc then doing in the bin >> directory? > > The binary ? Where would you put it if not in bin ? Sure, sure, but my point was the connection between fpdoc.css and fpdoc.exe... Not that important, please see below.
> The fpdoc system uses a fpdoc.css file for style. We provide one which > can be used, but you are under no obligation to use that file. You can > perfectly create one from scratch, or adapt the existing one. > Since we do not know what you want to do, we do not 'automagically' copy > it to the output. The following is meant as constructive advice, not criticism: Very well, how many people do you think use fpdoc *and* customize fpdoc.css? Even then, copying fpdoc.css to the bin directory would give a sensible default, no? If people want to customize it, replace it etc they can then always do so. If you want your fpdoc.exe usable from the bin directory, I'd just copy over fpdoc.css during install. Now we've got 2 different behaviours: - fpdoc in the source directory has fpdoc.css and will generate chm/html files with it - fpdoc in the bin directory doesn't have it. In my view this difference in behaviour is unnecessary and only server to needlessly further increase the complexity of the fpdoc system... Thanks, Reinier _______________________________________________ fpc-pascal maillist - fpc-pascal@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-pascal
