More text

docs/README.commands

@@ -67,6 +67,8 @@ Options: Name (R)
          Master: (O)
          Uploader: (O)
          Auto-Update: (O)
+         Breaks: (O)
+         Depends: (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
@@ -98,6 +100,12 @@ Auto-Update: True or False. Automatically update packages imported
 from the base suite, whenever they get updated in the base suite. This
 may possibly break packages uploaded directly to the bikeshed.
 
+Breaks: Name of another bikeshed which is broken by this, that is,
+both together should not ever be used on one system.
+
+Depends: Name of another bikeshed which this one depends on, that is,
+both should be used together.
+
 #+BEGIN_EXAMPLE
 Action: create-bs
 Name: theoneandonly
@@ -134,15 +142,64 @@ bikeshed. None of the imported packages will be automagically updated
 from an upload to the base suite.
 
 ** drop-bs
+Options: Name (R)
+
+Drop a bikeshed. This is irreversible, be careful.
+
+Any master of a bikeshed can do this.
+
 ** modify-bs
+Options: Name (R)
+         Breaks: (O)
+         Depends: (O)
+
+Modify the breaks and depends settings of a bikeshed, see the
+create-bs description for their meanings.
+
 ** access-bs
+Options: Name (R)
+         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
+full list has to be given. As a safety precaution to not fully loose
+access to a bikeshed, the uploader of the commands file will be
+included into the Master list, even if they are not listed anymore.
+
 ** add-bs
+Options: Name (R)
+         Package: (R)
+
+Add another package from the bikesheds base-suite to the bikeshed.
+
 ** rm-bs
+Options: Name (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.
+
 ** mergeback-bs
+Options: Name (R)
+
+If the base-suite of a bikeshed supports the "mergeback" option, this
+will try to "migrate" all packages from the bikeshed into the
+base-suite. The packages will have to follow all the usual constraints
+that apply to the base suite during normal package uploads (say,
+version constraints).
+
 ** list-bs
+Options: None
+
+List all bikesheds and the access level
+
 ** info-bs
+Options: Name (R)
+
+Returns information about the named bikeshed in a format valid for the
+create-bs command, so see there for the format/options outputted.
 
-[2015-09-17 Thu 10:50]
 * Full example
 #+BEGIN_EXAMPLE
 Archive: ftp.debian.org