On 7/25/21 1:11 PM, Jonathan Corbet wrote: > pioneer695 <pioneer695@xxxxxxxxxxxxxx> writes: > >> In an attempt to get some readable documentation I cloned the git repository >> to check how the PDF format is. >> >> Entered Documentation and proceeded with: >> >> make pdfdocs Hi, I'm curious about this part above. Are you saying that you did: cd Documentation make pdfdocs I've never tried that and don't expect it to be done that way. I do (from the top of the kernel source tree): make pdfdocs or make htmldocs with no problems, other than I may not have all of the latex tools installed. >> which failed, so to start fresh, my thought was that: >> >> make cleandocs >> >> would be the next step before anything else. But, this resulted in: >> >> rm -rf /output > > That's not good... > >> as $(obj) for some reason was empty. > > *This* would appear to be the real problem. If you could do some > digging to figure out why that happened, I suspect that would be > useful. > >> Makefile for Documentation has: >> >> BUILDDIR = $(obj)/output >> >> cleandocs: >> $(Q)rm -rf $(BUILDDIR) >> >> >> This should (at least?!) be: >> >> BUILDDIR = ./$(obj)/output >> or: >> $(Q)rm -rf ./$(BUILDDIR) > > These would break builds for a lot of people and are not the right > solution. -- ~Randy