Line wrapping is a thing, but not in notecards.

1 files changed, 90 insertions, 22 deletions

diff --git a/1ring test README.txt b/1ring test README.txt
index 2eae355..2887e44 100644
--- a/1ring test README.txt
+++ b/1ring test README.txt
@@ -1,32 +1,100 @@
-This is a test version of onefangs 1ring thingy.  This is a prerelease test version, it's not even alpha quality yet.  Things will be broken.  There are known bugs.  There are bits not written yet.  You get to keep both parts.  I'm not happy with the speed when running under standard OpenSim, but it's fine with OpenSim-SC.  It's not documented, except the few things you'll find in this notecard.
+This is a test version of onefangs 1ring thingy.  This is a prerelease
+test version, it's not even alpha quality yet.  Things will be broken. 
+There are known bugs.  There are bits not written yet.  You get to keep
+both parts.  I'm not happy with the speed when running under standard
+OpenSim, but it's fine with OpenSim-SC.  It's not documented, except the
+few things you'll find in this notecard.
 
-1ring is a combination of things.  AO / collar / couples carry & interaction / emoter / swimmer / probably something I forgot, but those are the main ones.
+1ring is a combination of things.  AO / collar / couples carry &
+interaction / emoter / swimmer / probably something I forgot, but those
+are the main ones.
 
 RLV will be needed for the couples carry thing, and the collar.
 
