prawn 2.4.0 → 2.5.0

metadata

@@ -1,9 +1,10 @@
 --- !ruby/object:Gem::Specification
 name: prawn
 version: !ruby/object:Gem::Version
-  version: 2.4.0
+  version: 2.5.0
 platform: ruby
 authors:
+- Alexander Mankuta
 - Gregory Brown
 - Brad Ediger
 - Daniel Nelson
@@ -14,55 +15,67 @@ bindir: bin
 cert_chain:
 - |
   -----BEGIN CERTIFICATE-----
-  MIIDODCCAiCgAwIBAgIBATANBgkqhkiG9w0BAQsFADAjMSEwHwYDVQQDDBhhbGV4
-  L0RDPXBvaW50bGVzcy9EQz1vbmUwHhcNMjAwODAxMTQxMjE1WhcNMjEwODAxMTQx
-  MjE1WjAjMSEwHwYDVQQDDBhhbGV4L0RDPXBvaW50bGVzcy9EQz1vbmUwggEiMA0G
+  MIIC+jCCAeKgAwIBAgIBAzANBgkqhkiG9w0BAQsFADAjMSEwHwYDVQQDDBhhbGV4
+  L0RDPXBvaW50bGVzcy9EQz1vbmUwHhcNMjMxMTA5MTA1MzIxWhcNMjQxMTA4MTA1
+  MzIxWjAjMSEwHwYDVQQDDBhhbGV4L0RDPXBvaW50bGVzcy9EQz1vbmUwggEiMA0G
   CSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDPOVLPGEK+eaP6zJfifrpWvPTg4qo3
   XNJJPom80SwqX2hVCVsRDK4RYgKUQqKRQzHhlx14wZHwWLETBVbNDGX3uqyCnTWU
   JUKh3ydiZShXpNHoV/NW7hhEYvNsDcBAjYTmbvXOhuYCo0Tz/0N2Oiun/0wIICtP
   vytY9TY0/lklWjAbsqJjNOu3o8IYkJBAN/rU96E/6WhFwjnxLcTnV9RfFRXdjG5j
   CughoB2xSwKX8gwbQ8fsnaZRmdyDGYNpz6sGF0zycfiLkTttbLA2nYATCALy98CH
   nsyZNsTjb4WINCuY2yEDjwesw9f/ROkNC68EgQ5M+aMjp+D0WcYGfzojAgMBAAGj
-  dzB1MAkGA1UdEwQCMAAwCwYDVR0PBAQDAgSwMB0GA1UdDgQWBBRPgIwSVbeonua/
-  Ny/8576oxdUbrjAdBgNVHREEFjAUgRJhbGV4QHBvaW50bGVzcy5vbmUwHQYDVR0S
-  BBYwFIESYWxleEBwb2ludGxlc3Mub25lMA0GCSqGSIb3DQEBCwUAA4IBAQAzhGxF
-  M0bXJ9GWD9vdVHOyzBQBJcJAvnsz2yV3+r4eJBsQynFIscsea8lHFL/d1eHYP0mN
-  k0fhK+WDcPlrj0Sn/Ezhk2qogTIekwDOK6pZkGRQzD45leJqQMnYd+/TXK3ri485
-  Gi4oJ6NitnnUT59SQnjD5JcENfc0EcRzclmVRFE8W4O+ORgo4Dypq1rwYUzxeyUk
-  mP5jNBWtH+hGUph28GQb0Hph6YnQb8zEFB88Xq80PK1SzkIPHpbTBk9mwPf6ypeX
-  Un1TJEahAlgENVml6CyDXSwk0H8N1V3gm1mb9Fe1T2Z/kAzvjo0qTDEtMVLU7Bxh
-  uqMUrdETjTnRYCVq
+  OTA3MAkGA1UdEwQCMAAwCwYDVR0PBAQDAgSwMB0GA1UdDgQWBBRPgIwSVbeonua/
+  Ny/8576oxdUbrjANBgkqhkiG9w0BAQsFAAOCAQEAX28QLxNNz5EgaZZuQQUkbOXB
+  4b5luBO22535+Vgj2jw7yjV8KKoGMWKrnB00ijgntqPEPXCzaPNibOcPZV5WfWVS
+  t0Ls8lWE/8kezPwV4SbRe4Y7C+D4J+oirs0L5PtpREV9CJ7kfdW/AN9MtvjjBFlb
+  jHquD/MiOOMyHtuO0FiTL265m10thcAUsbyi0MehKgGbtJ5fGceHvZDqDouvbMjT
+  hoijFk1oTY939JhjdcHuJzMiS2TrqIw8Dr5DkQu2vAjHpw0aOOWhlRjNJ7RHYJNm
+  QugXmCnHQxSKTmc7imKuotyMdRRKFh8UEFCLRsFtBbNxkXyNuB4xBMuUYodhEw==
   -----END CERTIFICATE-----
