sentry-raven 2.7.4 → 2.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/.gitignore +0 -1
- data/.gitmodules +0 -3
- data/.rubocop.yml +1 -1
- data/.travis.yml +2 -2
- data/Gemfile +5 -5
- data/README.md +8 -4
- data/changelog.md +5 -0
- data/lib/raven/client.rb +9 -1
- data/lib/raven/configuration.rb +21 -6
- data/lib/raven/instance.rb +8 -4
- data/lib/raven/transports/stdout.rb +20 -0
- data/lib/raven/version.rb +1 -1
- data/sentry-raven.gemspec +0 -1
- metadata +4 -19
- data/docs/Makefile +0 -130
- data/docs/breadcrumbs.rst +0 -51
- data/docs/conf.py +0 -228
- data/docs/config.rst +0 -260
- data/docs/context.rst +0 -141
- data/docs/index.rst +0 -113
- data/docs/install.rst +0 -40
- data/docs/integrations/heroku.rst +0 -11
- data/docs/integrations/index.rst +0 -59
- data/docs/integrations/puma.rst +0 -30
- data/docs/integrations/rack.rst +0 -27
- data/docs/integrations/rails.rst +0 -62
- data/docs/make.bat +0 -155
- data/docs/processors.rst +0 -124
- data/docs/sentry-doc-config.json +0 -31
- data/docs/usage.rst +0 -176
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: b2c9069a9b5cfae47df6590266f31063b07347f4
|
4
|
+
data.tar.gz: bacb13812cd83d2e16befab52f47c3cd08f481ec
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 94aa454b77018b446f06d1daf50bc97679fc76d45362bf63e1e876fad72882a3363dfe83d0a68b03b04b1e4590b55578e451e42d2badb538b44322ef5b794a06
|
7
|
+
data.tar.gz: e5a2752c30d82bbeeaece755f09a4f4660b58aee9172460968447f40958a6c3ff0fc02b267040c1476097b361a0bc2785b61220acfaff1351e8dff4202010bb3
|
data/.gitignore
CHANGED
data/.gitmodules
CHANGED
data/.rubocop.yml
CHANGED
data/.travis.yml
CHANGED
@@ -37,9 +37,9 @@ matrix:
|
|
37
37
|
env: RAILS_VERSION=4
|
38
38
|
- rvm: jruby-1.7.27
|
39
39
|
env: JRUBY_OPTS="--dev" RAILS_VERSION=4
|
40
|
-
- rvm: jruby-9.
|
40
|
+
- rvm: jruby-9.2.0.0
|
41
41
|
env: JRUBY_OPTS="--dev -J-Djruby.launch.inproc=true -J-Xmx1024M" RAILS_VERSION=4
|
42
|
-
- rvm: jruby-9.
|
42
|
+
- rvm: jruby-9.2.0.0
|
43
43
|
env: JRUBY_OPTS="--dev -J-Djruby.launch.inproc=true -J-Xmx1024M" RAILS_VERSION=5
|
44
44
|
- rvm: ruby-head
|
45
45
|
env: RAILS_VERSION=0
|
data/Gemfile
CHANGED
@@ -4,12 +4,12 @@ gemspec
|
|
4
4
|
|
5
5
|
if ENV["RAILS_VERSION"] && (ENV["RAILS_VERSION"].to_i == 4)
|
6
6
|
gem "rails", "< 5"
|
7
|
-
gem "rspec-rails"
|
7
|
+
gem "rspec-rails", "> 3"
|
8
8
|
elsif ENV["RAILS_VERSION"] && (ENV["RAILS_VERSION"].to_i == 0)
|
9
9
|
# no-op. No Rails.
|
10
10
|
else
|
11
11
|
gem "rails", "< 6"
|
12
|
-
gem "rspec-rails"
|
12
|
+
gem "rspec-rails", "> 3"
|
13
13
|
end
|
14
14
|
|
15
15
|
if RUBY_VERSION < '2.0'
|
@@ -28,9 +28,9 @@ gem "pry-coolline"
|
|
28
28
|
gem "benchmark-ips"
|
29
29
|
gem "benchmark-ipsa" if RUBY_VERSION > '2.0'
|
30
30
|
gem "ruby-prof", platform: :mri
|
31
|
-
gem "rake"
|
32
|
-
gem "rubocop", "~> 0.41.1"
|
33
|
-
gem "rspec"
|
31
|
+
gem "rake", "> 12"
|
32
|
+
gem "rubocop", "~> 0.41.1" # Last version that supported 1.9, upgrade to 0.50 after we drop 1.9
|
33
|
+
gem "rspec", "> 3"
|
34
34
|
gem "capybara" # rspec system tests
|
35
35
|
gem "puma" # rspec system tests
|
36
36
|
|
data/README.md
CHANGED
@@ -1,5 +1,8 @@
|
|
1
1
|
<p align="center">
|
2
|
-
<
|
2
|
+
<a href="https://sentry.io" target="_blank" align="center">
|
3
|
+
<img src="https://sentry-brand.storage.googleapis.com/sentry-logo-black.png" width="280">
|
4
|
+
</a>
|
5
|
+
<br>
|
3
6
|
</p>
|
4
7
|
|
5
8
|
# Raven-Ruby, the Ruby Client for Sentry
|
@@ -7,6 +10,7 @@
|
|
7
10
|
[](https://rubygems.org/gems/sentry-raven)
|
8
11
|
[](https://travis-ci.org/getsentry/raven-ruby)
|
9
12
|
[](https://rubygems.org/gems/sentry-raven/)
|
13
|
+
[](https://dependabot.com/compatibility-score.html?dependency-name=sentry-raven&package-manager=bundler&version-scheme=semver)
|
10
14
|
|
11
15
|
|
12
16
|
[Documentation](https://docs.getsentry.com/hosted/clients/ruby/) | [Bug Tracker](https://github.com/getsentry/raven-ruby/issues) | [Forum](https://forum.sentry.io/) | IRC: irc.freenode.net, #sentry
|
@@ -31,12 +35,12 @@ Raven will capture and send exceptions to the Sentry server whenever its DSN is
|
|
31
35
|
|
32
36
|
```bash
|
33
37
|
# Set your SENTRY_DSN environment variable.
|
34
|
-
export SENTRY_DSN=http://public
|
38
|
+
export SENTRY_DSN=http://public@example.com/project-id
|
35
39
|
```
|
36
40
|
```ruby
|
37
41
|
# Or you can configure the client in the code (not recommended - keep your DSN secret!)
|
38
42
|
Raven.configure do |config|
|
39
|
-
config.dsn = 'http://public
|
43
|
+
config.dsn = 'http://public@example.com/project-id'
|
40
44
|
end
|
41
45
|
```
|
42
46
|
|
@@ -126,7 +130,7 @@ For more information, see [Context](https://docs.sentry.io/clients/ruby/context/
|
|
126
130
|
|
127
131
|
## More Information
|
128
132
|
|
129
|
-
* [Documentation](https://docs.
|
133
|
+
* [Documentation](https://docs.sentry.io/clients/ruby/)
|
130
134
|
* [Bug Tracker](https://github.com/getsentry/raven-ruby/issues)
|
131
135
|
* [Forum](https://forum.sentry.io/)
|
132
136
|
* [IRC](irc://irc.freenode.net/sentry>) (irc.freenode.net, #sentry)
|
data/changelog.md
CHANGED
@@ -1,3 +1,8 @@
|
|
1
|
+
2.8.0
|
2
|
+
-----
|
3
|
+
|
4
|
+
* FEATURE: Added `config.before_send`. Provide a lambda or proc to this config setting, which will be `call`ed when before sending an event to Sentry. Receives `event` and `hint` as parameter. `hint` is a has {:exception => ex | nil, :message => message | nil}. [@hazat, #847]
|
5
|
+
|
1
6
|
2.7.4
|
2
7
|
-----
|
3
8
|
|
data/lib/raven/client.rb
CHANGED
@@ -18,9 +18,15 @@ module Raven
|
|
18
18
|
@state = ClientState.new
|
19
19
|
end
|
20
20
|
|
21
|
-
def send_event(event)
|
21
|
+
def send_event(event, hint = nil)
|
22
22
|
return false unless configuration.sending_allowed?(event)
|
23
23
|
|
24
|
+
event = configuration.before_send.call(event, hint) if configuration.before_send
|
25
|
+
if event.nil?
|
26
|
+
configuration.logger.info "Discarded event because before_send returned nil"
|
27
|
+
return
|
28
|
+
end
|
29
|
+
|
24
30
|
# Convert to hash
|
25
31
|
event = event.to_hash
|
26
32
|
|
@@ -50,6 +56,8 @@ module Raven
|
|
50
56
|
case configuration.scheme
|
51
57
|
when 'http', 'https'
|
52
58
|
Transports::HTTP.new(configuration)
|
59
|
+
when 'stdout'
|
60
|
+
Transports::Stdout.new(configuration)
|
53
61
|
when 'dummy'
|
54
62
|
Transports::Dummy.new(configuration)
|
55
63
|
else
|
data/lib/raven/configuration.rb
CHANGED
@@ -156,6 +156,15 @@ module Raven
|
|
156
156
|
# E.g. lambda { |event| Thread.new { MyJobProcessor.send_email(event) } }
|
157
157
|
attr_reader :transport_failure_callback
|
158
158
|
|
159
|
+
# Optional Proc, called before sending an event to the server/
|
160
|
+
# E.g.: lambda { |event, hint| event }
|
161
|
+
# E.g.: lambda { |event, hint| nil }
|
162
|
+
# E.g.: lambda { |event, hint|
|
163
|
+
# event[:message] = 'a'
|
164
|
+
# event
|
165
|
+
# }
|
166
|
+
attr_reader :before_send
|
167
|
+
|
159
168
|
# Errors object - an Array that contains error messages. See #
|
160
169
|
attr_reader :errors
|
161
170
|
|
@@ -182,6 +191,9 @@ module Raven
|
|
182
191
|
Raven::Processor::HTTPHeaders
|
183
192
|
].freeze
|
184
193
|
|
194
|
+
HEROKU_DYNO_METADATA_MESSAGE = "You are running on Heroku but haven't enabled Dyno Metadata. For Sentry's "\
|
195
|
+
"release detection to work correctly, please run `heroku labs:enable runtime-dyno-metadata`".freeze
|
196
|
+
|
185
197
|
LOG_PREFIX = "** [Raven] ".freeze
|
186
198
|
MODULE_SEPARATOR = "::".freeze
|
187
199
|
|
@@ -214,6 +226,7 @@ module Raven
|
|
214
226
|
self.tags = {}
|
215
227
|
self.timeout = 2
|
216
228
|
self.transport_failure_callback = false
|
229
|
+
self.before_send = false
|
217
230
|
end
|
218
231
|
|
219
232
|
def server=(value)
|
@@ -266,6 +279,13 @@ module Raven
|
|
266
279
|
@should_capture = value
|
267
280
|
end
|
268
281
|
|
282
|
+
def before_send=(value)
|
283
|
+
unless value == false || value.respond_to?(:call)
|
284
|
+
raise ArgumentError, "before_send must be callable (or false to disable)"
|
285
|
+
end
|
286
|
+
@before_send = value
|
287
|
+
end
|
288
|
+
|
269
289
|
# Allows config options to be read like a hash
|
270
290
|
#
|
271
291
|
# @param [Symbol] option Key for a given attribute
|
@@ -352,7 +372,7 @@ module Raven
|
|
352
372
|
def detect_release_from_heroku
|
353
373
|
return unless running_on_heroku?
|
354
374
|
return if ENV['CI']
|
355
|
-
logger.warn(
|
375
|
+
logger.warn(HEROKU_DYNO_METADATA_MESSAGE) && return unless ENV['HEROKU_SLUG_COMMIT']
|
356
376
|
|
357
377
|
ENV['HEROKU_SLUG_COMMIT']
|
358
378
|
end
|
@@ -361,11 +381,6 @@ module Raven
|
|
361
381
|
File.directory?("/etc/heroku")
|
362
382
|
end
|
363
383
|
|
364
|
-
def heroku_dyno_metadata_message
|
365
|
-
"You are running on Heroku but haven't enabled Dyno Metadata. For Sentry's "\
|
366
|
-
"release detection to work correctly, please run `heroku labs:enable runtime-dyno-metadata`"
|
367
|
-
end
|
368
|
-
|
369
384
|
def detect_release_from_capistrano
|
370
385
|
revision_file = File.join(project_root, 'REVISION')
|
371
386
|
revision_log = File.join(project_root, '..', 'revisions.log')
|
data/lib/raven/instance.rb
CHANGED
@@ -77,8 +77,8 @@ module Raven
|
|
77
77
|
# @example
|
78
78
|
# evt = Raven::Event.new(:message => "An error")
|
79
79
|
# Raven.send_event(evt)
|
80
|
-
def send_event(event)
|
81
|
-
client.send_event(event)
|
80
|
+
def send_event(event, hint = nil)
|
81
|
+
client.send_event(event, hint)
|
82
82
|
end
|
83
83
|
|
84
84
|
# Capture and process any exceptions from the given block.
|
@@ -120,10 +120,10 @@ module Raven
|
|
120
120
|
configuration.async.call(evt.to_json_compatible)
|
121
121
|
rescue => ex
|
122
122
|
logger.error("async event sending failed: #{ex.message}")
|
123
|
-
send_event(evt)
|
123
|
+
send_event(evt, make_hint(obj))
|
124
124
|
end
|
125
125
|
else
|
126
|
-
send_event(evt)
|
126
|
+
send_event(evt, make_hint(obj))
|
127
127
|
end
|
128
128
|
Thread.current["sentry_#{object_id}_last_event_id".to_sym] = evt.id
|
129
129
|
evt
|
@@ -217,5 +217,9 @@ module Raven
|
|
217
217
|
end
|
218
218
|
end
|
219
219
|
end
|
220
|
+
|
221
|
+
def make_hint(obj)
|
222
|
+
obj.is_a?(String) ? { :exception => nil, :message => obj } : { :exception => obj, :message => nil }
|
223
|
+
end
|
220
224
|
end
|
221
225
|
end
|
@@ -0,0 +1,20 @@
|
|
1
|
+
module Raven
|
2
|
+
module Transports
|
3
|
+
class Stdout < Transport
|
4
|
+
attr_accessor :events
|
5
|
+
|
6
|
+
def initialize(*)
|
7
|
+
super
|
8
|
+
end
|
9
|
+
|
10
|
+
def send_event(_auth_header, data, _options = {})
|
11
|
+
unless configuration.sending_allowed?
|
12
|
+
logger.debug("Event not sent: #{configuration.error_messages}")
|
13
|
+
end
|
14
|
+
|
15
|
+
$stdout.puts data
|
16
|
+
$stdout.flush
|
17
|
+
end
|
18
|
+
end
|
19
|
+
end
|
20
|
+
end
|
data/lib/raven/version.rb
CHANGED
data/sentry-raven.gemspec
CHANGED
@@ -12,7 +12,6 @@ Gem::Specification.new do |gem|
|
|
12
12
|
gem.version = Raven::VERSION
|
13
13
|
gem.platform = Gem::Platform::RUBY
|
14
14
|
gem.required_ruby_version = '>= 1.9.0'
|
15
|
-
gem.has_rdoc = true
|
16
15
|
gem.extra_rdoc_files = ["README.md", "LICENSE"]
|
17
16
|
gem.files = `git ls-files | grep -Ev '^(spec|benchmarks|examples)'`.split("\n")
|
18
17
|
gem.bindir = "exe"
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: sentry-raven
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 2.
|
4
|
+
version: 2.8.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Sentry Team
|
8
8
|
autorequire:
|
9
9
|
bindir: exe
|
10
10
|
cert_chain: []
|
11
|
-
date:
|
11
|
+
date: 2019-01-09 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: faraday
|
@@ -49,22 +49,6 @@ files:
|
|
49
49
|
- README.md
|
50
50
|
- Rakefile
|
51
51
|
- changelog.md
|
52
|
-
- docs/Makefile
|
53
|
-
- docs/breadcrumbs.rst
|
54
|
-
- docs/conf.py
|
55
|
-
- docs/config.rst
|
56
|
-
- docs/context.rst
|
57
|
-
- docs/index.rst
|
58
|
-
- docs/install.rst
|
59
|
-
- docs/integrations/heroku.rst
|
60
|
-
- docs/integrations/index.rst
|
61
|
-
- docs/integrations/puma.rst
|
62
|
-
- docs/integrations/rack.rst
|
63
|
-
- docs/integrations/rails.rst
|
64
|
-
- docs/make.bat
|
65
|
-
- docs/processors.rst
|
66
|
-
- docs/sentry-doc-config.json
|
67
|
-
- docs/usage.rst
|
68
52
|
- exe/raven
|
69
53
|
- lib/raven.rb
|
70
54
|
- lib/raven/backtrace.rb
|
@@ -110,6 +94,7 @@ files:
|
|
110
94
|
- lib/raven/transports.rb
|
111
95
|
- lib/raven/transports/dummy.rb
|
112
96
|
- lib/raven/transports/http.rb
|
97
|
+
- lib/raven/transports/stdout.rb
|
113
98
|
- lib/raven/utils/deep_merge.rb
|
114
99
|
- lib/raven/utils/real_ip.rb
|
115
100
|
- lib/raven/version.rb
|
@@ -136,7 +121,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
136
121
|
version: '0'
|
137
122
|
requirements: []
|
138
123
|
rubyforge_project:
|
139
|
-
rubygems_version: 2.
|
124
|
+
rubygems_version: 2.5.2.3
|
140
125
|
signing_key:
|
141
126
|
specification_version: 4
|
142
127
|
summary: A gem that provides a client interface for the Sentry error logger
|
data/docs/Makefile
DELETED
@@ -1,130 +0,0 @@
|
|
1
|
-
# Makefile for Sphinx documentation
|
2
|
-
#
|
3
|
-
|
4
|
-
# You can set these variables from the command line.
|
5
|
-
SPHINXOPTS =
|
6
|
-
SPHINXBUILD = sphinx-build
|
7
|
-
PAPER =
|
8
|
-
BUILDDIR = ./_build
|
9
|
-
|
10
|
-
# Internal variables.
|
11
|
-
PAPEROPT_a4 = -D latex_paper_size=a4
|
12
|
-
PAPEROPT_letter = -D latex_paper_size=letter
|
13
|
-
ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
|
14
|
-
|
15
|
-
.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest
|
16
|
-
|
17
|
-
help:
|
18
|
-
@echo "Please use \`make <target>' where <target> is one of"
|
19
|
-
@echo " html to make standalone HTML files"
|
20
|
-
@echo " dirhtml to make HTML files named index.html in directories"
|
21
|
-
@echo " singlehtml to make a single large HTML file"
|
22
|
-
@echo " pickle to make pickle files"
|
23
|
-
@echo " json to make JSON files"
|
24
|
-
@echo " htmlhelp to make HTML files and a HTML help project"
|
25
|
-
@echo " qthelp to make HTML files and a qthelp project"
|
26
|
-
@echo " devhelp to make HTML files and a Devhelp project"
|
27
|
-
@echo " epub to make an epub"
|
28
|
-
@echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
|
29
|
-
@echo " latexpdf to make LaTeX files and run them through pdflatex"
|
30
|
-
@echo " text to make text files"
|
31
|
-
@echo " man to make manual pages"
|
32
|
-
@echo " changes to make an overview of all changed/added/deprecated items"
|
33
|
-
@echo " linkcheck to check all external links for integrity"
|
34
|
-
@echo " doctest to run all doctests embedded in the documentation (if enabled)"
|
35
|
-
|
36
|
-
clean:
|
37
|
-
-rm -rf $(BUILDDIR)/*
|
38
|
-
|
39
|
-
html:
|
40
|
-
$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
|
41
|
-
@echo
|
42
|
-
@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
|
43
|
-
|
44
|
-
dirhtml:
|
45
|
-
$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
|
46
|
-
@echo
|
47
|
-
@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
|
48
|
-
|
49
|
-
singlehtml:
|
50
|
-
$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
|
51
|
-
@echo
|
52
|
-
@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
|
53
|
-
|
54
|
-
pickle:
|
55
|
-
$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
|
56
|
-
@echo
|
57
|
-
@echo "Build finished; now you can process the pickle files."
|
58
|
-
|
59
|
-
json:
|
60
|
-
$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
|
61
|
-
@echo
|
62
|
-
@echo "Build finished; now you can process the JSON files."
|
63
|
-
|
64
|
-
htmlhelp:
|
65
|
-
$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
|
66
|
-
@echo
|
67
|
-
@echo "Build finished; now you can run HTML Help Workshop with the" \
|
68
|
-
".hhp project file in $(BUILDDIR)/htmlhelp."
|
69
|
-
|
70
|
-
qthelp:
|
71
|
-
$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
|
72
|
-
@echo
|
73
|
-
@echo "Build finished; now you can run "qcollectiongenerator" with the" \
|
74
|
-
".qhcp project file in $(BUILDDIR)/qthelp, like this:"
|
75
|
-
@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/Sentry.qhcp"
|
76
|
-
@echo "To view the help file:"
|
77
|
-
@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/Sentry.qhc"
|
78
|
-
|
79
|
-
devhelp:
|
80
|
-
$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
|
81
|
-
@echo
|
82
|
-
@echo "Build finished."
|
83
|
-
@echo "To view the help file:"
|
84
|
-
@echo "# mkdir -p $$HOME/.local/share/devhelp/Sentry"
|
85
|
-
@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/Sentry"
|
86
|
-
@echo "# devhelp"
|
87
|
-
|
88
|
-
epub:
|
89
|
-
$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
|
90
|
-
@echo
|
91
|
-
@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
|
92
|
-
|
93
|
-
latex:
|
94
|
-
$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
|
95
|
-
@echo
|
96
|
-
@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
|
97
|
-
@echo "Run \`make' in that directory to run these through (pdf)latex" \
|
98
|
-
"(use \`make latexpdf' here to do that automatically)."
|
99
|
-
|
100
|
-
latexpdf:
|
101
|
-
$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
|
102
|
-
@echo "Running LaTeX files through pdflatex..."
|
103
|
-
make -C $(BUILDDIR)/latex all-pdf
|
104
|
-
@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
|
105
|
-
|
106
|
-
text:
|
107
|
-
$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
|
108
|
-
@echo
|
109
|
-
@echo "Build finished. The text files are in $(BUILDDIR)/text."
|
110
|
-
|
111
|
-
man:
|
112
|
-
$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
|
113
|
-
@echo
|
114
|
-
@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
|
115
|
-
|
116
|
-
changes:
|
117
|
-
$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
|
118
|
-
@echo
|
119
|
-
@echo "The overview file is in $(BUILDDIR)/changes."
|
120
|
-
|
121
|
-
linkcheck:
|
122
|
-
$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
|
123
|
-
@echo
|
124
|
-
@echo "Link check complete; look for any errors in the above output " \
|
125
|
-
"or in $(BUILDDIR)/linkcheck/output.txt."
|
126
|
-
|
127
|
-
doctest:
|
128
|
-
$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
|
129
|
-
@echo "Testing of doctests in the sources finished, look at the " \
|
130
|
-
"results in $(BUILDDIR)/doctest/output.txt."
|