libs-base icon indicating copy to clipboard operation
libs-base copied to clipboard

[autogsdoc] doc file generation date

Open rmottola opened this issue 2 years ago • 3 comments

Currently, autogsdoc tries to be smart and puts as dates those found in the header (.h first, .m if not present). It scavenges for Date, Copyright and if present Revision too. However the latter one is CVS info, not really useful. These dates are referred to the file content.

I think somewhere (maybe at the bottom or top of the file in a different style) a generation file of the doc itself should be present. This informs the user on when the generation was run, independently of when the class was last touched itself (and maybe somebody forgot to update its header copyrights).

What do you think? @rfm @gcasa

rmottola avatar Sep 20 '23 23:09 rmottola

Yes, this stuff seems obsolete (and perhaps never very useful to start with). I agree that having a documentation generation timestamp (the date/time at which the headers/source were parsed) might be nice.

rfm avatar Oct 21 '23 18:10 rfm

Current progress is good and seems to work. We need to clean up version files around, after being done with base. (Reminder).

Also, a clean solution for index.html would be interesting. E.g. min/max of dates + list of authors coming from all files.

rmottola avatar Nov 03 '23 23:11 rmottola