-date: 2020-12-29 00:00:00.000000000 Z
+date: 2024-03-05 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: matrix
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
 - !ruby/object:Gem::Dependency
   name: pdf-core
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.0
+        version: 0.10.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.0
+        version: 0.10.0
 - !ruby/object:Gem::Dependency
   name: ttfunk
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '1.8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '1.8'
 - !ruby/object:Gem::Dependency
   name: pdf-inspector
   requirement: !ruby/object:Gem::Requirement
@@ -109,30 +122,31 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.0
+        version: 0.4.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.0
+        version: 0.4.0
 - !ruby/object:Gem::Dependency
   name: prawn-manual_builder
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.0
+        version: 0.4.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.0
-description: "  Prawn is a fast, tiny, and nimble PDF generator for Ruby\n"
+        version: 0.4.0
+description: Prawn is a fast, tiny, and nimble PDF generator for Ruby
 email:
+- alex@pointless.one
 - gregory.t.brown@gmail.com
 - brad@bradediger.com
 - dnelson@bluejade.com
@@ -142,13 +156,10 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".yardopts"
 - COPYING
 - GPLv2
 - GPLv3
-- Gemfile
 - LICENSE
-- Rakefile
 - data/fonts/Courier-Bold.afm
 - data/fonts/Courier-BoldOblique.afm
 - data/fonts/Courier-Oblique.afm
@@ -174,9 +185,11 @@ files:
 - lib/prawn/errors.rb
 - lib/prawn/font.rb
 - lib/prawn/font_metric_cache.rb
+- lib/prawn/fonts.rb
 - lib/prawn/fonts/afm.rb
 - lib/prawn/fonts/dfont.rb
 - lib/prawn/fonts/otf.rb
+- lib/prawn/fonts/to_unicode_cmap.rb
 - lib/prawn/fonts/ttc.rb
 - lib/prawn/fonts/ttf.rb
 - lib/prawn/graphics.rb
@@ -215,154 +228,18 @@ files:
 - lib/prawn/utilities.rb
 - lib/prawn/version.rb
 - lib/prawn/view.rb
