aarroyoc
[Feature Request] Regenerate only changed files
As of now doclog seems to require a make clean to remove any output files before generating docs.
The generation process itself is quite slow. I think having it store timestamps and regenerate only changed documentation would be very helpful. Any other method that avoids unnecessarily regenerating files would also be nice.
I think it's a worthy request. Probably a system that calculates the hashes of the source files and stores them in a meta-file in the output directory could be more robust.
If someone wants to implement it by themselves, please comment it here. Otherwise, I'll keep it in my backlog.
I was thinking of the same request. Include the hashes of Scryer executable and doclog commit as well, so if the software changes everything is rebuilt.
No, that would be an overkill. I was thinking on how to implement this. One option I can think of is to read the last modified date of all files in the output folder and taking the newest one. If a source file has a newer modification date than the output date, then we should generate that file. Maybe there are some edge cases, but it could work reasonably well for fast edits.
EDIT: The problem would be deletions. The output folder won't delete previous files that no longer exist, but it might be just a minor inconvenience.
Please, test the new version that supports incremental builds for file contents (it doesn't support sidebars and footer updates), but should help while developing docs for a specific library.