I put the file asciidoc-markup.txt in the /docs directory with all I know about asciidoc. I use gedit with the Draw Spaces plugin that way I can see the difference between tab and space and also see trailing spaces.
I think a separate history.txt file is appropriate. I don't see where it would fit in the 2.5 docs the way the pdf's are split up. When I combine all the pdf's to one in master this would fit well. I can do the steps to create the file as soon as I catch up with Kent's proof reading. John On 1/16/2012 2:24 AM, Anders Wallin wrote: > +1 on this. > > When the wikipedia-police wanted to take down the emc2 wikipedia entry > I spent an afternoon digging up as many emc2-references as I could > find. They are listed here: > http://en.wikipedia.org/wiki/Enhanced_Machine_Controller > > In addition to historical references I would think there is room for a > section in the manual for a list of more recent references. I can do > this if I can get some pointers on how to do it and where it would fit > in the manual. On the emc2 wiki there used to be a page "how to get > started with documentation" which had instructions on installing LyX > etc. Is there anything similar for the current workflow > (asciidoc+git)? > > Anders > > On Sun, Jan 15, 2012 at 7:14 PM, Kent A. Reed<[email protected]> wrote: >> Gentle persons: >> In reviewing the 2.5 documentation I came to realize that neither the docs >> nor the web/wiki site gives proper attribution to foundational documents >> from NIST, although there are tips of the hat to NIST as the originator of >> the EMC project and there are brief mentions of "the NIST document" etc. >> After all, I can draw a straight line from some parts of NIST documents to >> sections of the current EMC2 documentation. >> >> I would think as a minimum we would have an entry for >> >> 1) the last paper by Tom Kramer, et al., on the RS274NGC Interpreter, which >> is a de facto public-domain definition of RS274NGC and has great artwork. >> >> The formal reference: >> >> Kramer, Thomas R.; Proctor, Frederick M.; Messina, E.; The NIST RS274NGC >> Interpreter - Version 3; NISTIR 6556; National Institute of Standards and >> Technology, Gaithersburg, MD 20899; August 2000. >> >> As of today, it can be found at >> >> http://www.isd.mel.nist.gov/documents/kramer/RS274NGC_3.pdf >> >> http://code.google.com/p/rs274ngc/downloads/detail?name=RS274NGC_3.pdf >> >> 2) a description of NML, perhaps drawing from the list at >> http://http://www.isd.mel.nist.gov/projects/rcslib/index.html. I don't know >> which is the right choice. It wouldn't hurt to include something about RCS >> and the distributed manufacturing environment that was the goal of all this >> work, given our RCSLIB heritage. >> >> Since these works are not subject to copyright, we could even post copies >> directly on our site (with proper citation or course) for the convenience of >> the EMC2 community. >> And, yes, I'm a retired NIST guy, but not from the manufacturing technology >> program, who likes to see its good works acknowledged properly. >> Regards, >> Kent > ------------------------------------------------------------------------------ > RSA(R) Conference 2012 > Mar 27 - Feb 2 > Save $400 by Jan. 27 > Register now! > http://p.sf.net/sfu/rsa-sfdev2dev2 > _______________________________________________ > Emc-developers mailing list > [email protected] > https://lists.sourceforge.net/lists/listinfo/emc-developers ------------------------------------------------------------------------------ RSA(R) Conference 2012 Mar 27 - Feb 2 Save $400 by Jan. 27 Register now! http://p.sf.net/sfu/rsa-sfdev2dev2 _______________________________________________ Emc-developers mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/emc-developers