-- manual/absolute_position.pdf
-- manual/basic_concepts/adding_pages.rb
-- manual/basic_concepts/basic_concepts.rb
-- manual/basic_concepts/creation.rb
-- manual/basic_concepts/cursor.rb
-- manual/basic_concepts/measurement.rb
-- manual/basic_concepts/origin.rb
-- manual/basic_concepts/other_cursor_helpers.rb
-- manual/basic_concepts/view.rb
-- manual/bounding_box/bounding_box.rb
-- manual/bounding_box/bounds.rb
-- manual/bounding_box/canvas.rb
-- manual/bounding_box/creation.rb
-- manual/bounding_box/indentation.rb
-- manual/bounding_box/nesting.rb
-- manual/bounding_box/russian_boxes.rb
-- manual/bounding_box/stretchy.rb
-- manual/contents.rb
-- manual/cover.rb
-- manual/document_and_page_options/background.rb
-- manual/document_and_page_options/document_and_page_options.rb
-- manual/document_and_page_options/metadata.rb
-- manual/document_and_page_options/page_margins.rb
-- manual/document_and_page_options/page_size.rb
-- manual/document_and_page_options/print_scaling.rb
-- manual/example_helper.rb
-- manual/graphics/blend_mode.rb
-- manual/graphics/circle_and_ellipse.rb
-- manual/graphics/color.rb
-- manual/graphics/common_lines.rb
-- manual/graphics/fill_and_stroke.rb
-- manual/graphics/fill_rules.rb
-- manual/graphics/gradients.rb
-- manual/graphics/graphics.rb
-- manual/graphics/helper.rb
-- manual/graphics/line_width.rb
-- manual/graphics/lines_and_curves.rb
-- manual/graphics/polygon.rb
-- manual/graphics/rectangle.rb
-- manual/graphics/rotate.rb
-- manual/graphics/scale.rb
-- manual/graphics/soft_masks.rb
-- manual/graphics/stroke_cap.rb
-- manual/graphics/stroke_dash.rb
-- manual/graphics/stroke_join.rb
-- manual/graphics/translate.rb
-- manual/graphics/transparency.rb
-- manual/how_to_read_this_manual.rb
-- manual/images/absolute_position.rb
-- manual/images/fit.rb
-- manual/images/horizontal.rb
-- manual/images/images.rb
-- manual/images/plain_image.rb
-- manual/images/scale.rb
-- manual/images/vertical.rb
-- manual/images/width_and_height.rb
-- manual/layout/boxes.rb
-- manual/layout/content.rb
-- manual/layout/layout.rb
-- manual/layout/simple_grid.rb
-- manual/outline/add_subsection_to.rb
-- manual/outline/insert_section_after.rb
-- manual/outline/outline.rb
-- manual/outline/sections_and_pages.rb
-- manual/repeatable_content/alternate_page_numbering.rb
-- manual/repeatable_content/page_numbering.rb
-- manual/repeatable_content/repeatable_content.rb
-- manual/repeatable_content/repeater.rb
-- manual/repeatable_content/stamp.rb
-- manual/security/encryption.rb
-- manual/security/permissions.rb
-- manual/security/security.rb
-- manual/table.rb
-- manual/text/alignment.rb
-- manual/text/color.rb
-- manual/text/column_box.rb
-- manual/text/fallback_fonts.rb
-- manual/text/font.rb
-- manual/text/font_size.rb
-- manual/text/font_style.rb
-- manual/text/formatted_callbacks.rb
-- manual/text/formatted_text.rb
-- manual/text/free_flowing_text.rb
-- manual/text/inline.rb
-- manual/text/kerning_and_character_spacing.rb
-- manual/text/leading.rb
-- manual/text/line_wrapping.rb
-- manual/text/paragraph_indentation.rb
-- manual/text/positioned_text.rb
-- manual/text/registering_families.rb
-- manual/text/rendering_and_color.rb
-- manual/text/right_to_left_text.rb
-- manual/text/rotation.rb
-- manual/text/single_usage.rb
-- manual/text/text.rb
-- manual/text/text_box_excess.rb
-- manual/text/text_box_extensions.rb
-- manual/text/text_box_overflow.rb
-- manual/text/utf8.rb
-- manual/text/win_ansi_charset.rb
-- prawn.gemspec
-- spec/data/curves.pdf
-- spec/extensions/encoding_helpers.rb
-- spec/prawn/document/bounding_box_spec.rb
-- spec/prawn/document/column_box_spec.rb
-- spec/prawn/document/security_spec.rb
-- spec/prawn/document_annotations_spec.rb
-- spec/prawn/document_destinations_spec.rb
-- spec/prawn/document_grid_spec.rb
-- spec/prawn/document_reference_spec.rb
-- spec/prawn/document_span_spec.rb
-- spec/prawn/document_spec.rb
-- spec/prawn/font_metric_cache_spec.rb
-- spec/prawn/font_spec.rb
-- spec/prawn/graphics/blend_mode_spec.rb
-- spec/prawn/graphics/transparency_spec.rb
-- spec/prawn/graphics_spec.rb
-- spec/prawn/graphics_stroke_styles_spec.rb
-- spec/prawn/image_handler_spec.rb
-- spec/prawn/images/jpg_spec.rb
-- spec/prawn/images/png_spec.rb
-- spec/prawn/images_spec.rb
-- spec/prawn/measurements_extensions_spec.rb
-- spec/prawn/outline_spec.rb
-- spec/prawn/repeater_spec.rb
-- spec/prawn/soft_mask_spec.rb
-- spec/prawn/stamp_spec.rb
-- spec/prawn/text/box_spec.rb
-- spec/prawn/text/formatted/arranger_spec.rb
-- spec/prawn/text/formatted/box_spec.rb
-- spec/prawn/text/formatted/fragment_spec.rb
-- spec/prawn/text/formatted/line_wrap_spec.rb
-- spec/prawn/text/formatted/parser_spec.rb
-- spec/prawn/text_draw_text_spec.rb
-- spec/prawn/text_rendering_mode_spec.rb
-- spec/prawn/text_spacing_spec.rb
-- spec/prawn/text_spec.rb
-- spec/prawn/text_with_inline_formatting_spec.rb
-- spec/prawn/transformation_stack_spec.rb
-- spec/prawn/view_spec.rb
-- spec/prawn_manual_spec.rb
-- spec/spec_helper.rb
-homepage: http://prawnpdf.org
+homepage: http://prawnpdf.org/
 licenses:
