Merge pull request #2583 from mvidner/newbie-1

Description improvements found by first time user

README.md

@@ -40,12 +40,13 @@ See the [docs](/docs) directory or a specific tool directory for specific tool d
 
 If working on an `osc` plugin create symlinks for the plugin and `osclib` in either `~/.osc-plugins` or `/usr/lib/osc-plugins`. For example to install the _staging_ plugin do the following.
 
+    mkdir -p ~/.osc-plugins
     ln -sr ./osc-staging.py ./osclib ~/.osc-plugins
 
 It can also be useful to work against a development copy of `osc` either to utilize new features or to debug/fix functionality. To do so one must place the development copy in the path to be loaded and utilize the wrapper script if working on `osc` plugins. One method to accomplish this is shown below.
 
     # outside of openSUSE-release-tools checkout
-    git clone git clone https://github.com/openSUSE/osc.git
+    git clone https://github.com/openSUSE/osc.git
 
     # inside openSUSE-release-tools checkout
     # note the ending /osc which points to the osc directory within the checkout

build-fail-reminder.py

@@ -220,7 +220,7 @@ Kind regards,
         SendMail(logger, project, sender, to, fullname, subject, text)
 
 if __name__ == '__main__':
-    parser = argparse.ArgumentParser(description='boilerplate python commmand line program')
+    parser = argparse.ArgumentParser(description='Send e-mails about packages failing to build for a long time')
     parser.add_argument('-A', '--apiurl', metavar='URL', help='API URL')
     parser.add_argument("--dry", action="store_true", help="dry run")
     parser.add_argument("--debug", action="store_true", help="debug output")

checknewer.py

@@ -11,7 +11,11 @@ import solv
 pool = solv.Pool()
 args = sys.argv[1:]
 if len(args) < 2:
-    print("usage: checknewer NEWREPO OLDREPO1 [OLDREPO2...]")
+    print("Check if all packages in a repo are newer than all other repos")
+    print()
+    print("Usage: checknewer NEWREPO OLDREPO1 [OLDREPO2...]")
+    print()
+    print("A repo is one of: foo.solv, primary.xml, packages (susetags)")
     sys.exit(1)
 
 firstrepo = None

deptool.py

@@ -8,7 +8,7 @@ import logging
 import cmdln
 
 from fnmatch import fnmatch
-from ConfigParser import SafeConfigParser
+from configparser import SafeConfigParser
 import solv
 import rpm