Discussion of EMC docs

More
13 Sep 2011 13:11 #13167 by step4linux
John,

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

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.

Please Log in or Create an account to join the conversation.

More
13 Sep 2011 13:46 #13168 by BigJohnT
Replied by BigJohnT on topic Re:Discussion of EMC docs
I do know in 2.4 there is a French translation that was done by hand. I didn't try the links till now and even the French one is broken :(

John

Please Log in or Create an account to join the conversation.

More
13 Sep 2011 14:49 #13174 by doug6949
Replied by doug6949 on topic Re:Discussion of EMC docs
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

Please Log in or Create an account to join the conversation.

More
13 Sep 2011 15:10 - 13 Sep 2011 15:12 #13176 by BigJohnT
Replied by BigJohnT on topic Re:Discussion of EMC docs
Doug,

Thanks for the comment, the PDF's have a word index on the last pages last time I looked however I don't think the word index shows up on the left index panel :/

John
Last edit: 13 Sep 2011 15:12 by BigJohnT.

Please Log in or Create an account to join the conversation.

More
14 Sep 2011 00:17 #13191 by andypugh
Replied by andypugh on topic Re:Discussion of EMC docs
step4linux wrote:

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


There are _some_ translations.

If you take a typical URL
www.linuxcnc.org/docview/2.5/html/common/user_intro.html
Then modify it to
www.linuxcnc.org/docview/2.5/html/common/user_intro_fr.html
Then you get the french translation.
Similarly the German would be www.linuxcnc.org/docview/2.5/html/common/user_intro_de.html
(But as you can see, the page is there, but it is in English)
Also for www.linuxcnc.org/docview/2.5/html/common/user_intro_es.html

Please Log in or Create an account to join the conversation.

More
07 Nov 2012 04:15 #26314 by Nick
Replied by Nick on topic Re:Discussion of EMC docs
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.

Please Log in or Create an account to join the conversation.

More
07 Nov 2012 08:01 #26324 by BigJohnT
Replied by BigJohnT on topic Re:Discussion of EMC docs
If I knew of a way I'd do it... we used to have navigation links like that on the html's but that died when asciidoc was adopted.

John

Please Log in or Create an account to join the conversation.

More
25 Sep 2013 15:38 - 25 Sep 2013 15:39 #39173 by Einar
Replied by Einar on topic Re:Discussion of EMC docs
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.
Last edit: 25 Sep 2013 15:39 by Einar.

Please Log in or Create an account to join the conversation.

More
25 Sep 2013 16:32 #39174 by andypugh
Replied by andypugh on topic Re:Discussion of EMC docs

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.


Figure 2 is just about correct. HAL is the block labelled "Hardware Abstraction Layer"
However, the PID has moved out of motion into HAL. (so that stepgen can be used instead)
The following user(s) said Thank You: Einar

Please Log in or Create an account to join the conversation.

Time to create page: 0.159 seconds
Powered by Kunena Forum