[Qgis-developer] doc dir in github

Richard Duivenvoorde rdmailings at duif.net
Tue Nov 5 23:15:42 PST 2013


Hi devs,

while searching for the template for the doxygen templates for
qgis.org/api I stumbled upon the doc directory in Github:

https://github.com/qgis/QGIS/tree/master/doc

Can someone tell us what this is?

Apparently the INSTALL text in the root of the QGIS project is generated
from that, but I think that is not clear to everybody (as for example
Mathias is editing that file directly:

https://github.com/qgis/QGIS/commit/8d0d7df22b6d586bec63b386060de82aaab16cd4#diff-6a755e7d228a2b491321dbae0a7a248b

while I think his edit will be overwritten next build of this file,
because I do not see his edit in:

https://github.com/qgis/QGIS/blob/master/doc/linux.t2t

which apparently is the source for INSTALL

Can we please:
- add a tiny README in the doc dir to tell what it generates (not the
docs :-) )? apparently INSTALL, but I see more scripts and docs??
- or remove stuff which is not needed/used anymore?
- add a line in top of INSTALL that it is a generated txt so should not
be edited directly?

Regards,

Richard Duivenvoorde



More information about the Qgis-developer mailing list