Tue 07 Jan 2014 06:54:56 AM UTC, comment #4:
> First, "thank you" for closing this bug before even discussing it.
> Such ignorance is the best way to shy bug reporters away.
> It takes quite some time to report quality bugs, after all.
Thanks for that … the report was quite clear enough for me not to need to ask more about it; both easy to see that it was invalid, and easy to see how the confusion arose and do something to prevent that in future.
> Looking at Documentation/GNUmakefile line 37ff, the case of installing
> documentation without having -make installed is explicitely handled.
Do you mean the bit that said?
> Please note that "make install" will install into our temporary gnustep-make directory, which is usually not particularly useful,
When I read it in context yesterday it was clear, but not as good as explicitly saying that you have to have gnustep-make installed before you can use it to build and install documentation.
> And this is a very important feature. Because when packaging stuff for
> distribution, there is no way to install parts of a package before
> building the other parts.
That would appear to be a different issue.
This issue was titled 'make documentation is un-installable' and was plainly (given your three examples) user error … a case of using an incorrect process to build/install the documentation. I can see that it's an easy mistake to make, and have attempted to make it harder for people to make that mistake in future.
>It shouldn't be too difficult to …
Maybe … I'm not maintainer of gnustep-make and don't know how difficult it would be. I do know from past discussions that Nicola is very much against adding special cases like that, on the basis that they make things more complex and less maintainable, but if it's simple/clear enough it might be OK.
> Not to mention this highly unusual requirement isn't mentioned in INSTALL at all.
As I said previously, it was implied by the process (the quick install instructions told you to configure/install gnustep-make and then to build/install the documentation), but not stated explicitly, so I changed it to state it explicitly.
|