wow/ouroloot: verbage.lua comparison

comparison verbage.lua @ 103:dc8a23a47b03

- Add 'chatprefix' function for building loot line jump links, and a 'PCFPrint' method which displays them. - Make use of them for local and remote notifications, boss kills, and manual insertions. - Document the additional slash commands and args feature from previous release. Oops. (Text mostly copied from webpage announcement.)

author	Farmbuyer of US-Kilrogg <farmbuyer@gmail.com>
date	Sun, 05 Aug 2012 07:26:06 +0000
parents	a57133ee3c9b
children	35b55c6f5551

comparison

equal deleted inserted replaced

-:fe04f5c4114a
+:dc8a23a47b03
 comments, and suggestions are welcome at the project page:
 <www.curse.com/addons/wow/ouroloot>
-or send them to <farmbuyer@gmail.com>.
+or send them to <farmbuyer@gmail.com> in non-HTML format.
 ]]
 T.basic = [[
 The </ouroloot> command opens this display.  The buttons
 on the right side control operation and are mostly self-explanatory.  Hovering over
 list.  Read those first before expanding the categories or you'll miss stuff.
 ]]
 T.basic_loot = [[
 A "loot row" in the first tab has three columns:  the item, the recipient, and any
-extra notes.  The recipient's class icon is displayed by their names, if class
+extra notes.
-information is available at the time.
 <Mouse Hover>
-Hovering the mouse over the first column will display the item in a tooltip.
+Hovering the mouse over the first column will display the item tooltip.
 Hovering over the second column will display a tooltip with the loot that person
 has received.  If they've won more than 10 items, the list is cut off with '...'
 at the end; to see the full list, use the right-click +Show only this player> option
 instead.
 <Right-Click>
 Right-clicking a loot row shows a dropdown menu.
 Right-clicking in the first or third columns will display options for special
-treatment of that loot entry (marking as offspec, etcetera).  Using any of those
+treatment of that loot entry (e.g., marking as offspec).  Using any of those
-options will change the text in the third column (which will then affect the text
+options will change the text in the third column, which will then affect the
-in the generated tabs, such as forum markup).
+text in the generated tabs, such as forum markup.
 Right-clicking in the second column allows you to temporarily remove all other
 players from the loot display.  Use the reset button in the lower-right corner to
 restore the display to normal.  The menu also allows you to +reassign> loot from
 one player to another; if the new recipient is not in the raid group at the time,
 +Clear Older> deletes history information older than a certain threshold (by
 default, 5 loot events).  It is another good periodic maintenance step, but
 does not discard as much data as the other actions.
-Using +Reassign to...> will also move the item between player histories.  The timestamp
+From the right-click menu on the main tab, using +Reassign to...> will also
-will not be changed; it will "always have been" received by the new recipient.
+move the item between player histories.  The timestamp will not be changed;
+it will "always have been" received by the new recipient.  Using
-Using +Mark as disenchanted> or +Mark as guild vault> will remove the item from
++Mark as disenchanted> or +Mark as guild vault> will remove the item from
-history altogether.  Remarking such an item as +normal> or +offspec> will replace
+history altogether.  Remarking such an item as +normal> or +offspec> will
-the item back into the player's history.
+replace the item back into the player's history.
 Note:  the first time you display the histories during a game session, you will
 likely see several items listed as +UNKNOWN>.  This is not a bug; these items are
 simply not in your local game cache.  WoW will automatically retrieve the missing
 data after several seconds, but the display will not update until the next time
 across play sessions, so the +UNKNOWN> entries will pop up from time to time.
 ]]
 T.tips = [[
 The |cffff8000[Ouro Loot]|r "legendary item" displayed at the start of all
-chat messages is a clickable link.  Clicking opens the main display.  An option
+chat messages is a clickable link.  Clicking opens the main display, and if
-on the <Options> tab will cause a message (and thus, the clickable link) to be
+possible will jump to and/or highlight the relevent data which caused the
-printed after a boss kill,
+associated chat message to be printed in the first place.
-mostly for lazy loot trackers who don't like typing slash commands to open windows.
+The "Be chatty" options on the <Options> tab will cause a chat message to be
+printed after various events, thus providing a way to quickly view them.
 If you are broadcasting to somebody else who is tracking, you should probably be
 using the same threshold.  If yours is lower, then some of the loot you broadcast
 to him will be ignored.  If yours is higher, then you will not be sending information
 that he would have recorded.  The "correct" setting depends on what your guild wants
 default used to be </loot> until that became a builtin command in MoP.
 If you give an unrecognized argument to a slash command, it will
 search the tab titles left to right for a title beginning with the same letters as
 the argument, and open the display to that tab.  For example, <"/ol a"> would
-open the <Attendance> tab, and <"/ol ad"> would open the <Advanced> tab.  If
+open the <Attendance> tab, and <"/ol o"> would open the <Options> tab.  If
 you had added a theoretical <EQDKP> tab, then <"/ol eq"> would be the fastest
-way to see it.
+way to see it.  Only enough text to be unambiguous is required, and all of it
+is case-insensitive.
+Some tabs will accept additional text after the tab title, and try to Do The
+Right Thing.  For example, <"/ol history blah"> will search for a player named
+"blah", and if found, will act as if you had clicked on that row, switching
+the display to every loot received by that player.  The same unambiguous prefix
+searching is used for names as for tab titles, so <"/ol hi farm"> is enough to
+trigger Farmbuyer's history display (as long as nobody named Farmville joins
+the raid), and so forth.
 The </ouroloot> command can take arguments to do things without going through
 the UI.  Parts given in *(angle brackets)* are required, parts in [square brackets]
 are optional:
++help>:  opens the UI to the help tab|r
 +broadcast>/+bcast>:  turns on rebroadcasting|r
 +on [T]>:  turns on full tracking, optionally setting threshold to T|r
 +off>:  turns off everything|r
 +thre[shold] T>:  sets tracking threshold to T|r
++ping>:  same as clicking "Ping!" on the Options tab|r
 +list>:  prints saved text names and numbers|r
 +save *(your set name)*>:  saves texts as "your set name"|r
 +restore *(N)*>:  restores set number N|r
 +delete *(N)*>:  deletes set number N|r
-+help>:  opens the UI to the help tab|r
 +toggle>:  opens or closes the UI (used mostly in automated wrappers)|r
++fix ?>:  lists the available automated data integrity fixes|r
 If you use the slash commands to enable tracking or set loot thresholds, you can
 give numbers or common names for the threshold.  For example, "0", "poor", "trash",
 "gray"/"grey" are all the same, "4", "epic", "purple" are the same, and so on.
 		else
 			left:SelectByValue("basic")
 		end
 	end
-	local noob = [[
+	addon:register_tab_control_AT_END ("help", [[Help]],
+		[[Instructions, reminders, and tips for non-obvious features]],
+		tabs_OGS, [[
 Every tab across the top also gets its own special buttons here in the lower
 right, under the same name as the tab.  Some controls do not become visible
-until that tab has data to work with.]]
+until that tab has data to work with.]])
-	addon:register_tab_control_AT_END ("help", [[Help]],
-		[[Instructions, reminders, and tips for non-obvious features]],
-		tabs_OGS, --[[opt_noobtip=]]noob)
 end
 -- vim:noet

Mercurial > wow > ouroloot

comparison verbage.lua @ 103:dc8a23a47b03