arista-eos 1.1.0

data/.gitignore

@@ -0,0 +1,41 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+Gemfile.lock
+.ruby-version
+.ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+.DS_Store
+
+# CI files
+results
+spec/fixtures/manifests/*
+spec/fixtures/modules/*

data/.rubocop.yml

@@ -0,0 +1,21 @@
+AllCops:
+    Exclude:
+        - '**/*.gemspec'
+
+Metrics/CyclomaticComplexity:
+  Max: 20
+
+Metrics/MethodLength:
+  Max: 20
+
+Style/AccessorMethodName:
+  Enabled: False
+
+Metrics/PerceivedComplexity:
+  Max: 20 
+
+Metrics/AbcSize:
+  Max: 50
+
+Metrics/ClassLength:
+  Max: 130

data/Gemfile

@@ -0,0 +1,57 @@
+source ENV['GEM_SOURCE'] || 'https://rubygems.org'
+
+def location_for(place, fake_version = nil)
+  mdata = /^(git[:@][^#]*)#(.*)/.match(place)
+  if mdata
+    hsh = { git: mdata[1], branch: mdata[2], require: false }
+    return [fake_version, hsh].compact
+  end
+  mdata2 = %r{^file:\/\/(.*)}.match(place)
+  if mdata2
+    return ['>= 0', { path: File.expand_path(mdata2[1]), require: false }]
+  end
+  [place, { require: false }]
+end
+
+gem 'inifile'
+
+group :development do
+  gem 'guard'
+  gem 'guard-rspec'
+  gem 'guard-rubocop'
+  gem 'guard-shell'
+end
+
+group :development, :test do
+  gem 'yard'
+  gem 'redcarpet', '~> 3.1.2'
+  gem 'rake', '~> 10.1.0',       require: false
+  gem 'rspec', '~> 3.0.0'
+  gem 'rspec-mocks', '~> 3.0.0'
+  gem 'pry',                     require: false
+  gem 'pry-doc',                 require: false
+  gem 'simplecov',               require: false
+  gem 'simplecov-json',          require: false
+  gem 'simplecov-rcov',          require: false
+  gem 'puppetlabs_spec_helper'
+  gem 'puppet-lint'
+  gem 'metadata-json-lint',      require: false
+  gem 'ci_reporter'
+  gem 'ci_reporter_rspec'
+end
+
+ENV['GEM_PUPPET_VERSION'] ||= ENV['PUPPET_GEM_VERSION']
+puppetversion = ENV['GEM_PUPPET_VERSION']
+if puppetversion
+  gem 'puppet', *location_for(puppetversion)
+else
+  gem 'puppet', require: false
+end
+
+rbeapiversion = ENV['GEM_RBEAPI_VERSION']
+if rbeapiversion
+  gem 'rbeapi', *location_for(rbeapiversion)
+else
+  gem 'rbeapi', require: false
+end
+# vim:ft=ruby

data/Guardfile

@@ -0,0 +1,21 @@
+# encoding: utf-8
+
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard :rspec, cmd: 'bundle exec rspec' do
+  watch(%r{^spec\/.+_spec\.rb$})
+  watch(%r{^lib\/(.+)\.rb$})     { |m| "spec/unit/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { 'spec' }
+end
+
+guard :rubocop do
+  watch(/.+\.rb$/)
+  watch(%r{(?:.+\/)?\.rubocop\.yml$}) { |m| File.dirname(m[0]) }
+end
+
+group :docs do
+  guard :shell do
+    watch(%r{^lib\/(.+)\.rb$}) { |m| `yard doc #{m[0]} --quiet` }
+  end
+end

data/LICENSE

@@ -0,0 +1,28 @@
+Copyright (c) 2014-2015, Arista Networks EOS+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of Arista Networks nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

data/README.md

@@ -0,0 +1,178 @@
+# Puppet EOS Module
+
+#### Table of Contents
+
+1. [Overview](#overview)
+2. [Module Description](#module-description)
+3. [Setup](#setup)
+    * [What Puppet EOS affects](#what-puppet-eos-affects)
+    * [Setup requirements](#setup-requirements)
+    * [Beginning with NetDev EOS Providers](#beginning-eos)
+4. [Usage - Configuration options and additional functionality](#usage)
+5. [Reference - An under-the-hood peek at what the module is doing and how](#reference)
+6. [Limitations - OS compatibility, etc.](#limitations)
+7. [Development - Guide for getting started developing the module](#development)
+8. [Contributing - Contributing to this project](#contributing)
+9. [License](#license)
+10. [Release Notes](#release-notes)
+
+
+## Overview
+
+The Arista EOS module for Puppet provides a set of types and providers for
+automating Arista EOS node configuraitons.  The module allows for configuration
+of EOS nodes using the Puppet agent running native in EOS.
+
+The Puppet EOS modules are freely provided to the open source community for
+automating Arista EOS node configurations using Puppet.  Support for the
+modules is provided on a best effort basis by the Arista EOS+ community.
+Please file any bugs, questions or enhancement requests using [Github
+Issues](http://github.com/arista-eosplus/puppet-eos/issues)
+
+## Module Description
+
+This module provides network abstractions for configuring network services on
+Arista EOS nodes.  The module provides a set of types and providers to serve as
+building blocks for automating the configuration of Arista EOS nodes.  This
+module extends Puppet's capability to configure network devices including node
+system services, access services and trunk side services of EOS nodes running
+EOS 4.13 or later with the Puppet agent installed.  The Puppet agent running on
+the node will use pluginsync to download the types and providers from the Puppet
+master and uses the Ruby Client for eAPI (rbeapi) to interface with the nodes
+configuration.
+
+## Setup
+
+### What Puppet EOS affects
+
+The types and providers in this module provide native abstractions for
+configuring Arista EOS nodes.
+
+### Setup Requirements
+
+This module requires pluginsync in order to synchronize the types and providers
+to the node.  This module also requires the [Ruby Client for eAPI](rbeapi) to
+be installed on the master and nodes.
+
+### Beginning with eos
+
+ 1. Install the module on the Puppet master
+ 2. Install the rbeapi gem on the Puppet master [See Ruby Client for eAPI](rbeapi)
+ 3. Install the rbeapi gem on the switch [See Ruby Client for eAPI](rbeapi)
+ 4. Run the puppet agent on the switch to synchronize the types and providers
+ 5. List the types by running `bash sudo puppet resource --types | grep eos`
+    from the EOS CLI enable mode
+ 6. Verify the providrs by running `bash sudo puppet resource <resource>` from 
+    the EOS CLI enable mode
+
+```
+Arista$ bash sudo puppet resource eos_vlan
+eos_vlan { '1':
+  ensure    => 'present',
+  enable    => 'true',
+  vlan_name => 'default',
+}
+eos_vlan { '100':
+  ensure    => 'present',
+  enable    => 'true',
+  vlan_name => 'TEST_VLAN_100',
+}
+```
+
+## Usage
+
+See the [Documentation](http://puppet-eos.readthedocs.org/en/master/)
+
+## Reference
+
+See the [Type reference](http://puppet-eos.readthedocs.org/en/master/types.html) in the documentation
+
+## Limitations
+* Puppet 3.6 or later
+* Ruby 1.9.3 or later
+* [Arista EOS 4.13.7M or later](arista)
+* [Ruby Client for eAPI 0.2.0 or later](rbeapi)
+
+## Development
+
+This module can be configured to run directly from source and configured to do
+local development, sending the commands to the node over HTTP.  The following
+instructions explain how to configure your local development environment.
+
+This module requires one dependency that must be checked out as a Git working
+copy in the context of ongoing development in addition to running Puppet from
+source.
+
+ * [rbeapi][rbeapi]
+
+The dependency is managed via the bundler Gemfile and the environment needs to
+be configured to use local Git copies:
+
+    cd /workspace
+    git clone https://github.com/arista-eosplus/rbeapi
+    export GEM_RBEAPI_VERSION=file:///workspace/rbeapi
+
+Once the dependencies are installed and the environment configured, then
+install all of the dependencies:
+
+    git clone https://github.com/arista-eosplus/puppet-eos
+    cd puppet-eos
+    bundle install --path .bundle/gems
+
+Once everything is installed, run the spec tests to make sure everything is
+working properly:
+
+    bundle exec rspec spec
+
+Finally, configure the eapi.conf file for rbeapi [See rbeapi for
+details][rbeapi] and set the connection enviroment variable to run sanity tests
+using `puppet resource`:
+
+    export RBEAPI_CONNECTION=veos01
+
+## Contributing
+
+Contributions to this project are gladly welcomed in the form of issues (bugs,
+questions, enhancement proposals) and pull requests.  All pull requests must be
+accompanied by spec unit tests and up-to-date doc-strings, otherwise the pull
+request will be rejected.
+
+## License
+Copyright (c) 2014-2015, Arista Networks EOS+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of Arista Networks nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+## Release Notes
+
+See the [Release Notes](http://puppet-eos.readthedocs.org/en/master/release-notes.html)
+in the official documentation.
+
+
+[rbeapi]: https://github.com/arista-eosplus/rbeapi
+[arista]: http://www.arista.com
+
+

data/Rakefile

@@ -0,0 +1,46 @@
+require 'bundler/gem_tasks'
+require 'rubygems'
+require 'puppetlabs_spec_helper/rake_tasks'
+require 'puppet-lint/tasks/puppet-lint'
+require 'ci/reporter/rake/rspec'
+PuppetLint.configuration.send('disable_80chars')
+PuppetLint.configuration.ignore_paths = ['spec/**/*.pp', 'pkg/**/*.pp']
+
+desc 'Prep CI RSpec tests'
+task :ci_prep do
+  require 'rubygems'
+  begin
+    gem 'ci_reporter'
+    require 'ci/reporter/rake/rspec'
+    ENV['CI_REPORTS'] = 'results'
+  rescue LoadError
+    puts 'Missing ci_reporter gem. You must have the ci_reporter gem installed'\
+         ' to run the CI spec tests'
+  end
+end
+
+desc 'Run the CI RSpec tests'
+task ci_spec: [:ci_prep, 'ci:setup:rspec', :spec]
+
+desc 'Validate manifests, templates, and ruby files'
+task :validate do
+  Dir['manifests/**/*.pp'].each do |manifest|
+    sh "puppet parser validate --noop #{manifest}"
+  end
+  Dir['spec/**/*.rb', 'lib/**/*.rb'].each do |ruby_file|
+    sh "ruby -c #{ruby_file}" unless ruby_file =~ %r{spec\/fixtures}
+  end
+  Dir['templates/**/*.erb'].each do |template|
+    sh "erb -P -x -T '-' #{template} | ruby -c"
+  end
+end
+
+desc 'Generate Getting Started Guide HTML'
+task :guide do
+  system 'make -C guide html'
+end
+
+desc 'Clean Getting Started docs'
+task :guide_clean do
+  system 'make -C guide clean'
+end

data/eos.gemspec

@@ -0,0 +1,36 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'eos/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'arista-eos'
+  spec.version       = Eos::VERSION
+  spec.authors       = ['Peter Sprygada', 'John Corbin']
+  spec.email         = ['sprygada@arista.com', 'jcorbin@arista.com']
+  spec.description   = %q{Arista EOS Puppet modules to configure EOS devices}
+  spec.summary       = %q{Type and provider implementation for Arista EOS devices}
+  spec.homepage      = 'https://github.com/arista-eosplus/puppet-eos'
+  spec.license       = 'BSD-3'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  # Development
+  spec.add_development_dependency 'bundler', '~> 1.3'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'guard'
+  spec.add_development_dependency 'guard-rspec'
+  spec.add_development_dependency 'guard-rubocop'
+  spec.add_development_dependency 'pry-doc'
+  spec.add_development_dependency 'pry'
+  # Testing
+  spec.add_development_dependency 'rspec-puppet'
+  spec.add_development_dependency 'rspec', '~> 3.0.0'
+  spec.add_development_dependency 'puppetlabs_spec_helper'
+  spec.add_development_dependency 'simplecov'
+
+  spec.add_dependency 'puppet'
+end

data/guide/.gitignore

@@ -0,0 +1,2 @@
+# Sphinx build env
+_build

data/guide/Makefile

@@ -0,0 +1,177 @@
+# Makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+PAPER         =
+BUILDDIR      = _build
+
+# User-friendly check for sphinx-build
+ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)
+$(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/)
+endif
+
+# Internal variables.
+PAPEROPT_a4     = -D latex_paper_size=a4
+PAPEROPT_letter = -D latex_paper_size=letter
+ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+# the i18n builder cannot share the environment and doctrees with the others
+I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+
+.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
+
+help:
+	@echo "Please use \`make <target>' where <target> is one of"
+	@echo "  html       to make standalone HTML files"
+	@echo "  dirhtml    to make HTML files named index.html in directories"
+	@echo "  singlehtml to make a single large HTML file"
+	@echo "  pickle     to make pickle files"
+	@echo "  json       to make JSON files"
+	@echo "  htmlhelp   to make HTML files and a HTML help project"
+	@echo "  qthelp     to make HTML files and a qthelp project"
+	@echo "  devhelp    to make HTML files and a Devhelp project"
+	@echo "  epub       to make an epub"
+	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
+	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
+	@echo "  latexpdfja to make LaTeX files and run them through platex/dvipdfmx"
+	@echo "  text       to make text files"
+	@echo "  man        to make manual pages"
+	@echo "  texinfo    to make Texinfo files"
+	@echo "  info       to make Texinfo files and run them through makeinfo"
+	@echo "  gettext    to make PO message catalogs"
+	@echo "  changes    to make an overview of all changed/added/deprecated items"
+	@echo "  xml        to make Docutils-native XML files"
+	@echo "  pseudoxml  to make pseudoxml-XML files for display purposes"
+	@echo "  linkcheck  to check all external links for integrity"
+	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
+
+clean:
+	rm -rf $(BUILDDIR)/*
+
+html:
+	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
+
+dirhtml:
+	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
+
+singlehtml:
+	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
+	@echo
+	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
+
+pickle:
+	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
+	@echo
+	@echo "Build finished; now you can process the pickle files."
+
+json:
+	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
+	@echo
+	@echo "Build finished; now you can process the JSON files."
+
+htmlhelp:
+	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
+	@echo
+	@echo "Build finished; now you can run HTML Help Workshop with the" \
+	      ".hhp project file in $(BUILDDIR)/htmlhelp."
+
+qthelp:
+	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
+	@echo
+	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
+	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
+	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/puppet_eos.qhcp"
+	@echo "To view the help file:"
+	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/puppet_eos.qhc"
+
+devhelp:
+	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
+	@echo
+	@echo "Build finished."
+	@echo "To view the help file:"
+	@echo "# mkdir -p $$HOME/.local/share/devhelp/puppet_eos"
+	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/puppet_eos"
+	@echo "# devhelp"
+
+epub:
+	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
+	@echo
+	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
+
+latex:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo
+	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
+	@echo "Run \`make' in that directory to run these through (pdf)latex" \
+	      "(use \`make latexpdf' here to do that automatically)."
+
+latexpdf:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo "Running LaTeX files through pdflatex..."
+	$(MAKE) -C $(BUILDDIR)/latex all-pdf
+	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
+
+latexpdfja:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo "Running LaTeX files through platex and dvipdfmx..."
+	$(MAKE) -C $(BUILDDIR)/latex all-pdf-ja
+	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
+
+text:
+	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
+	@echo
+	@echo "Build finished. The text files are in $(BUILDDIR)/text."
+
+man:
+	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
+	@echo
+	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
+
+texinfo:
+	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	@echo
+	@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
+	@echo "Run \`make' in that directory to run these through makeinfo" \
+	      "(use \`make info' here to do that automatically)."
+
+info:
+	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	@echo "Running Texinfo files through makeinfo..."
+	make -C $(BUILDDIR)/texinfo info
+	@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
+
+gettext:
+	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
+	@echo
+	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
+
+changes:
+	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
+	@echo
+	@echo "The overview file is in $(BUILDDIR)/changes."
+
+linkcheck:
+	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
+	@echo
+	@echo "Link check complete; look for any errors in the above output " \
+	      "or in $(BUILDDIR)/linkcheck/output.txt."
+
+doctest:
+	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
+	@echo "Testing of doctests in the sources finished, look at the " \
+	      "results in $(BUILDDIR)/doctest/output.txt."
+
+xml:
+	$(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml
+	@echo
+	@echo "Build finished. The XML files are in $(BUILDDIR)/xml."
+
+pseudoxml:
+	$(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml
+	@echo
+	@echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."