#linuxcnc-devel Logs

Jun 03 2022

#linuxcnc-devel Calendar

02:11 AM -!- #linuxcnc-devel mode set to +v by ChanServ
09:08 AM pere: hi
09:14 AM silopolis[m]: hey pere o/
09:14 AM silopolis[m]: Beware friends, there's a doc tsunami comming ! 😅
09:15 AM silopolis[m]: s/comming/coming/
10:23 AM pere: silopolis[m]: hi
10:31 AM silopolis[m]: pere: re
10:42 AM silopolis[m]: For those who may have missed it on ML, last call for online meeting https://framadate.org/LinuxCNC-June-2022-online-meeting
11:12 AM silopolis[m]: And The Wave broke ! 🎉🎉🎉
11:57 AM * silopolis[m] believes the weblate's admins must be thinking "WTF ?!" 😜
11:57 AM pere: silopolis[m]: ?
11:57 AM silopolis[m]: doing a trial setup ATM
11:58 AM silopolis[m]: weblate's been ingesting POT file for 10 minutes 😅
11:59 AM pere: somehow my weblate view claim the doc is 100% translated without any translations. did you get the regex for the PO files correct?
12:00 PM pere: oh, it is worse. 0 strings in total...
12:00 PM silopolis[m]: It's processing now
12:01 PM * silopolis[m] uploaded an image: (125KiB) < https://libera.ems.host/_matrix/media/r0/download/matrix.org/UiCQrranEdjQRDtCxbYsbrDK/image.png >
12:02 PM silopolis[m]: pere: `docs/po/*.po`, was auto detected
12:09 PM silopolis[m]: half way...
12:40 PM silopolis[m]: pere: there's something strange with string locations: they seem to miss the 'docs/' in their path !? 🤔
12:44 PM * silopolis[m] uploaded an image: (55KiB) < https://libera.ems.host/_matrix/media/r0/download/matrix.org/pikzTfCDUpMBeIROGWEpcnba/image.png >
12:44 PM silopolis[m]: Some clues ?
12:47 PM silopolis[m]: indeed, path in pot are rooted in docs not repository root 😕
01:28 PM pere: silopolis[m]: look like weblate has been able to parse stuff?
01:29 PM smoe: My hunch is that that .po files where created from within the docs subdirectory but weblate expects them to be created from the project's root.
01:30 PM smoe: This could fairly easily be corrected via sed in the .po files but then we would have the problem with the build. Somehow the URL must be possible to change within weblate.
01:30 PM pere: I tried modifying the path generator in <URL: https://hosted.weblate.org/settings/linuxcnc/linuxcnc-docs/#vcs >.
01:32 PM smoe: Sidenote - we could have different subprojects in weblate via the filemask, see https://hosted.weblate.org/projects/linuxcnc/gmocappy/#information . I mean this for our subfolders.
01:33 PM silopolis[m]: smoe: mine too
01:36 PM silopolis[m]: smoe: This and component discovery
01:36 PM silopolis[m]: <smoe> "This could fairly easily be..." <- can't we just update our scripts to generate from the repo's root ?
01:37 PM pere: silopolis[m]: did the alert to away?
01:37 PM smoe: change scripts: Yes, but this would be ugly.
01:38 PM silopolis[m]: smoe: why ?
01:39 PM smoe: You want actions to happen as local as possible, such that these interfere with as little as possible. We now prepare the .po for docs within docs and have relative paths from within docs. All as it should be.
01:40 PM silopolis[m]: CI actions ?
01:42 PM smoe: Seems fine now?
01:45 PM silopolis[m]: Well, should have noted that it only seems to break links to source string on GH
01:46 PM smoe: I just clicked on the first German entry to translate and that was "README for Document Writers", which likely meant "Documentation Writers", maybe even "Authors".  I think we also need a README for translators on how to deal/report/correct bad English wording.
01:49 PM pere: smoe: I believe it belong in docs/README.adoc, which need some polish.
01:50 PM silopolis[m]: Dream team all gathered ! 🎉
01:51 PM hansu: Hi guys, seems that we have forgotten to remove the fuzzy comment which po4a added automatically...
01:51 PM pere: which fuzzy comment?
01:51 PM silopolis[m]: <smoe> "Seems fine now?" <- No repository browser links still broken whereas setup seem good
01:53 PM hansu: >which fuzzy comment?
01:53 PM hansu: That one that Weblate displays as "marked for edit"
01:53 PM pere: hansu: that narrow it down to a few thousand. I thought you had one specfic in mind.
01:53 PM hansu: Something like this
01:53 PM hansu: #: src/emc/motion/control.c:665
01:53 PM hansu: #, fuzzy
01:53 PM hansu: msgid "Probe tripped during non-probe move."
01:53 PM hansu: No talking in general
01:54 PM pere: In my view, we should not have removed these up front, but wait for someone to review the strings on weblate and remove the 'fuzzy' flag there.
01:54 PM hansu: Yes that's the best, but also the most work
01:55 PM silopolis[m]: <smoe> "You want actions to happen as..." <- how would they interfere ?
01:55 PM pere: hansu: sure, but I believe any other way will lead to incorrect translated documentation.
01:56 PM hansu: You are right, we can't be 100% sure if there is no paragraph swapped while generating these po files
01:56 PM smoe: silopolis[m]  I just meant to explain my scoring for beauty. No action required.
01:57 PM hansu: Nice that Weblate is already set up for teh docs, Thanks!
01:58 PM hansu: So already time for an anouncement ?
02:01 PM silopolis[m]: hansu: my pleasure 🙂
02:02 PM silopolis[m]: Should I enable po files generation there too ? or do we prefer keeping it in CI ?
02:03 PM hansu: where?
02:04 PM silopolis[m]: in weblate, there is the option to gen po files there, like we do for softwares
02:07 PM * silopolis[m] uploaded an image: (33KiB) < https://libera.ems.host/_matrix/media/r0/download/matrix.org/pvEoNwiDBrqaKnUaOFSwJtAE/image.png >
02:09 PM hansu: I would say this is needed if we want the docs to be updated (almost) automatically. But then we shouldn't generate them from the CI. But I am not an expert. Petter should know that.
02:09 PM smoe: silopolis[m] + hanus: I agree.
02:09 PM smoe: Just ran into one of those "+": https://hosted.weblate.org/translate/linuxcnc/linuxcnc-docs/de/?q=state%3A%3Ctranslated&offset=6
02:09 PM smoe: This sucks.
02:14 PM hansu: smoe what do you mean?
02:14 PM silopolis[m]: hansu: beat me to it 😅
02:15 PM smoe: Update: I suck :)   The original text likely had a linebreak after the + and that has by some magic disappeared.
02:15 PM silopolis[m]: <smoe> "silopolis + hanus: I agree." <- pere: final vote Master ? po gen @weblate or in CI ?
02:16 PM pere: silopolis[m]: have not paid attention. what is the question?
02:16 PM silopolis[m]: wether to gen po files in weblate or in CI
02:16 PM pere: do not understand the question. are you talking about the POT file?
02:17 PM silopolis[m]: <silopolis[m]> "image.png" <- no this ^
02:19 PM smoe: Ok, thank you all, I am off for today.  I suggest that hansu announces the advent of weblate. Once that is out I would then reference this announcement on the German LinuxCNC facebook group with a reference to the announcement. I have just done some 30(?) entries. Please stop me should I do more :)
02:20 PM pere: <URL: https://people.skolelinux.org/pere/blog/LinuxCNC_translators_life_just_got_a_bit_easier.html >
02:23 PM silopolis[m]: pere: my son's gonna love you https://people.skolelinux.org/pere/blog/Debian_still_an_excellent_choice_for_Lego_builders.html
02:26 PM pere: silopolis[m]: Great. I feel unappreciated, so I take all the love I can get.
02:26 PM silopolis[m]: <hansu> "Hi guys, seems that we have..." <- For the record, there is a bulk edit addon in weblate to update flags, labels, or states of strings.
02:29 PM pere: if you are 100% sure every fuzzy string is correct, you can use to remove the fuzzy flag.
02:31 PM smoe: As of now, even if the translation is not correct, this would create a decent document - at least as decent as before. The only reason to remove fuzziness automatically is to increase the percentage, if I get this right. I personally could not care less. Just leave it as it is.
02:31 PM smoe: On https://github.com/LinuxCNC/linuxcnc/blob/master/docs/README.adoc?plain=1#L150 we should mention that po4a has now happened. I was just asked to translate something outdated :)
02:32 PM pere: smoe: yeah, and also it should mention po4a.cfg as a file to update when new documents are added.
02:33 PM hansu: Where was it where I can get the url of the weblate git-repo?
02:34 PM smoe: https://hosted.weblate.org/projects/linuxcnc/linuxcnc-docs/#information
02:35 PM hansu: Ah I was looking for something with .git at the end. Thanks
02:39 PM silopolis[m]: <pere> "smoe: yeah, and also it should..." <- could you please add a note somewhere about what should be done when adding/removing files ?
02:40 PM silopolis[m]: <pere> "silopolis: Great. I feel..." <- 😄
02:40 PM * silopolis[m] sends a big hug to pere
02:41 PM smoe: <3
02:48 PM hansu: regarding the anouncement - maybe it would also fit good on the linuxcnc main page under "News" ?
02:50 PM smoe: Yip. @hansu, I suggest you are the one to write to the EMC mailing list.
02:54 PM hansu: Yes I can do that as I am responsible for the final merge :D
02:57 PM hansu: Maybe also to EMC users?
02:59 PM smoe: Good idea. Yes, especially the EMC users. I am not subscribed to that and forgot. And yes, I will blame you for everything I wrecked while syncing.
02:59 PM smoe: How do we now proceed and invite for changes to the documentation? LIke https://hosted.weblate.org/translate/linuxcnc/linuxcnc-docs/de/?q=state%3A%3Ctranslated&offset=51 looks bad.
03:00 PM smoe: Just to master, right? Preferably with a couple of changes going together to avoid overheads, I presume.
03:05 PM hansu: > And yes, I will blame you for everything I wrecked while syncing.
03:05 PM hansu: Yes I know that and I want to give all the other users the same possibility XD
03:06 PM hansu: >Just to master, right?
03:06 PM hansu: Yes and bundled a bit in PRs as usual
04:05 PM linuxcnc-build: build #2429 of 1640.rip-buster-rtpreempt-amd64 is complete: Failure [4failed configuring] Build details are at http://buildbot.linuxcnc.org/buildbot/builders/1640.rip-buster-rtpreempt-amd64/builds/2429 blamelist: CMorley <chrisinnanaimo@hotmail.com>
04:05 PM linuxcnc-build: build #2188 of 1650.rip-buster-rtpreempt-rpi4 is complete: Failure [4failed configuring] Build details are at http://buildbot.linuxcnc.org/buildbot/builders/1650.rip-buster-rtpreempt-rpi4/builds/2188 blamelist: CMorley <chrisinnanaimo@hotmail.com>
04:07 PM linuxcnc-build: build #2028 of 1660.rip-buster-python3 is complete: Failure [4failed configuring] Build details are at http://buildbot.linuxcnc.org/buildbot/builders/1660.rip-buster-python3/builds/2028 blamelist: CMorley <chrisinnanaimo@hotmail.com>
04:07 PM linuxcnc-build: build #8828 of 0000.checkin is complete: Failure [4failed] Build details are at http://buildbot.linuxcnc.org/buildbot/builders/0000.checkin/builds/8828 blamelist: CMorley <chrisinnanaimo@hotmail.com>
06:57 PM smoe: Does anybody know what the documentation is meant to describe with a "runtime script"?
06:58 PM smoe: I just googled for that - not very successful.
07:04 PM silopolis[m]: Script made to setup and launch program?
07:15 PM smoe: I agree that this is likely what was meant. Just that "runtime" is past setup and past launch. So, I am unhappy about that wording.
07:21 PM silopolis[m]: Always been a word I couldn't really translate and lived with my "understanding" of it :/
07:32 PM Tom_L: most likely if you were running linuxcnc from a command line terminal
07:33 PM Tom_L: http://linuxcnc.org/docs/2.7/html/code/adding-configs.html
07:35 PM Tom_L: https://github.com/cnc-club/linuxcnc/blob/master/docs/INSTALL
07:35 PM Tom_L: line 23
11:31 PM linuxcnc-build: build #2430 of 1640.rip-buster-rtpreempt-amd64 is complete: Failure [4failed configuring] Build details are at http://buildbot.linuxcnc.org/buildbot/builders/1640.rip-buster-rtpreempt-amd64/builds/2430 blamelist: CMorley <chrisinnanaimo@hotmail.com>
11:31 PM linuxcnc-build: build #2189 of 1650.rip-buster-rtpreempt-rpi4 is complete: Failure [4failed configuring] Build details are at http://buildbot.linuxcnc.org/buildbot/builders/1650.rip-buster-rtpreempt-rpi4/builds/2189 blamelist: CMorley <chrisinnanaimo@hotmail.com>
11:35 PM linuxcnc-build: build #2029 of 1660.rip-buster-python3 is complete: Failure [4failed configuring] Build details are at http://buildbot.linuxcnc.org/buildbot/builders/1660.rip-buster-python3/builds/2029 blamelist: CMorley <chrisinnanaimo@hotmail.com>
11:35 PM linuxcnc-build: build #8829 of 0000.checkin is complete: Failure [4failed] Build details are at http://buildbot.linuxcnc.org/buildbot/builders/0000.checkin/builds/8829 blamelist: CMorley <chrisinnanaimo@hotmail.com>