-- PRAWN
-- GPL-2.0
-- GPL-3.0
-metadata: {}
+- Nonstandard
+- GPL-2.0-only
+- GPL-3.0-only
+metadata:
+  rubygems_mfa_required: 'true'
+  homepage_uri: http://prawnpdf.org/
+  changelog_uri: https://github.com/prawnpdf/prawn/blob/2.5.0/CHANGELOG.md
+  source_code_uri: https://github.com/prawnpdf/prawn
+  documentation_uri: https://prawnpdf.org/docs/prawn/2.5.0/
+  bug_tracker_uri: https://github.com/prawnpdf/prawn/issues
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -371,14 +248,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.5'
+      version: '2.7'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: 1.3.6
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.5.3
 signing_key:
 specification_version: 4
 summary: A fast and nimble PDF generator for Ruby

data/.yardopts

@@ -1,10 +0,0 @@
---charset UTF-8
---main README.md
---title 'Prawn Documentation'
---no-private
--
-CONTRIBUTING.md
-COPYING
-LICENSE
-README.md
-CHANGELOG.md

data/Gemfile

@@ -1,5 +0,0 @@
-# frozen_string_literal: true
-
-source 'https://rubygems.org'
-
-gemspec

data/Rakefile

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-GEMSPEC = File.expand_path('prawn.gemspec', __dir__)
-require 'prawn/dev/tasks'
-
-task default: %i[spec rubocop]
-
-desc "Generate the 'Prawn by Example' manual"
-task :manual do
-  puts 'Building manual...'
-  require File.expand_path(File.join(__dir__, %w[manual contents]))
-  prawn_manual_document.render_file('manual.pdf')
-  puts 'The Prawn manual is available at manual.pdf. Happy Prawning!'
-end
-
-desc 'Run a console with Prawn loaded'
-task :console do
-  require 'irb'
-  require 'irb/completion'
-  require_relative 'lib/prawn'
-  Prawn.debug = true
-
-  ARGV.clear
-  IRB.start
-end

