fixes

docs/README.commands

@@ -63,13 +63,14 @@ format we here at Debian love so much, with stanzas like
 ** create-bs
 Options: Name (R)
          Base-Suite (R)
-         Description: (R)
+         Description (R)
          Package (O)
-         Master: (O)
-         Uploader: (O)
-         Auto-Update: (O)
-         Breaks: (O)
-         Depends: (O)
+         Master (O)
+         Uploader (O)
+         Auto-Update (O)
+         Breaks (O)
+         Depends (O)
+         Architecture (O)
 
 Create a new bikeshed, based on given base-suite. It can initially
 import one or more packages given by the Package option from the base
@@ -84,8 +85,8 @@ jessie, ...)
 
 Description: A one-line description of the bikeshed.
 
-Package: A name of a package to import from the base-suite. Repeat as
-often as needed.
+Package: A name of a source package to import from the base-suite.
+Repeat as often as needed.
 
 Master: The bikeshed will default to one master user (the uploader of
 the commands file), this option can add as many more as wanted.
@@ -113,6 +114,10 @@ Breaks and Depends are (currently) only advisory and only used to
 output that information on a webpage. Tools may implement better
 support for them in the future.
 
+Architecture: If this is unset the bikeshed will have the same
+architectures as the base suite. Otherwise list each architecture
+needed in the bikeshed. (source and all are automatically added).
+
 #+BEGIN_EXAMPLE
 Action: create-bs
 Name: theoneandonly
@@ -135,12 +140,12 @@ Package: mailfilter
 Package: emacs24
 Package: xz-utils
 Package: openvpn
-Master: 1234567890ABCDEF1234567890ABCDEF
-Master: 234567890ABCDEF1234567890ABCDEF1
-Uploader: ABCDEF1234567890ABCDEF1234567890
-Uploader: BCDEF1234567890ABCDEF1234567890A
-Uploader: CDEF1234567890ABCDEF1234567890AB
-Uploader: DEF1234567890ABCDEF1234567890ABC
+Master: 1234567890ABCDEF1234567890ABCDEF12345678
+Master: 234567890ABCDEF1234567890ABCDEF123456789
+Uploader: ABCDEF1234567890ABCDEF123456789012345678
+Uploader: BCDEF1234567890ABCDEF1234567890ABCDEF123
+Uploader: CDEF1234567890ABCDEF1234567890ABCDEF1234
+Uploader: DEF1234567890ABCDEF1234567890ABCDEF12345
 #+END_EXAMPLE
 Create the ohthisisevenbetter bikeshed, this time based on
 experimental (rc-buggy) importing not only mailfiter but also 3 more
@@ -159,16 +164,17 @@ Any master of a bikeshed can do this.
 
 ** modify-bs
 Options: Name (R)
-         Breaks: (O)
-         Depends: (O)
+         Description (O)
+         Breaks (O)
+         Depends (O)
 
-Modify the breaks and depends settings of a bikeshed, see the
+Modify the description, breaks and depends settings of a bikeshed, see the
 create-bs description for their meanings.
 
 ** access-bs
 Options: Name (R)
-         Master: (O)
-         Uploader: (O)
+         Master (O)
+         Uploader (O)
 
 Modify the access list of a bikeshed. The list of Master/Upload, if
 given, completely overwrite the current values of the bikeshed, so a
@@ -178,13 +184,13 @@ included into the Master list, even if they are not listed anymore.
 
 ** add-bs
 Options: Name (R)
-         Package: (R)
+         Package (R)
 
 Add another package from the bikesheds base-suite to the bikeshed.
 
 ** rm-bs
 Options: Name (R)
-         Package: (R)
+         Package (R)
 
 Remove a package from the bikeshed. This can apply to packages
 uploaded to the bikeshed and to packages imported from the base-suite.