1 files changed, 146 insertions, 17 deletions

diff --git a/1ring test README.txt b/1ring test README.txt
index 8da6819..d18a75d 100644
--- a/1ring test README.txt
+++ b/1ring test README.txt
@@ -1,13 +1,13 @@
-This is a test version of onefangs 1ring thingy.  This is a prerelease
+This is a test version of onefangs 1ring thingy.  This is a pre-release
 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
+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 & swimmer / collar / couples carry
+& interaction / emoter / smiler / poser / probably something I forgot,
+but those are the main ones.
 
 RLV will be needed for the couples carry thing, and the collar.
 
@@ -25,6 +25,9 @@ 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.
 
+AO & swimmer
+---------------------
+
 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
@@ -40,6 +43,9 @@ 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.
 
+Collar
+---------
+
 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,
@@ -50,8 +56,12 @@ the leash connect here" function, it is a helper script for the border
 crossing and TP following features.  BTW, it is compatible with ***insert
 the standard leash holder names here***.
 
+Couples carry & interaction
+----------------------------------------
+
 The couples carry & interaction part is probably the main reason people
-will want this.  Among other things it lets one avatar carry another. 
+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
@@ -68,8 +78,14 @@ 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).
+It tries to be clever about who is in what role, but there's a swap
+button to take care of that.
+
+Note that you can walk off sim, but steering then becomes horrid. 
+Rotations are hard, m'kay.
+
+Emoter
+----------
 
 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
@@ -78,8 +94,25 @@ 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.  You
 say something in channel 12 or 123 -
 
-/12 something     Script owners first name is used for a "/me something"
-emote. /123 someone something     someone: something
+/12 something
+    Script owners first name is used for a "/me something" emote.
+/123 someone something
+    someone: something
+
+Smiler
+----------
+
+Randomly changes your smile every now and then.  Planning to do more.
+
+Poser
+-------
+
+Single person animations are also available.  There are several
+categories, and a "left overs" category that is just any animation that
+isn't part of something else.
+
+Menus
+----------
 
 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
@@ -87,6 +120,104 @@ document to describe any of it.  Have a look at the .1AOor2.theme and
 are clever you might be able to work out how they work.  Some of the
 commands are similar to MLP menu commands.
 
+The common menu buttons are -
+▲ Exit                Exits out of the current menu, back to the previous menu.
+◄ Previous      If a menu is too long for the stupid limitations of LL menu system, it's broken into pages.  Go to the previous page.
+Next ►              Go to the next page.
+☐   ▣                    Any menu item with one of these squares is something you can turn on and off.
+                              Do I have to say that the empty square ☐ means off, the one with a solid square in it ▣ means on?
+
+The default menus are -
+access...           Access control for everything, like setting who owns your collar and similar.
+clothes...          Put on or take off clothes.  Uses #RLV inventory folder, and RLV.
+couples...         Couples carry & interactions menu.
+leash...              Collar leash menu.
+mood...             Non functional mood adjustment menu for the smiler.
+moves...            Control your speed, go places, sit, AO, teleport.
+other...              Various things, most of which are not written.
+PANIC                 Release you from everything.
+poses...              Individual poses.
+restrictions... Control RLV restrictions, mostly not written.
+sound...            Control sound, mostly not written.
+
+Menu - access...
+-------------------------
+Add or remove a boss / trustee / or blocking someone.
+Set group or public access.
+Control the built in RLV relay.  (Did I actually write that?)
+Run away from your current set of bosses / trustees.
+List all these details.
+
+Menu - clothes...
+------------------------
+RLV is needed for any of this to work.
+outfits...       is the #RLV inventory folder, where you can put on and take off outfits.
+attached... is for removing attachments.  Note that RLV does not tell scripts WHAT is attached, just what attachment points have                                  something.  For mesh avatars this is a big problem.  Are you about to remove their skirt, or their legs?  Be careful.
+worn...          is for removing "system" clothing.  Might work on BoM clothes to.
+
+Menu - couples...
+-------------------------
+adjust...       For adjusting the positions of the couple.
+save                Save the adjusted positions.  Makes a backup of the .POSITIONS note card first.
+sync                May or may not resynchronize poses that have drifted out of sync.
+swap...          Swap menu.  I may or may not have written this.  lol
+
+The others are collections of couples things you can do.  Currently
+includes dances, hugs, hugglefucks, kisses, lay cuddles, rides, sit
+cuddles, spank, wash, and XXX.
+
+You first select the thing you want to do, then who you want to do it
+with.  If that's an NPC, they automatically join you, otherwise they are
+asked if they want to join you.  If OhSilly Threat System lets you, and
+you have RLV enabled, them the thing happens.  Otherwise one or both of
+you needs to sit on the big yellow heart manually.  If you are not
+allowed to rez things where you are, the big yellow heart doesn't appear. 
+The other person might need to sit first.
+
+Both people can use normal movement keys to move you around.  While
+adjusting, the movement keys will adjust instead.
+
+You can both hop on and off the big yellow heart.  Note that if there are
+two people on it, one of them has to be the 1ring wearer, for technical
+reasons that I blame LL for.  So the one that is not wearing 1ring can
+hop off, and someone else can hop on.
+
+Menu - leash...
+----------------------
+Grab their leash, leash them to something / someone, unleash them, adjust
+the length of the leash, the size of the leash, and the texture of the
+leash.
+
+Menu - moves...
+-----------------------
+Adjust your speed slower, faster, or back to normal.  This applies to AO
+and couples movement.
+Follow someone.  Goto someone / something.  Stop following them.
+Sit on something.  Stand up.
+AO... -
+    Turn AO on or off.
+    Various types of AO menus that are not currently written.
+    Turn on and off the various OhSilly Threat Level system OpenSim functions that might cause error messages.
+        NOTE - 1ring tries to detect these, but OpenSim devs are smoking the wrong drugs.  Or something.
+
+Menu - other...
+---------------------
+Only thing that works here is hide, for hiding 1ring.
+
+Menu - poses...
+---------------------
+Various sub menus for various individual poses.  Most are built in viewer animations.
+left overs...         Any animations that are in 1ring but not used by oter parts of the system.
+                                 So you can just drop animations in, and they'll turn up here.
+dancing...          Built in dance moves, that don't loop.  Blame LL I suspect.
+submissive...    OpenCollar sub poses.
+viewer animations...  All built in viewer animations.
+The other sub menus I hope are self explanatory.
+
+
+Other stuff
+---------------
+
 https://sledjhamr.org/mantisbt/project_page.php?project_id=12 is the
 issue tracker for 1ring. Feel free to create an account if you want to
 report an issue or request a feature.  Accounts need to be approved by
@@ -97,12 +228,10 @@ I'm sure I should have mentioned other stuff here.
 The source code is available at https://sledjhamr.org/cgit/1ring/
 
 
-The soap bubble image was downloaded from
-https://www.pngall.com/soap-bubbles-png/download/26145 From the
-collection at https://www.pngall.com/soap-bubbles-png License Info:
-Creative Commons 4.0 BY-NC  I think "Rojal"
-https://www.pngall.com/author/rojal was the creator, it doesn't really
-specify.
+The soap bubble image was downloaded from https://www.pngall.com/soap-bubbles-png/download/26145
+From the collection at https://www.pngall.com/soap-bubbles-png
+License Info: Creative Commons 4.0 BY-NC  I think "Rojal" https://www.pngall.com/author/rojal was the creator, it doesn't really specify.
 
 Most animations are from  Linda Kelly, some are from OpenCollar.  The
-leash textures are from OpenCollar.
+leash textures are from OpenCollar.  Most of the individual poses are
+built into the viewers.