data/manual/basic_concepts/adding_pages.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-# A PDF document is a collection of pages. When we create a new document be it
-# with <code>Document.new</code> or on a <code>Document.generate</code> block
-# one initial page is created for us.
-#
-# Some methods might create new pages automatically like <code>text</code> which
-# will create a new page whenever the text string cannot fit on the current
-# page.
-#
-# But what if you want to go to the next page by yourself? That is easy.
-#
-# Just use the <code>start_new_page</code> method and a shiny new page will be
-# created for you just like in the following snippet.
-
-require_relative '../example_helper'
-
-filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::ManualBuilder::Example.generate(filename) do
-  text "We are still on the initial page for this example. Now I'll ask " \
-    'Prawn to gently start a new page. Please follow me to the next page.'
-
-  start_new_page
-
-  text "See. We've left the previous page behind."
-end

data/manual/basic_concepts/basic_concepts.rb

@@ -1,43 +0,0 @@
-# frozen_string_literal: true
-
-# Examples for Prawn basic concepts.
-#
-
-require_relative '../example_helper'
-
-filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::ManualBuilder::Example.generate(filename, page_size: 'FOLIO') do
-  package 'basic_concepts' do |p|
-    p.example 'creation', eval_source: false, full_source: true
-    p.example 'origin'
-    p.example 'cursor'
-    p.example 'other_cursor_helpers'
-    p.example 'adding_pages'
-    p.example 'measurement'
-    p.example 'view', eval_source: false, full_source: true
-
-    p.intro do
-      prose <<-TEXT
-        This chapter covers the minimum amount of functionality you'll need to
-        start using Prawn.
-
-        If you are new to Prawn this is the first chapter to read. Once you are
-        comfortable with the concepts shown here you might want to check the
-        Basics section of the Graphics, Bounding Box and Text sections.
-
-        The examples show:
-      TEXT
-
-      list(
-        'How to create new pdf documents in every possible way',
-        'Where the origin for the document coordinates is. What are Bounding '\
-          'Boxes and how they interact with the origin',
-        'How the cursor behaves',
-        'How to start new pages',
-        'What the base unit for measurement and coordinates is and how to use '\
-          'other convenient measures',
-        "How to build custom view objects that use Prawn's DSL"
-      )
-    end
-  end
-end

data/manual/basic_concepts/creation.rb

@@ -1,38 +0,0 @@
-# frozen_string_literal: true
-
-# There are three ways to create a PDF Document in Prawn: creating a new
-# <code>Prawn::Document</code> instance, or using the
-# <code>Prawn::Document.generate</code> method with and without block arguments.
-#
-# The following snippet showcase each way by creating a simple document with
-# some text drawn.
-#
-# When we instantiate the <code>Prawn::Document</code> object the actual pdf
-# document will only be created after we call <code>render_file</code>.
-#
-# The generate method will render the actual pdf object after exiting the block.
-# When we use it without a block argument the provided block is evaluated in the
-# context of a newly created <code>Prawn::Document</code> instance. When we use
-# it with a block argument a <code>Prawn::Document</code> instance is created
-# and passed to the block.
-#
-# The generate method without block arguments requires
-# less typing and defines and renders the pdf document in one shot.
-# Almost all of the examples are coded this way.
-
-require_relative '../example_helper'
-
-# Assignment
-pdf = Prawn::Document.new
-pdf.text 'Hello World'
-pdf.render_file 'assignment.pdf'
-
-# Implicit Block
-Prawn::Document.generate('implicit.pdf') do
-  text 'Hello World'
-end
-
-# Explicit Block
-Prawn::Document.generate('explicit.pdf') do |pdf|
-  pdf.text 'Hello World'
-end

data/manual/basic_concepts/cursor.rb

@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-# We normally write our documents from top to bottom and it is no different with
-# Prawn. Even if the origin is on the bottom left corner we still fill the page
-# from the top to the bottom. In other words the cursor for inserting content
-# starts on the top of the page.
-#
-# Most of the functions that insert content on the page will start at the
-# current cursor position and proceed to the bottom of the page.
-#
-# The following snippet shows how the cursor behaves when we add some text to
-# the page and demonstrates some of the helpers to manage the cursor position.
-# The <code>cursor</code> method returns the current cursor position.
-
-require_relative '../example_helper'
-
-filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::ManualBuilder::Example.generate(filename) do
-  stroke_axis
-
-  text "the cursor is here: #{cursor}"
-  text "now it is here: #{cursor}"
-
-  move_down 200
-  text "on the first move the cursor went down to: #{cursor}"
-
-  move_up 100
-  text "on the second move the cursor went up to: #{cursor}"
-
-  move_cursor_to 50
-  text "on the last move the cursor went directly to: #{cursor}"
-end