-The default object is worn on the skull as a halo.  It's all full perms (or should be unless I broke that to), so you can easily resize it to be a bracelet for your wrist, or a collar for your neck, or just plain turn the prims into what ever you want.  "1ring to do it all, and in the loveness bind them." is what the text on the ring says, in Tolkien Tengwar (Elvish, sorta, go read Lord of the Rings, which inspired this theme).  Yes, "loveness" is a word, I looked it up.
-
-You can simply click on it and use it via the menus.  Some things in the menu will be upside down, that means I have not written them yet.  Some things in the menu will have little circles obscuring the letters, that means you don't have access to that (likely other people wont have access to it on YOUR device).  Hopefully it's reasonably self explanatory.
-
-The AO part is a more or less standard ZHAO II compatible AO.  You can edit the ZHAO II notecard and add the animations from your own AO, or just drag the ZHAO II card plus animations from your AO..  It currently has the Linda Kellie "RUGGED AO" loaded, which is a kinda boring male AO.  While you can turn the built in AO off, it'll be needed for those carry interactions that include moving.  For example the shoulder rides use a sitting animation for the one on the shoulders, but uses the various AO animations for the one carrying them.  So they'll walk, stand, fly, swim, all like they usually would in an AO, but with the other person sitting on their shoulders.  The AO also acts as a swimmer, if you are flying and under water, you'll swim.
-
-The AO might fight with your existing AO, but it's needed for the couples carry thing.  You can turn it on and off.
-
-The collar part is a fairly standard basic collar.  You can even use the usual method of bringing up the menu - "/1ormenu" for example (first letters of your name, and the word menu, in channel 1).  It supports RLV, but no RLV relay yet.  Leash and follow should handle border crossings and TPs fine.
-
-The couples carry & interaction part is probably the main reason people will want this.  Among other things it lets one avatar carry another.  There is no end of problems with how OpenSim and Second Life "work" that had to be worked around to get this to work at all, mostly coz it is strictly forbidden to sit on an attachment.  Even the old work around has been stopped.  I had a few options, the one that seems to work best is to use a single prim that you both sit on, it's not an actual physics prim, but I replicate most of the avatar movement system in the script.  So you can walk around, use UP arrow to fly up, fly under water to start swimming, use DOWN arrow to stop flying, or to crouch (you can crouch walk to), or to ground sit.  Walking on prims is a little unreliable , especially climbing stairs and ramps.  Both people can move, even at the same time.  Both people can adjust the position of either.  You can save the current positions.  The border crossing support is VERY clunky, and not well tested, still working on that.  I plan to add TP follow support in the future.  It currently works better if the 1ring wearer is the one selecting the pose and stuff, this will get fixed.
-
-It tries to be clever about who is in what role, but there's a swap menu (that I need to actually write code for) to take care of that (or not).
-
-The emoter part is from something I wrote long ago.  During a sub auction, the subject of emoters came up.  I declared that they are actually quite trivial to write, and wrote one in five minutes while every one watched.  Who says programming isn't a spectator sport?  Oh wait, that was me that said that.  That code is now a part of 1ring.  I always forget how it works, try saying stuff on channel 12 and 123, I think.  It seems a little broken in OpenSim 0.9, but I haven't bothered to track it down yet.  Can you tell I rarely use it?
-
-1ring has customizable menus, though it is beyond the scope of this document to describe any of it.  Have a look at the .1AOor2.theme and .1ring.theme notecards, those are the current menu theme files.  If you are clever you might be able to work out how they work.  Some of the commands are similar to MLP menu commands.  Note that if you add "POSE foo" commands, you'll also need to add matching "{foo}<0.0, 0.0, 0,0><0.0, 0.0, 0,0><0.0, 0.0, 0,0><0.0, 0.0, 0,0>" lines in the .POSITIONS notecard.  I should automate that.
-
-https://sledjhamr.org/mantisbt/project_page.php?project_id=12 is the issue tracker for 1ring.  One of these days I'll get around to adding the known issues and TODO items.  Feel free to create an account if you want to report an issue or request a feature.  Accounts need to be approved by me.
+The default object is worn on the skull as a halo.  It's all full perms
+(or should be unless I broke that to), so you can easily resize it to be
+a bracelet for your wrist, or a collar for your neck, or just plain turn
+the prims into what ever you want.  "1ring to do it all, and in the
+loveness bind them." is what the text on the ring says, in Tolkien
+Tengwar (Elvish, sorta, go read Lord of the Rings, which inspired this
+theme).  Yes, "loveness" is a word, I looked it up.
+
+You can simply click on it and use it via the menus.  Some things in the
+menu will be upside down, that means I have not written them yet.  Some
+things in the menu will have little circles obscuring the letters, that
+means you don't have access to that (likely other people wont have access
+to it on YOUR device).  Hopefully it's reasonably self explanatory.
+
+The AO part is a more or less standard ZHAO II compatible AO.  You can
+edit the ZHAO II notecard and add the animations from your own AO, or
+just drag the ZHAO II card plus animations from your AO..  It currently
+has the Linda Kellie "RUGGED AO" loaded, which is a kinda boring male AO. 
+While you can turn the built in AO off, it'll be needed for those carry
+interactions that include moving.  For example the shoulder rides use a
+sitting animation for the one on the shoulders, but uses the various AO
+animations for the one carrying them.  So they'll walk, stand, fly, swim,
+all like they usually would in an AO, but with the other person sitting
+on their shoulders.  The AO also acts as a swimmer, if you are flying and
+under water, you'll swim.
+
+The AO might fight with your existing AO, but it's needed for the couples
+carry thing.  You can turn it on and off.
+
+The collar part is a fairly standard basic collar.  You can even use the
+usual method of bringing up the menu - "/1ormenu" for example (first
+letters of your name, and the word menu, in channel 1).  It supports RLV,
+but no RLV relay yet.  Leash and follow should handle border crossings
+and TPs fine.
+
+The couples carry & interaction part is probably the main reason people
+will want this.  Among other things it lets one avatar carry another. 
+There is no end of problems with how OpenSim and Second Life "work" that
+had to be worked around to get this to work at all, mostly coz it is
+strictly forbidden to sit on an attachment.  Even the old work around has
+been stopped.  I had a few options, the one that seems to work best is to
+use a single prim that you both sit on, it's not an actual physics prim,
+but I replicate most of the avatar movement system in the script.  So you
+can walk around, use UP arrow to fly up, fly under water to start
+swimming, use DOWN arrow to stop flying, or to crouch (you can crouch
+walk to), or to ground sit.  Walking on prims is a little unreliable ,
+especially climbing stairs and ramps.  Both people can move, even at the
+same time.  Both people can adjust the position of either.  You can save
+the current positions.  The border crossing support is VERY clunky, and
+not well tested, still working on that.  I plan to add TP follow support
+in the future.  It currently works better if the 1ring wearer is the one
+selecting the pose and stuff, this will get fixed.
+
+It tries to be clever about who is in what role, but there's a swap menu
+(that I need to actually write code for) to take care of that (or not).
+
+The emoter part is from something I wrote long ago.  During a sub
+auction, the subject of emoters came up.  I declared that they are
+actually quite trivial to write, and wrote one in five minutes while
+every one watched.  Who says programming isn't a spectator sport?  Oh
+wait, that was me that said that.  That code is now a part of 1ring.  I
+always forget how it works, try saying stuff on channel 12 and 123, I
+think.  It seems a little broken in OpenSim 0.9, but I haven't bothered
+to track it down yet.  Can you tell I rarely use it?
+
+1ring has customizable menus, though it is beyond the scope of this
+document to describe any of it.  Have a look at the .1AOor2.theme and
+.1ring.theme notecards, those are the current menu theme files.  If you
+are clever you might be able to work out how they work.  Some of the
+commands are similar to MLP menu commands.  Note that if you add "POSE
+foo" commands, you'll also need to add matching "{foo}<0.0, 0.0,
+0,0><0.0, 0.0, 0,0><0.0, 0.0, 0,0><0.0, 0.0, 0,0>" lines in the
+.POSITIONS notecard.  I should automate that.
+
+https://sledjhamr.org/mantisbt/project_page.php?project_id=12 is the
+issue tracker for 1ring.  One of these days I'll get around to adding the
+known issues and TODO items.  Feel free to create an account if you want
+to report an issue or request a feature.  Accounts need to be approved by
+me.
 
 I'm sure I should have mentioned other stuff here.
 
 
 The source code is available at https://sledjhamr.org/cgit/1ring/
 
-The issue tracker is available at https://sledjhamr.org/mantisbt/project_page.php?project_id=12
+The issue tracker is available at
+https://sledjhamr.org/mantisbt/project_page.php?project_id=12