From 8ff7c4bc8bd8c6a801523032e960f5dd1f8dee80 Mon Sep 17 00:00:00 2001
From: Rick L Bird <nveid@yahoo.com>
Date: Sat, 7 May 2011 01:24:26 -0400
Subject: [PATCH] Documented our @attribute command behavior.

Fixes #260
---
 game/txt/hlp/cobra_cmd.hlp | 29 +++++++++++++++++++++++------
 1 file changed, 23 insertions(+), 6 deletions(-)

diff --git a/game/txt/hlp/cobra_cmd.hlp b/game/txt/hlp/cobra_cmd.hlp
index c686239..b661ed4 100644
--- a/game/txt/hlp/cobra_cmd.hlp
+++ b/game/txt/hlp/cobra_cmd.hlp
@@ -378,9 +378,12 @@ See also: @atrchown, ATTRIBUTES, NON-STANDARD ATTRIBUTES, LOCKING
   going through them. 
 
 See also: @success, @osuccess, get, @lock, EXITS, ACTION LISTS
-& @attribute
+& @attribute[
   @attribute <attrib>
-  @attribute/access[/retroactive] <attrib> = <flag list or "none">
+  @attribute/info <attrib>
+  @attribute[/access][/retroactive] <attrib> = <flag list or "none">
+  @attribute/lock[/write][/read] <attribute> = <lock>
+  (/Defaults switch may be used with all the above as well)
   @attribute/delete <attrib>
   @attribute/rename <attrib> = <new name>
 
@@ -390,12 +393,22 @@ See also: @success, @osuccess, get, @lock, EXITS, ACTION LISTS
   of &<attrib>, and which, when set, has a predefined set of
   initial permissions.
 
-  *** Unlike TinyMUSH, changes to the PennMUSH attribute table
-  *** are not saved across shutdowns. Use these commands from
-  *** God's @startup to insure they are run at each startup.
+  Info, Lock, and Access switches all take the DEFAULTS switch as
+  well.  In which this views or sets the behavior on a generic 
+  "catchall" default attribute.  In this behavior as well, the 
+  general behavior of the location of <attrib> should actually be 
+  what would normally be the second argument; in the case of INFO or
+  no switch no argument is necesarry. 
 
-  Used without switches, @attribute shows info about a standard attrib.
+  The attribute table is not saved across shutdowns. Use these commands 
+  upon startup to re-activate them.
 
+  Used without switches, @attribute defaults to the INFO switch displaying
+  informationg about the attribute.  The "default" catchall attribute info
+  is not displayable if no access or lock information has been set on it.
+  (Continued in 'help @attribute2')
+
+& @attribute2
   @attribute/access adds a new standard attribute into the table,
   associating it with the given space-separated list of full flag names.
   See 'help @set' for possible flags. A flag list of "none" removes
@@ -403,6 +416,10 @@ See also: @success, @osuccess, get, @lock, EXITS, ACTION LISTS
   If the /retroactive switch is added, the flags are assigned to every copy
   of the attribute that already exists in the database.
 
+  @attribute/lock either sets a global read or write lock upon an attribute.
+  The read or write lock itself is further specified by adding the /read or
+  /write switches. 
+
   @attribute/delete removes a standard attribute from the table.
   @attribute/rename renames a standard attribute. 
 
-- 
2.30.2