Back
[07:12:03] <KGB-linuxcnc> 03John Thornton 052.7 5d5a02c 06linuxcnc 10(11 files in 7 dirs) Docs: fig links are no longer needed with asciidoc * 14http://git.linuxcnc.org/?p=linuxcnc.git;a=commitdiff;h=5d5a02c
[08:22:34] <jepler_> andypugh: one aspect of my code is that it is supposed to widen *any* smaller width to 64 bits. for instance, I think the position counter on pluto for an encoder was just 12 bits or something
[10:54:26] <andypugh> jepler_: Ref converting to wider types. Ah, yes, that’s a more interesting puzzle.
[10:58:30] <andypugh> I did a variable-length version in smart-serial too (not reaslising that there was an existing version)
[10:58:31] <andypugh> http://git.linuxcnc.org/gitweb?p=linuxcnc.git;a=blob;f=src/hal/drivers/mesa-hostmot2/sserial.c;h=c4ac675498548ea22e79035fa0b1a3f5b1a69044;hb=HEAD#l1444
[11:02:31] <jepler_> nice
[11:28:15] <andypugh> How does one build the docs?
[11:28:52] <andypugh> I guess that the “make” in “src” only compiles code in “src+”?
[11:35:10] <jepler> andypugh: you have to invoke configure differently to enable building docs, then the normal "make" or "make docs" in src/ builds them.
[11:35:33] <andypugh> I see how to turn docs off, and I guess I have
[11:39:40] <andypugh> OK, looks like I will be able to do it when asciidoc is installed
[12:00:03] <andypugh> So, what I am doing is a manpage for Vismach. I am rather unsure where it belongs in the docs tree.
[12:01:01] <andypugh> At the moment I have tacked it on the end of GUIs. But really it is more along the lines of developer docs. Any thoughts?
[12:33:26] <seb_kuzminsky> developer's manual, i think
[12:33:31] <seb_kuzminsky> you need to write code to use it, right?
[12:48:44] <cradek> by code you mean code other than gcode
[12:49:03] <cradek> (I think cnc users are programmers, whether they realize it or not)
[12:52:15] <archivist> except the pointy clicky cam users :)
[12:54:48] <Tom_itx> hey! i resemble that..
[13:35:34] <cmorley> Would it be difficult to add 'hot codes' to make the extents calculation not include areas ( remapped tool probe)?
[13:35:45] <cmorley> http://www.linuxcnc.org/index.php/english/forum/21-axis/29454-manual-tool-change-again
[13:36:32] <cmorley> similar to AXIS hot codes to not display parts of the gcode program
[13:55:19] <cradek> ooh, that would be nice
[13:55:52] <cradek> wait, doesn't that already happen?
[13:57:04] <cradek> AXIS,hide and AXIS,show
[13:57:53] <cradek> argh, instead of one bottle of watch cleaner and one of rinse like I thought I had, I have two rinse and no cleaner
[13:58:27] <Tom_itx> ultrasonic cleaner?
[13:58:47] <cradek> yeah the ammonia stuff
[13:59:09] <cradek> L&R Ultrasonic something something
[13:59:21] <Tom_itx> i ran out so i've been using mild dish soap
[13:59:41] <cradek> #111
[14:00:02] <cradek> it's magical stuff
[14:00:23] <cradek> http://www.amazon.com/Ammoniated-Watch-Cleaner-111/dp/B00K0L5KGI
[14:00:27] <cradek> hahaha $114
[14:00:38] <cradek> what the absolute
[14:01:12] <archivist> somewhat OTT on the price
[14:01:32] <cradek> yeah I'd expect $40ish
[14:02:54] <Tom_itx> http://www.stuller.com/products/54-4392/?groupId=23255
[14:03:17] <Tom_itx> there's the 40ish you were expecting
[14:03:34] <archivist> https://www.cousinsuk.com/product/lr-111-watch-cleaner
[14:03:38] <cradek> yeah, I'm checking jborel if I can ever get logged in
[14:04:31] <archivist> get off amazon, they have stopped being cheap, they think they have the world market now
[14:05:20] <andypugh> archivist: That watch cleaner isn’t being sold _by_ Amazon, just _on_ Amazon
[14:06:13] <archivist> yes but amazon profitability has suddenly jumped due to pricing policies
[14:06:44] <Tom_itx> theire broker fees have increased dramatically
[14:07:15] <andypugh> I was going to set up a Ner-a-Car spares shop on Amazon, but you can’t list anythign without a UAN
[14:08:28] <cradek> archivist: oh I didn't expect to buy it there. I was looking for a description/picture to show Tom_itx
[14:09:31] <archivist> they also have dynamic pricing, I have seen insane high prices on some old books
[14:10:38] * cradek tries spray glass cleaner
[14:11:05] <cradek> it's not a precious or precise clock :-)
[14:12:06] <archivist> actually safer on brass than ammoniated
[14:13:15] <cradek> is ammonia bad? I've always used it
[14:13:16] <archivist> ammonia can facilitate stress corrosion cracking, so not recommended
[14:13:36] <archivist> everyone uses it :)
[14:13:59] <archivist> just dont let any museum types know
[14:14:24] <cradek> I thought the non-ammonia versions were because of smell, and I figured they wouldn't work very well (like lead-free solder), so I avoided them
[14:16:12] <archivist> I have some books on the subject, people stared really learning about it in the 1940's, although it was common in shell cases in the 1st world war
[14:16:20] <archivist> started
[14:17:07] <cradek> is cyanide safe (for the clock)?
[14:17:27] <Tom_itx> not for the clock maker
[14:17:29] <cradek> 20 years ago I worked with a jeweler who still used it
[14:17:41] <cradek> it works greeeaaaat
[14:18:10] <archivist> the effect is not unique to brass either
[14:19:08] <archivist> https://en.wikipedia.org/wiki/Stress_corrosion_cracking
[14:20:41] <archivist> "it fell apart in my hands" has actually happened to me when cleaning a thermometer
[14:21:18] <cradek> eek
[14:22:53] <archivist> I tested some mercury with freshly stressed brass, took about an hour to crack
[14:33:30] <cmorley> cradek: program extents are calculated are always calculated regardless of show and hide (as usually thats what you want)
[14:35:16] <cradek> oh, hmm
[14:36:05] <cmorley> I think the code is all in gcodemodule.cc but it's not commented well
[14:36:51] <cmorley> I'm also not sure that is actually all that user wants but it is an interesting problem
[16:13:26] <cradek> now I can't tell if it's my sinuses or the whole house that smells like ammonia
[16:14:13] <skunksleep> Ewww
[16:14:18] <archivist> you can tell which if you get told off
[16:32:50] <skunksleep> I like linuxcnc over emc2 as a lot of sites have 3 or 4 character minimums for searching
[16:47:40] <andypugh> Hmm, Does the Vismach manpage belong in “User Interface Programming” ?
[17:15:51] <JT-Shop> I'd think a separate man page
[17:18:09] <JT-Shop> I think your asking where does the Vismach docs go and I'd have to ask is vismach a user interface?
[17:18:21] <andypugh> I don’t know. That is what I am asking.
[17:18:33] <andypugh> Perhaps there are no docs because nobody knows where to put them>
[17:19:02] <JT-Shop> or no one that writes docs knows how it works
[17:19:22] <andypugh> So, where would you put it?
[17:19:28] <andypugh> (And how?)
[17:19:33] <JT-Shop> looking and thinking
[17:19:46] <andypugh> I have managed to get the asciidoc to create some HTML...
[17:20:04] <JT-Shop> I can put the txt file in and set up the build process for it
[17:20:38] <JT-Shop> is vismach something you use alongside Axis?
[17:20:46] <andypugh> I have done part of that
[17:20:57] <JT-Shop> adding the txt file?
[17:21:10] <JT-Shop> which branch?
[17:21:22] <andypugh> No branch
[17:21:29] <andypugh> (locally)
[17:22:14] <JT-Shop> is vismach just a visual representation of the physical machine?
[17:23:07] <andypugh> There doesn’t becessarily have to be a physical machine
[17:23:13] <andypugh> (necesarily)
[17:24:03] <JT-Shop> I'd say right this second that User Interfaces would be the logical place to put Vismach
[17:24:22] <JT-Shop> I'd be happy to set that up in 2.7 if you like
[17:24:58] <andypugh> Seb thought that as you need to write code to use it, that it should be in Develper...
[17:25:34] <andypugh> And I am thinking it might belong in User Interface Programming..
[17:25:50] <JT-Shop> or Advanced Topics
[17:26:30] <JT-Shop> I'd agree that User Interface Programming sounds logical now that you mention it needs to be programmed
[17:27:56] <andypugh> Currently I seem to have a few formatting problems, a bulleted list isn’t working, and a link to an external section is trying to link externally
[17:28:03] <JT-Shop> And how? add the txt file with a level one title, edit the submakefile and add the topic, edit the index.tmpl and add the topic
[17:28:40] <andypugh> Aha! index.tmpl is probably the required magic
[17:28:45] <JT-Shop> blank lines seem to be important to asciidoc
[17:29:19] <Tom_itx> asciidoc is a funny little creature
[17:29:32] <JT-Shop> no as funny as latex
[17:29:34] <JT-Shop> not
[17:30:15] <Tom_itx> may attempt to work on the control this evening. first time i've felt well enough to do so in quite a while
[17:30:25] <JT-Shop> if you like I can add a blank file to 2.7 so you can see all that I do
[17:31:23] <andypugh> I think I am nearly there
[17:31:29] <JT-Shop> ok
[17:34:15] <andypugh> I wonder if I should push it for fine-tuning, and if so, where to?
[17:34:30] <JT-Shop> 2.7
[17:34:42] <JT-Shop> it's not new right, just lacking docs?
[17:34:59] <andypugh> Indeed
[17:35:13] <JT-Shop> I'm fine tuning the 2.7 docs now
[17:44:50] <JT-Shop> btw, in case you missed the discussion the other day we have adopted the naming convention of file-name.txt for files and cha:widget-builder or sec:widget-section for anchors
[17:45:52] <JT-Shop> dunno if those were good examples or not...
[18:11:50] <andypugh> JT-Shop: Do you know of an example of an out-of-file link anywhere?
[18:12:54] <JT-Shop> what branch are you working with?
[18:13:29] <andypugh> Accidentally, andypugh/carousel_demo…
[18:13:45] <JT-Shop> what branch is that based on?
[18:14:07] <JT-Shop> oh did you add the file to master_documents.txt?
[18:14:13] <JT-Shop> if 2.7
[18:15:47] <andypugh> I think I did.
[18:16:16] <andypugh> It seems to be being built, but a link to an external section isn’t
[18:16:23] <JT-Shop> info about formating and links in ~docs/asciidoc-markup.txt
[18:16:39] <andypugh> Sorry, the link is there, it just doesn’t link
[18:16:48] <JT-Shop> external= not in same txt file?
[18:17:05] <andypugh> not even in the same folder
[18:17:21] <JT-Shop> so long as it is in the same pdf the links will work
[18:17:37] <JT-Shop> the main reason for combining the user and integrator manual
[18:18:13] <andypugh> I haven’t even looked a the PDF version yet.
[18:18:47] <JT-Shop> the file needs to be in Master_Documentation.txt
[18:19:14] <andypugh> It is. The file I want to link to is halmodule
[18:19:46] <andypugh> So, rather than explain how to create HAL pins in a python script, I want to link to the userpsace python manual pages
[18:19:51] <JT-Shop> should not be a problem halmodule is in there too
[18:20:04] <JT-Shop> you can't link to a man page
[18:20:34] <JT-Shop> hal/halmodule.txt is in the manual
[18:20:40] <JT-Shop> so you can link to that
[18:21:14] <JT-Shop> lol as soon as I put an anchor in halmodule.txt
[18:22:16] <JT-Shop> yes, it is best to only explain something in one place otherwise you have update issues
[18:24:09] <andypugh> Well, at the moment the html version tries to link to “#halmodule on this page” and the pdf version links to the title page. More faffing about needed, I guess
[18:24:49] <JT-Shop> can you create a branch and push it? I'll look at what your doing
[18:27:53] <andypugh> I am sure it isn’t difficult, I just need an example to copy
[18:31:00] <JT-Shop> examples in docs/asciidoc-markup.txt
[18:33:11] <andypugh> I meant actual working examples.
[18:34:24] <andypugh> asciidoc-markup just says <<anchor, text>> with no indication how to format the anchor
[18:34:25] <JT-Shop> the docs are full of them, search for cha: with grep -irl 'cha:' *
[18:34:35] <JT-Shop> but that may break because of the :
[18:34:55] <JT-Shop> [[anchor]]
[18:35:02] <JT-Shop> the actual anchor
[18:35:14] <JT-Shop> <<anchor,caption>> the link to the anchor
[18:35:55] <JT-Shop> [[cha:stepgen]] <<cha:stepgen, The Stepgen Chapter>>
[18:36:02] <JT-Shop> an anchor then the link to the anchor
[18:38:24] <JT-Shop> in the docs/src do grep -irl '<<cha:' * and it will list all the files that have a link to another file
[18:38:52] <andypugh> Yes, I have looked, and mine looks just like them, but doesn’t work like them
[18:40:05] <JT-Shop> does your link point to an actual anchor?
[18:40:30] <JT-Shop> what is the link?
[18:40:38] <andypugh> I might just push the thing anyway. A document with broken links is probably better than no document.
[18:40:54] <JT-Shop> what is the broken link?
[18:41:09] <andypugh> To me an “actual anchor” is a lump of metal that mainly (but not always) lives on a boat.
[18:41:29] <JT-Shop> I agree
[18:41:40] <JT-Shop> but in our case, what is the broken link?
[18:42:52] <andypugh> Sorry. I am becoming increasingly testy because there is something very wrong with my computer. Every time I try to do anything in the source editor I get 5 seconds of spinning beachball.
[18:43:00] <JT-Shop> there is virtual anchors but they are troublesome
[18:43:20] <JT-Shop> ouch and it is well into tomorrow for you too
[18:43:32] <andypugh> I have <<cha:halmodule, Creating Userpace Components in Python>>
[18:46:31] <JT-Shop> the fix is:
http://pastebin.com/PQdG8wkV
[18:47:40] <andypugh> OK, trying it
[18:48:27] <JT-Shop> all of my remaining anchors live on the shelf of the garage as I'm out of boats of any kind
[18:49:52] <andypugh> So, you have literal boat anchors that are figurative “boat anchors”
[18:50:10] <JT-Shop> aye
[18:52:28] <JT-Shop> I even have a giant ship bollard in the yard
[18:53:44] <andypugh> Could be handy of sea levels rise
[18:53:50] <andypugh> (if)
[18:54:07] <JT-Shop> I'm pretty much above the high water mark
[18:54:33] <JT-Shop> you waiting for the build to complete?
[18:55:19] <andypugh> It completed. I am trying to work out if the anchor can be at the top of the page, not at the first sub-chapter heading.
[18:56:01] <JT-Shop> IIRC the anchor does need to be on a line by itself
[18:57:22] <JT-Shop> so at the end of make you get "all links ok" or similar?
[18:57:58] <Tom_itx> do these build with a regular make of the 2.7 branch?
[18:58:23] <Tom_itx> or do the docs have a separate make
[19:00:10] <JT-Shop> you need to .configure the build of docs
[19:01:05] <Tom_itx> not sure i follow
[19:01:09] <Tom_itx> i checkout 2.7
[19:01:14] <Tom_itx> then ./configure
[19:01:19] <Tom_itx> then make clean
[19:01:20] <Tom_itx> then make
[19:01:21] <Tom_itx> iirc
[19:01:31] <JT-Shop> need more on ./configure hold on
[19:01:50] <Tom_itx> i'm not on that box atm
[19:01:59] <JT-Shop> http://wiki.linuxcnc.org/cgi-bin/wiki.pl?Installing_LinuxCNC#Building_the_documents_along_with_LinuxCNC
[19:02:42] <Tom_itx> so it doesn't build by default
[19:02:46] <Tom_itx> just the lcnc code
[19:02:47] <JT-Shop> no
[19:03:23] <JT-Shop> er yes to lcnc code no to docs
[19:03:32] <Tom_itx> gotcha
[19:05:34] * JT-Shop wonders if Andy is a document guru now?
[19:07:05] <Tom_itx> does that sample ascidoc file show all the markups you are using or is it just a basic example?
[19:07:38] <JT-Shop> pretty much shows all I'm using
[19:08:33] <Tom_itx> they've gotten much better over the years
[19:08:43] <JT-Shop> who is that?
[19:08:48] <Tom_itx> the docs
[19:08:56] <JT-Shop> thanks
[19:09:22] <Tom_itx> i think i like the expanded links over the collapsed ones... i find it harder to locate things i'm looking for
[19:09:31] <JT-Shop> I remember when I first started they had so much duplication it drove me nuts and I drove alex_joni nuts
[19:09:32] <Tom_itx> not sure what general topic to look under
[19:09:41] <Tom_itx> i remember that
[19:10:17] <JT-Shop> would hover over text showing a description help?
[19:10:30] <Tom_itx> i'm not sure
[19:11:03] <Tom_itx> is there a way to default them to expanded?
[19:11:05] <JT-Shop> open Configuration Wizards and hover over the choices
[19:11:17] <Tom_itx> i looked at your example already
[19:11:31] <JT-Shop> I'm pretty sure I can add a expand all button
[19:11:52] <Tom_itx> as a choice at the top would really be handy for me
[19:12:00] <Tom_itx> expand/collapse
[19:12:37] <Tom_itx> i like the layout
[19:12:44] <JT-Shop> I did that once when first testing the expand so I'll add it back
[19:12:49] <Tom_itx> just sometimes have trouble figuring what section it's in
[19:14:00] <Tom_itx> you can't please everybody.... just please me :D
[19:14:01] <KGB-linuxcnc> 03Andy Pugh 052.7 759c670 06linuxcnc 10(6 files in 4 dirs) Add some documentation for Vismach * 14http://git.linuxcnc.org/?p=linuxcnc.git;a=commitdiff;h=759c670
[19:14:25] <JT-Shop> YEA! I'll look at that in the am
[19:14:44] <Tom_itx> slowly working on the control a bit..
[19:15:07] <JT-Shop> thanks andypugh
[19:15:09] <Tom_itx> pinched nerve at C6-C7 has had me for a couple weeks
[19:15:15] <JT-Shop> ouch
[19:15:26] <Tom_itx> left arm pain like crazy
[19:16:04] <Tom_itx> took off last week
[19:16:10] <Tom_itx> err week before last
[19:21:21] <JT-Shop> time to turn on the magnet ass switch
[19:24:21] <JT-Shop> say goodnight Gracie
[19:24:47] <Tom_itx> later jt