data/manual/basic_concepts/measurement.rb

@@ -1,24 +0,0 @@
-# frozen_string_literal: true
-
-# The base unit in Prawn is the PDF Point. One PDF Point is equal to 1/72 of
-# an inch.
-#
-# There is no need to waste time converting this measure. Prawn provides
-# helpers for converting from other measurements
-# to PDF Points.
-#
-# Just <code>require "prawn/measurement_extensions"</code> and it will mix some
-# helpers onto <code>Numeric</code> for converting common measurement units to
-# PDF Points.
-
-require_relative '../example_helper'
-
-filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::ManualBuilder::Example.generate(filename) do
-  require 'prawn/measurement_extensions'
-
-  %i[mm cm dm m in yd ft].each do |measurement|
-    text "1 #{measurement} in PDF Points: #{1.public_send(measurement)} pt"
-    move_down 5.mm
-  end
-end

data/manual/basic_concepts/origin.rb

@@ -1,37 +0,0 @@
-# frozen_string_literal: true
-
-# This is the most important concept you need to learn about Prawn:
-#
-# PDF documents have the origin <code>[0,0]</code> at the bottom-left corner of
-# the page.
-#
-# A bounding box is a structure which provides boundaries for inserting content.
-# A bounding box also has the property of relocating the origin to its relative
-# bottom-left corner. However, be aware that the location specified when
-# creating a bounding box is its top-left corner, not bottom-left (hence the
-# <code>[100, 300]</code> coordinates below).
-#
-# Even if you never create a bounding box explictly, each document already comes
-# with one called the margin box. This initial bounding box is the one
-# responsible for the document margins.
-#
-# So practically speaking the origin of a page on a default generated document
-# isn't the absolute bottom left corner but the bottom left corner of the margin
-# box.
-#
-# The following snippet strokes a circle on the margin box origin. Then strokes
-# the boundaries of a bounding box and a circle on its origin.
-
-require_relative '../example_helper'
-
-filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::ManualBuilder::Example.generate(filename) do
-  stroke_axis
-
-  stroke_circle [0, 0], 10
-
-  bounding_box([100, 300], width: 300, height: 200) do
-    stroke_bounds
-    stroke_circle [0, 0], 10
-  end
-end

data/manual/basic_concepts/other_cursor_helpers.rb

@@ -1,39 +0,0 @@
-# frozen_string_literal: true
-
-# Another group of helpers for changing the cursor position are the pad methods.
-# They accept a numeric value and a block. <code>pad</code> will use the numeric
-# value to move the cursor down both before and after the block content.
-# <code>pad_top</code> will only move the cursor before the block while
-# <code>pad_bottom</code> will only move after.
-#
-# <code>float</code> is a method for not changing the cursor. Pass it a block
-# and the cursor will remain on the same place when the block returns.
-
-require_relative '../example_helper'
-
-filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::ManualBuilder::Example.generate(filename) do
-  stroke_horizontal_rule
-  pad(20) { text 'Text padded both before and after.' }
-
-  stroke_horizontal_rule
-  pad_top(20) { text 'Text padded on the top.' }
-
-  stroke_horizontal_rule
-  pad_bottom(20) { text 'Text padded on the bottom.' }
-
-  stroke_horizontal_rule
-  move_down 30
-
-  text 'Text written before the float block.'
-
-  float do
-    move_down 30
-    bounding_box([0, cursor], width: 200) do
-      text 'Text written inside the float block.'
-      stroke_bounds
-    end
-  end
-
-  text 'Text written after the float block.'
-end