#286

Ah…so I did know what I was doing when I used that. :man_facepalming:t2:

2 Likes
#287

thanks @GoneCaving for linking the post!

docs will be done really really soon, i’m working my way through the remaining grid ops and hoping to have them done early next week (the fact the docs are my top priority is evidenced by me having a dream last night where i was announcing the only docs that remain to be done are for grid ops - at a family gathering out of all places :))

if you don’t mind, i’m going to ask mods to merge this thread to the 3.0 thread.

13 Likes
#288

It was my first inclination to post it here…:nerd_face:. So why didn’t I???

#289

i’m not sure, but i am tempted to add ??? as a new op :slight_smile:

6 Likes
#290

??? [if x is true, Teletype outputs voltages for Chopsticks, but in Phrygian mode]

8 Likes
#291

documentation is done. let me know if you see any typos / formatting problems etc. huge thanks to @jlmitch5 and @alanza for their help!

cheatsheet.pdf
teletype.pdf
teletype.html

20 Likes
Grid ops / integration
#292

Excellent! To whom should we PM re any typos we find?

#293

you can PM me or just post here

1 Like
#294

Do we want to either link or somehow pull info about the github grid integration wiki into the teletype docs? I remember you had done some teletype control mode stuff, but it took me a while searching for the info after looking at the docs (where it wasn’t mentioned in the grid integration section).

1 Like
#295

the github wiki grid studies are linked already in what’s new, grid ops and the grid integration section under advanced, but yeah i think i should expand the grid integration section to provide a bit of overview and direct links to the grid visualizer and grid control mode pages, will add that!

#296

ah cool yea. I think I kept skimming for “grid control” and then thinking the wiki was (just) about shared community scenes, I went in there and didn’t see grid control within them, I got confused.

Once I saw the navigation within the wiki for the other pages, I was good.

#297

One thing I would love to see in a future firmware is an easier to see cursor in the script editor. Maybe I’m alone in this but I often find myself typing a character to see where the cursor is!

1 Like
#298

Nice job everyone.

Do you want to add a page break to the cheatsheet before the grid ops? Then they’ll all be on one page (and those that aren’t using them will be able to not print that page). The Python code for inserting page breaks in cheatsheet.py is a bit odd (sorry!), the docs should make it clear.

Also, if you didn’t know there is a list of ops with missing documentation in appendix B, it’s a surprisingly short list! But there are 3 grid ops in there that you might have missed.

2 Likes
#299

Small question: Is there a reason why the OPs for i2c connectivity to things other than the telex-modules (e.g. Just Friends, w/, Ansible) aren’t included in the alt + h help pages? Or is it just because nobody wrote them so far? If so, could you point me to where I’d have to add these pages? I wouldn’t mind writing them and I find that those are the OPs that I forget most of all, so I think it would be useful to have them in there.

3 Likes
#300

i’ll see if i can tweak it.

yeah, the main reason is that nobody added them. do you have the toolchain set up? if you do the file you want is https://github.com/scanner-darkly/teletype/blob/grid2/module/help_mode.c (pointing to my branch as it has the telex help screens added as well as other new ops, please use this branch until it’s merged to master).

makes sense, i’ll separate.

G.XYP, G.XYP.X, G.XYP.Y are there but i don’t want to document them yet as they’re unfinished (pushing this to 3.1).

going to add docs for IN.CAL.RESET and PARAM.CAL.RESET

for P.ADD, P.ADDW, P.SUB, P.SUBW, PN.ADD, PN.ADDW, PN.SUB, PN.SUBW, TIF not sure why it’s reporting them - likely because they have special chars in the name (P.ADD is actually P.+ etc and TIF is ?). the docs are there, it’s just not matching them. was going to ping you about this one - not really sure where to look!

2 Likes
#301

I do not. It does seem easy enough to get it right, though. Would you mind compiling and testing it if I just edited the file and sent a pull request without testing it first? If you’re too busy (totally understandable if so), I can also try to get the toolchain up and running, but can’t guarantee I’ll get that done quickly. In any case, I’ll start writing :slight_smile:

1 Like
#302

with the help file i find you have to tweak it by testing it on teletype, otherwise it’s hard to say where line breaks should be placed for better readability. see if you can set up the toolchain, if not i can add it.

this should probably go to next version, for this release i’m trying to limit it to very small changes and bugfixes for 3.0 features.

2 Likes
#303

Yeah, as I begun changing the script just now, I did realize quickly that I’d probably have to test it a bit. I’ll try to get everything set up.

One quick question: Maximum line length is 32 characters? The longest line I could find in the help pages so far was 30, but it looks on teletype as if there was some extra space there.

#304

it really depends, as it’s not a monospace font something like I takes less space than W, so it’s different between different lines. you could test to a certain extent just by typing in a script or live screen (just be aware they will limit to 31 characters while help screen doesn’t enforce max line length so in theory it can be longer as long as it fits on the screen)

1 Like
#305

@x2mirko - i’ve tested your change, looks good, i’ve merged the PR. thanks for your help with this! i made a couple of small changes (lines that didn’t fit) and combined just friends and w/ pages - they’re not too long and we’ll have more ops in the future, so trying to optimize scrolling.

here is the updated version. @apeirophobe - i also tried making the cursor slightly brighter - i think it looks good but want to hear what others think.

3.0 RC6

teletype.zip (165.1 KB)
teletype.hex (560.7 KB)

and with this i am “officially” declaring code freeze for 3.0 with the exception of bug fixes for new 3.0 features. we do need to release this at some point :slight_smile:

14 Likes