New subject: New mac user trying to update docs and learn how to "bot"

1 Jul 2013

Hi... I'm a long time editor over at LOTRO-wiki.com. 
Just beginning to learn about bots, because all of the others who have done bots in the
past have become inactive.

I am long-time Mac based, and a retired Unix Sys Admin, so the innards of OSX are not
strange to me.

I have begun to update: www.mediawiki.org/wiki/Manual:Pywikipediabot/Mac -- those first
updates are hanging waiting for someone to approve them.

Two things have jumped out at me...

1- in the SVN download there is an error:

 U   pywikipedia/externals/simplejson
Checked out external at revision 242.

Error validating server certificate for 'https://svn.toolserver.org:443':
 - The certificate is not issued by a trusted authority. Use the
   fingerprint to validate the certificate manually!
Certificate information:
 - Hostname: *.toolserver.org
 - Valid: from Sun, 26 May 2013 09:34:24 GMT until Wed, 28 May 2014 17:08:01 GMT
 - Issuer: GeoTrust, Inc., US
 - Fingerprint: bf:35:7f:3e:62:4b:89:6c:bc:39:c9:c3:38:81:9e:53:26:43:be:f4
(R)eject, accept (t)emporarily or accept (p)ermanently? p
svn: warning: Error handling externals definition for
'pywikipedia/externals/pycolorname':
svn: warning: OPTIONS of
'https://svn.toolserver.org/svnroot/drtrigon/externals/pycolorname': Could not
read status line: connection was closed by server (https://svn.toolserver.org)

Fetching external item into 'pywikipedia/externals/opencv'

The first error is Apple's Gatekeeper objecting to the Certificate... no big deal.

However, on accepting the certificate, the SVN throws an error attempting 
'pywikipedia/externals/pycolorname'

2- In the instructions in Manual:Pywikipediabot/Mac, the first thing they have you do is
to edit "user-config.py"

This file does not exist in the current SVN download.
======
The included README says nothing useful.

The README file in the docs directory says the following:

"This directory/folder is empty when you get the package. Change to the
parent directory (containing 'Doxyfile' and 'setup.cfg') and run the
release maintenance script with 'python maintenance/release.py' to fill
this directory with documentation data."

As I am attempting to document the step-by-step process of installing
"pywikipediabot" on the Mac, the immediate question is...

Is the above instruction the FIRST thing to be done when a virgin copy of
pywikipediabot" is downloaded from the SVN.
i.e. to a system which has never had it installed before... and therefore has no
user-config.py file to edit.

OR... should "setup.cfg" be modified to create it?

OR (based on comments in CONTENTS) should "generate_user_files.py"  -- be run
first?

OR "config.py"?

T.T.F.N.
William H. Magill                                                            

magill(a)icloud.com
magill(a)mac.com
whmagill(a)gmail.com