Hi michael, having a diff to the previous html is not a bad idea. But from my point of view it doesn't pretend you from duplicating functionality. What about creating a good index over all your documentation in order to find the functionality you need? Or using a tool like doxygen (http://www.stack.nl/~dimitri/doxygen/) to create an overview over your source code?
I created a documentation of emc2/src with doxygen on a linux Ubuntu 10.04 with doxygen and graphviz (took about 3 min). The package is about 80 MB big and I don't have any webspace or FTP where I can post it to you all. If anyone interested in this, how can I share it with you? Regards Fabian -----Ursprüngliche Nachricht----- Von: Michael Haberler [mailto:[email protected]] Gesendet: Donnerstag, 5. April 2012 00:49 An: EMC developers; Enhanced Machine Controller (EMC) Betreff: [Emc-developers] manuals: what has changed? viewing the difference of two versions of a HTML page I regularly see folks reinventing stuff which has been done, and implemented and documented, including myself ;). No wonder, because the manuals are big, and we have no change bars or such in place. Looking around I found this, and is very useful to quickly view the difference of two html pages - it highlights old text in red and new text in green: http://www.aaronsw.com/2002/diff/ Here is the diff from the G-code overview of between 2.5 and master: http://static.mah.priv.at/public/html/Overview-diff.html generated from the above links with inputs: http://www.linuxcnc.org/docs/2.5/html/gcode/overview.html http://www.linuxcnc.org/docs/devel/html/gcode/overview.html It's not flawless but I think it does a pretty good job for 66 lines of Python. I think that would be a great addition to have on http://www.linuxcnc.org/docs/*/html/ : for each html document, a link nearby 'difference to previous version' - Michael ------------------------------------------------------------------------------ Better than sec? Nothing is better than sec when it comes to monitoring Big Data applications. Try Boundary one-second resolution app monitoring today. Free. http://p.sf.net/sfu/Boundary-dev2dev _______________________________________________ Emc-developers mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/emc-developers ------------------------------------------------------------------------------ Better than sec? Nothing is better than sec when it comes to monitoring Big Data applications. Try Boundary one-second resolution app monitoring today. Free. http://p.sf.net/sfu/Boundary-dev2dev _______________________________________________ Emc-developers mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/emc-developers
