From 94c176818173bc08852fda4667880b76d2d90742 Mon Sep 17 00:00:00 2001 From: Mikhail Sobolev Date: Tue, 28 Oct 2014 16:38:18 +0200 Subject: [PATCH] make example URLs to use example.{com,org,net} * in some cases URLs pointed to some real URL (e.g. in case of SourceForge) * in some cases URLs pointed to potentially used domains --- master/docs/manual/cfg-buildsteps.rst | 6 ++--- master/docs/manual/cfg-global.rst | 2 +- master/docs/manual/cfg-schedulers.rst | 2 +- master/docs/manual/cfg-statustargets.rst | 30 ++++++++++++------------ master/docs/manual/cmdline.rst | 4 ++-- master/docs/manual/customization.rst | 2 +- 6 files changed, 23 insertions(+), 23 deletions(-) diff --git a/master/docs/manual/cfg-buildsteps.rst b/master/docs/manual/cfg-buildsteps.rst index fde0add9128..b863124364f 100644 --- a/master/docs/manual/cfg-buildsteps.rst +++ b/master/docs/manual/cfg-buildsteps.rst @@ -538,14 +538,14 @@ The :bb:step:`CVS` build step performs a `CVS `_ che from buildbot.plugins import steps factory.addStep(steps.CVS(mode='incremental', - cvsroot=':pserver:me@cvs.sourceforge.net:/cvsroot/myproj', + cvsroot=':pserver:me@cvs.example.net:/cvsroot/myproj', cvsmodule='buildbot')) This step takes the following arguments: ``cvsroot`` (required): specify the CVSROOT value, which points to a CVS repository, probably on a remote machine. - For example, if Buildbot was hosted in CVS then the cvsroot value you would use to get a copy of the Buildbot source code might be ``:pserver:anonymous@cvs.sourceforge.net:/cvsroot/buildbot``. + For example, if Buildbot was hosted in CVS then the cvsroot value you would use to get a copy of the Buildbot source code might be ``:pserver:anonymous@cvs.example.net:/cvsroot/buildbot``. ``cvsmodule`` (required): specify the cvs ``module``, which is generally a subdirectory of the :file:`CVSROOT`. @@ -829,7 +829,7 @@ For example:: from buildbot.plugins import steps, util - factory.addStep(steps.Repo(manifestURL='git://mygerrit.org/manifest.git', + factory.addStep(steps.Repo(manifestURL='git://gerrit.example.org/manifest.git', repoDownloads=util.FlattenList([ util.RepoDownloadsFromChangeSource(), util.RepoDownloadsFromProperties("repo_downloads") diff --git a/master/docs/manual/cfg-global.rst b/master/docs/manual/cfg-global.rst index 4411d47341d..78e65d78faf 100644 --- a/master/docs/manual/cfg-global.rst +++ b/master/docs/manual/cfg-global.rst @@ -60,7 +60,7 @@ MySQL .. code-block:: python - c['db_url'] = "mysql://user:pass@somehost.com/database_name?max_idle=300" + c['db_url'] = "mysql://user:pass@example.com/database_name?max_idle=300" The ``max_idle`` argument for MySQL connections is unique to Buildbot, and should be set to something less than the ``wait_timeout`` configured for your server. This controls the SQLAlchemy ``pool_recycle`` parameter, which defaults to no timeout. diff --git a/master/docs/manual/cfg-schedulers.rst b/master/docs/manual/cfg-schedulers.rst index f1157717869..7fdd9c4eb35 100644 --- a/master/docs/manual/cfg-schedulers.rst +++ b/master/docs/manual/cfg-schedulers.rst @@ -47,7 +47,7 @@ There are several common arguments for schedulers, although not all are availabl sched = Scheduler(..., properties = { - 'owner': ['zorro@company.com', 'silver@company.com'] + 'owner': ['zorro@example.com', 'silver@example.com'] }) ``fileIsImportant`` diff --git a/master/docs/manual/cfg-statustargets.rst b/master/docs/manual/cfg-statustargets.rst index 44dbfbe86ef..8e6f19fb921 100644 --- a/master/docs/manual/cfg-statustargets.rst +++ b/master/docs/manual/cfg-statustargets.rst @@ -87,20 +87,20 @@ This form does not send mail to individual developers (and thus does not need th If your SMTP host requires authentication before it allows you to send emails, this can also be done by specifying ``smtpUser`` and ``smptPassword``:: - mn = status.MailNotifier(fromaddr="myuser@gmail.com", + mn = status.MailNotifier(fromaddr="myuser@example.com", sendToInterestedUsers=False, extraRecipients=["listaddr@example.org"], - relayhost="smtp.gmail.com", smtpPort=587, - smtpUser="myuser@gmail.com", + relayhost="smtp.example.com", smtpPort=587, + smtpUser="myuser@example.com", smtpPassword="mypassword") If you want to require Transport Layer Security (TLS), then you can also set ``useTls``:: - mn = status.MailNotifier(fromaddr="myuser@gmail.com", + mn = status.MailNotifier(fromaddr="myuser@example.com", sendToInterestedUsers=False, extraRecipients=["listaddr@example.org"], - useTls=True, relayhost="smtp.gmail.com", - smtpPort=587, smtpUser="myuser@gmail.com", + useTls=True, relayhost="smtp.example.com", + smtpPort=587, smtpUser="myuser@example.com", smtpPassword="mypassword") .. note:: @@ -346,7 +346,7 @@ MailNotifier arguments Most of the time you can use a simple Domain instance. As a shortcut, you can pass as string: this will be treated as if you had provided ``Domain(str)``. - For example, ``lookup='twistedmatrix.com'`` will allow mail to be sent to all developers whose SVN usernames match their twistedmatrix.com account names. + For example, ``lookup='example.com'`` will allow mail to be sent to all developers whose SVN usernames match their ``example.com`` account names. See :file:`buildbot/status/mail.py` for more details. Regardless of the setting of ``lookup``, ``MailNotifier`` will also send mail to addresses in the ``extraRecipients`` list. @@ -817,7 +817,7 @@ The GitHub hook is simple and takes no options. change_hook_dialects={ 'github' : True })) With this set up, add a Post-Receive URL for the project in the GitHub administrative interface, pointing to ``/change_hook/github`` relative to the root of the web status. -For example, if the grid URL is ``http://builds.mycompany.com/bbot/grid``, then point GitHub to ``http://builds.mycompany.com/bbot/change_hook/github``. +For example, if the grid URL is ``http://builds.example.com/bbot/grid``, then point GitHub to ``http://builds.example.com/bbot/change_hook/github``. To specify a project associated to the repository, append ``?project=name`` to the URL. Note that there is a standalone HTTP server available for receiving GitHub notifications, as well: :file:`contrib/github_buildbot.py`. @@ -839,7 +839,7 @@ And create a file ``changehook.passwd`` user:password -Then, create a GitHub service hook (see https://help.github.com/articles/post-receive-hooks) with a WebHook URL like ``http://user:password@builds.mycompany.com/bbot/change_hook/github``. +Then, create a GitHub service hook (see https://help.github.com/articles/post-receive-hooks) with a WebHook URL like ``http://user:password@builds.example.com/bbot/change_hook/github``. See the `documentation `_ for twisted cred for more option to pass to ``change_hook_auth``. @@ -856,7 +856,7 @@ The BitBucket hook is as simple as GitHub one and it also takes no options. change_hook_dialects={ 'bitbucket' : True })) When this is setup you should add a `POST` service pointing to ``/change_hook/bitbucket`` relative to the root of the web status. -For example, it the grid URL is ``http://builds.mycompany.com/bbot/grid``, then point BitBucket to ``http://builds.mycompany.com/change_hook/bitbucket``. +For example, it the grid URL is ``http://builds.example.com/bbot/grid``, then point BitBucket to ``http://builds.example.com/change_hook/bitbucket``. To specify a project associated to the repository, append ``?project=name`` to the URL. Note that there is a satandalone HTTP server available for receiving BitBucket notifications, as well: :file:`contrib/bitbucket_buildbot.py`. @@ -874,7 +874,7 @@ To protect URL against unauthorized access you should use ``change_hook_auth`` o c['status'].append(html.WebStatus(..., change_hook_auth=["file:changehook.passwd"])) -Then, create a BitBucket service hook (see https://confluence.atlassian.com/display/BITBUCKET/POST+Service+Management) with a WebHook URL like ``http://user:password@builds.mycompany.com/bbot/change_hook/bitbucket``. +Then, create a BitBucket service hook (see https://confluence.atlassian.com/display/BITBUCKET/POST+Service+Management) with a WebHook URL like ``http://user:password@builds.example.com/bbot/change_hook/bitbucket``. Note that as before, not using ``change_hook_auth`` can expose you to security risks. @@ -950,7 +950,7 @@ The GitLab hook is as simple as GitHub one and it also takes no options. )) When this is setup you should add a `POST` service pointing to ``/change_hook/gitlab`` relative to the root of the web status. -For example, it the grid URL is ``http://builds.mycompany.com/bbot/grid``, then point GitLab to ``http://builds.mycompany.com/change_hook/gitlab``. +For example, it the grid URL is ``http://builds.example.com/bbot/grid``, then point GitLab to ``http://builds.example.com/change_hook/gitlab``. The project and/or codebase can also be passed in the URL by appending ``?project=name`` or ``?codebase=foo`` to the URL. These parameters will be passed along to the scheduler. @@ -968,7 +968,7 @@ To protect URL against unauthorized access you should use ``change_hook_auth`` o change_hook_auth=["file:changehook.passwd"] )) -Then, create a GitLab service hook (see https://your.gitlab.server/help/web_hooks) with a WebHook URL like ``http://user:password@builds.mycompany.com/bbot/change_hook/gitlab``. +Then, create a GitLab service hook (see https://your.gitlab.server/help/web_hooks) with a WebHook URL like ``http://user:password@builds.example.com/bbot/change_hook/gitlab``. Note that as before, not using ``change_hook_auth`` can expose you to security risks. @@ -985,7 +985,7 @@ The Gitorious hook is as simple as GitHub one and it also takes no options. )) When this is setup you should add a `POST` service pointing to ``/change_hook/gitorious`` relative to the root of the web status. -For example, it the grid URL is ``http://builds.mycompany.com/bbot/grid``, then point Gitorious to ``http://builds.mycompany.com/change_hook/gitorious``. +For example, it the grid URL is ``http://builds.example.com/bbot/grid``, then point Gitorious to ``http://builds.example.com/change_hook/gitorious``. .. warning:: @@ -1001,7 +1001,7 @@ To protect URL against unauthorized access you should use ``change_hook_auth`` o change_hook_auth=["file:changehook.passwd"] )) -Then, create a Gitorious web hook (see http://gitorious.org/gitorious/pages/WebHooks) with a WebHook URL like ``http://user:password@builds.mycompany.com/bbot/change_hook/gitorious``. +Then, create a Gitorious web hook (see http://gitorious.org/gitorious/pages/WebHooks) with a WebHook URL like ``http://user:password@builds.example.com/bbot/change_hook/gitorious``. Note that as before, not using ``change_hook_auth`` can expose you to security risks. diff --git a/master/docs/manual/cmdline.rst b/master/docs/manual/cmdline.rst index 6b8ccd6d6f9..1944cca3c70 100644 --- a/master/docs/manual/cmdline.rst +++ b/master/docs/manual/cmdline.rst @@ -473,7 +473,7 @@ For details on how Buildbot manages users, see :ref:`Concepts-Users`. .. code-block:: none - --info=svn=jschmo,git='Joe Schmo ' + --info=svn=jdoe,git='John Doe ' The :option:`info` option can be specified multiple times in the :command:`user` command, as each specified option will be interpreted as a new user. Note that :option:`info` is only used with :option:`add` or with :option:`update`, and whenever you use :option:`update` you need to specify the identifier of the user you want to update. @@ -482,7 +482,7 @@ For details on how Buildbot manages users, see :ref:`Concepts-Users`. .. code-block:: none - --info=jschmo:git='Joseph Schmo ' + --info=jdoe:git='Joe Doe ' Note that :option:`--master`, :option:`--username`, :option:`--passwd`, and :option:`--op` are always required to issue the :command:`user` command. diff --git a/master/docs/manual/customization.rst b/master/docs/manual/customization.rst index bace86e6539..5c489012775 100644 --- a/master/docs/manual/customization.rst +++ b/master/docs/manual/customization.rst @@ -775,7 +775,7 @@ For example:: @defer.inlineCallbacks def run(self): ... # create and upload report to coverage server - url = 'http://coverage.corp.com/reports/%s' % reportname + url = 'http://coverage.example.com/reports/%s' % reportname yield self.addURL('coverage', url) Discovering files