trinity-devel@lists.pearsoncomputing.net

Message: previous - next
Month: May 2013

Updating generic documentation files (AUTHORS, COPYING, README, etc.)

From: "Darrell Anderson" <darrella@...>
Date: Wed, 22 May 2013 17:54:21 -0500
I was looking into updating the README files with respect to non-
historical branding references to KDE/KDE3. So as to not 
incorrectly update historical references, updating those files 
probably is a file-by-file project. There are 966 README files and 
that basically stopped my motivation for updating the files.

Further, there are 287 AUTHORS files, 275 ChangeL|log, 298 
COPYING*, 173 INSTALL, 116 NEWS, 7 PACKAGING, 11 RELEASE*, and 366 
TODO.

I suspect many --- possibly most --- of these text files provide 
little to no value anymore. The AUTHORS files are redundant of the 
Trinity About dialogs, likely all of the change log files have not 
been updated since several releases before 3.5.10 and certainly 
have not been updated in the Trinity era, the COPYING* files are 
redundant to almost all *.cpp files, the INSTALL files are 
irrelevant at best, the NEWS files all are outdated, PACKAGING 
files obsolete, RELEASE files obsolete. There might be a handful of 
useful ideas in some of the TODO files, but likely they could be 
consolidated into a wiki page or bugzilla enhancement requests --- 
not that we have the available personnel to accomodate most of 
those wish list items.

Should we delete most of these text files?

Comments?

Darrell