Discussion of EMC docs

John,

yes I have seen, in 2.5 doc there is gladeVCP...

The translations you pointed, seems to be "Potemkin villages" , right, just links, but nothing behind right now.

Were there translations in previous versions ?
Never seen seen something in german, but maybe I missed it somehow.

I am very impressed with the documentation after three months of falling asleep with it every night. Good work!

Something software developers nearly always overlook is the importance of a good index at the back of the book. This is the hardcopy equivalent of a search function for those of us who like to read printed manuals. The bigger the index, the easier/quicker it is to learn a topic.

I'm not looking for something on the order of Strong's Exhaustive Concordance where every instance of the word "the" is indexed. But most publishing software has the capability of generating an index with little effort. An extra ten pages at the back of the manual would be a blessing for those of us trying to learn linux, C, Python, HAL, and EMC, all at once.

An alternative would be a separate, global index that covers all manuals in one document - perfect for cross referencing.

Doug

Is it possible to add to every page of docs link to "level up"?

Often I reach the docs like linuxcnc.org/docs/2.5/html/man/man9/mux4.9.html from google, and then want to get docs on other components, so I have to go into the address bar and delete half of the url to go to level up.

Thank you.

Is this one still relevant: www.linuxcnc.org/index.php/english/compo...les/42-emc-internals ?

I could not find where HAL comes into the picture here.