hexapdf 0.1.0

data/lib/hexapdf/writer.rb

@@ -0,0 +1,199 @@
+# -*- encoding: utf-8 -*-
+#
+#--
+# This file is part of HexaPDF.
+#
+# HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
+# Copyright (C) 2016 Thomas Leitner
+#
+# HexaPDF is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Affero General Public License version 3 as
+# published by the Free Software Foundation with the addition of the
+# following permission added to Section 15 as permitted in Section 7(a):
+# FOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY
+# THOMAS LEITNER, THOMAS LEITNER DISCLAIMS THE WARRANTY OF NON
+# INFRINGEMENT OF THIRD PARTY RIGHTS.
+#
+# HexaPDF is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with HexaPDF. If not, see <http://www.gnu.org/licenses/>.
+#
+# The interactive user interfaces in modified source and object code
+# versions of HexaPDF must display Appropriate Legal Notices, as required
+# under Section 5 of the GNU Affero General Public License version 3.
+#
+# In accordance with Section 7(b) of the GNU Affero General Public
+# License, a covered work must retain the producer line in every PDF that
+# is created or manipulated using HexaPDF.
+#++
+
+require 'hexapdf/error'
+require 'hexapdf/serializer'
+require 'hexapdf/xref_section'
+require 'hexapdf/version'
+
+module HexaPDF
+
+  # Writes the contents of a PDF document to an IO stream.
+  class Writer
+
+    # Writes the document to the IO object.
+    def self.write(document, io)
+      new(document, io).write
+    end
+
+    # Creates a new writer object for the given HexaPDF document that gets written to the IO
+    # object.
+    def initialize(document, io)
+      @document = document
+      @io = io
+
+      @io.binmode
+      @io.seek(0, IO::SEEK_SET) # TODO: incremental update!
+
+      @serializer = Serializer.new
+      @rev_size = 0
+    end
+
+    # Writes the document to the IO object.
+    def write
+      @serializer.encrypter = @document.encrypted? ? @document.security_handler : nil
+
+      write_file_header
+
+      pos = nil
+      @document.trailer.info[:Producer] = "HexaPDF version #{HexaPDF::VERSION}"
+      @document.revisions.each do |rev|
+        pos = write_revision(rev, pos)
+      end
+    end
+
+    private
+
+    # Writes the PDF file header.
+    #
+    # See: PDF1.7 s7.5.2
+    def write_file_header
+      @io << "%PDF-#{@document.version}\n%\xCF\xEC\xFF\xE8\xD7\xCB\xCD\n"
+    end
+
+    # Writes the given revision.
+    #
+    # The optional +previous_xref_pos+ argument needs to contain the byte position of the previous
+    # cross-reference section or stream if applicable.
+    def write_revision(rev, previous_xref_pos = nil)
+      xref_stream, object_streams = xref_and_object_streams(rev)
+      obj_to_stm = object_streams.each_with_object({}) {|stm, m| m.update(stm.write_objects(rev))}
+
+      xref_section = XRefSection.new
+      xref_section.add_free_entry(0, 65535) if previous_xref_pos.nil?
+      rev.each do |obj|
+        if obj.null?
+          xref_section.add_free_entry(obj.oid, obj.gen)
+        elsif (objstm = obj_to_stm[obj])
+          xref_section.add_compressed_entry(obj.oid, objstm.oid, objstm.object_index(obj))
+        elsif obj != xref_stream
+          xref_section.add_in_use_entry(obj.oid, obj.gen, @io.pos)
+          write_indirect_object(obj)
+        end
+      end
+
+      trailer = rev.trailer.value.dup
+      if previous_xref_pos
+        trailer[:Prev] = previous_xref_pos
+      else
+        trailer.delete(:Prev)
+      end
+      @rev_size = rev.next_free_oid if rev.next_free_oid > @rev_size
+      trailer[:Size] = @rev_size
+
+      startxref = @io.pos
+      if xref_stream
+        xref_section.add_in_use_entry(xref_stream.oid, xref_stream.gen, startxref)
+        xref_stream.update_with_xref_section_and_trailer(xref_section, trailer)
+        write_indirect_object(xref_stream)
+      else
+        write_xref_section(xref_section)
+        write_trailer(trailer)
+      end
+
+      write_startxref(startxref)
+
+      startxref
+    end
+
+    # :call-seq:
+    #    writer.xref_and_object_streams    -> [xref_stream, object_streams]
+    #
+    # Returns the cross-reference and object streams of the given revision.
+    #
+    # An error is raised if the revision contains object streams and no cross-reference stream. If
+    # it contains multiple cross-reference streams only the first one is used, the rest are
+    # ignored.
+    def xref_and_object_streams(rev)
+      xref_stream = nil
+      object_streams = []
+
+      rev.each do |obj|
+        if obj.type == :ObjStm
+          object_streams << obj
+        elsif !xref_stream && obj.type == :XRef
+          xref_stream = obj
+        end
+      end
+
+      if object_streams.size > 0 && xref_stream.nil?
+        raise HexaPDF::Error, "Cannot use object streams when there is no xref stream"
+      end
+
+      [xref_stream, object_streams]
+    end
+
+    # Writes the single indirect object which may be a stream object or another object.
+    def write_indirect_object(obj)
+      @io << "#{obj.oid} #{obj.gen} obj\n".freeze
+      @serializer.serialize_to_io(obj, @io)
+      @io << "\nendobj\n".freeze
+    end
+
+    # Writes the cross-reference section.
+    #
+    # See: PDF1.7 s7.5.4
+    def write_xref_section(xref_section)
+      @io << "xref\n"
+      xref_section.each_subsection do |entries|
+        @io << "#{entries.empty? ? 0 : entries.first.oid} #{entries.size}\n"
+        entries.each do |entry|
+          if entry.in_use?
+            @io << sprintf("%010d %05d n \n".freeze, entry.pos, entry.gen).freeze
+          elsif entry.free?
+            @io << "0000000000 65535 f \n".freeze
+          else
+            # Should never occur since we create the xref section!
+            raise HexaPDF::Error, "Cannot use xref type #{entry.type} in cross-reference section"
+          end
+        end
+      end
+    end
+
+    # Writes the trailer dictionary.
+    #
+    # See: PDF1.7 s7.5.5
+    def write_trailer(trailer)
+      @io << "trailer\n#{@serializer.serialize(trailer)}\n"
+    end
+
+    # Writes the startxref line needed for cross-reference sections and cross-reference streams.
+    #
+    # See: PDF1.7 s7.5.5, s7.5.8
+    def write_startxref(startxref)
+      @io << "startxref\n#{startxref}\n%%EOF\n"
+    end
+
+  end
+
+end

data/lib/hexapdf/xref_section.rb

@@ -0,0 +1,152 @@
+# -*- encoding: utf-8 -*-
+#
+#--
+# This file is part of HexaPDF.
+#
+# HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
+# Copyright (C) 2016 Thomas Leitner
+#
+# HexaPDF is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Affero General Public License version 3 as
+# published by the Free Software Foundation with the addition of the
+# following permission added to Section 15 as permitted in Section 7(a):
+# FOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY
+# THOMAS LEITNER, THOMAS LEITNER DISCLAIMS THE WARRANTY OF NON
+# INFRINGEMENT OF THIRD PARTY RIGHTS.
+#
+# HexaPDF is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with HexaPDF. If not, see <http://www.gnu.org/licenses/>.
+#
+# The interactive user interfaces in modified source and object code
+# versions of HexaPDF must display Appropriate Legal Notices, as required
+# under Section 5 of the GNU Affero General Public License version 3.
+#
+# In accordance with Section 7(b) of the GNU Affero General Public
+# License, a covered work must retain the producer line in every PDF that
+# is created or manipulated using HexaPDF.
+#++
+
+require 'hexapdf/utils/object_hash'
+
+module HexaPDF
+
+  # Manages the indirect objects of one cross-reference section or stream.
+  #
+  # A PDF file can have more than one cross-reference section or stream which are all
+  # daisy-chained together. This allows later sections to override entries in prior ones. This is
+  # automatically and transparently done by HexaPDF.
+  #
+  # Note that a cross-reference section may contain a single object number only once.
+  #
+  # See: HexaPDF::Revision, PDF1.7 s7.5.4, s7.5.8
+  class XRefSection < Utils::ObjectHash
+
+    # One entry of a cross-reference section or stream.
+    #
+    # An entry has the attributes +type+, +oid+, +gen+, +pos+ and +objstm+ and can be created like
+    # this:
+    #
+    #   Entry.new(type, oid, gen, pos, objstm)   -> entry
+    #
+    # The +type+ attribute can be:
+    #
+    # :free:: Denotes a free entry.
+    #
+    # :in_use:: A used entry that resides in the body of the PDF file. The +pos+ attribute defines
+    #           the position in the file at which the object can be found.
+    #
+    # :compressed:: A used entry that resides in an object stream. The +objstm+ attribute contains
+    #               the reference to the object stream in which the object can be found and the
+    #               +pos+ attribute contains the index into the object stream.
+    #
+    #               Objects in an object stream always have a generation number of 0!
+    #
+    # See: PDF1.7 s7.5.4, s7.5.8
+    Entry = Struct.new(:type, :oid, :gen, :pos, :objstm) do
+      def free?
+        type == :free
+      end
+
+      def in_use?
+        type == :in_use
+      end
+
+      def compressed?
+        type == :compressed
+      end
+    end
+
+    # Creates an in-use cross-reference entry. See Entry for details on the arguments.
+    def self.in_use_entry(oid, gen, pos)
+      Entry.new(:in_use, oid, gen, pos)
+    end
+
+    # Creates a free cross-reference entry. See Entry for details on the arguments.
+    def self.free_entry(oid, gen)
+      Entry.new(:free, oid, gen)
+    end
+
+    # Creates a compressed cross-reference entry. See Entry for details on the arguments.
+    def self.compressed_entry(oid, objstm, pos)
+      Entry.new(:compressed, oid, 0, pos, objstm)
+    end
+
+    # Make the assignment method private so that only the provided convenience methods can be
+    # used.
+    private :"[]="
+
+    # Adds an in-use entry to the cross-reference section.
+    #
+    # See: ::in_use_entry
+    def add_in_use_entry(oid, gen, pos)
+      self[oid, gen] = self.class.in_use_entry(oid, gen, pos)
+    end
+
+    # Adds a free entry to the cross-reference section.
+    #
+    # See: ::free_entry
+    def add_free_entry(oid, gen)
+      self[oid, gen] = self.class.free_entry(oid, gen)
+    end
+
+    # Adds a compressed entry to the cross-reference section.
+    #
+    # See: ::compressed_entry
+    def add_compressed_entry(oid, objstm, pos)
+      self[oid, 0] = self.class.compressed_entry(oid, objstm, pos)
+    end
+
+    # :call-seq:
+    #   xref_section.each_subsection {|sub| block }   -> xref_section
+    #   xref_section.each_subsection                  -> Enumerator
+    #
+    # Calls the given block once for every subsection of this cross-reference section. Each
+    # yielded subsection is a sorted array of cross-reference entries.
+    #
+    # If this section contains no objects, a single empty array is yielded (corresponding to a
+    # subsection with zero elements).
+    #
+    # The subsections are dynamically generated based on the object numbers in this section.
+    def each_subsection
+      return to_enum(__method__) unless block_given?
+
+      temp = []
+      oids.sort.each do |oid|
+        if !temp.empty? && temp[-1].oid + 1 != oid
+          yield(temp)
+          temp = []
+        end
+        temp << self[oid]
+      end
+      yield(temp)
+      self
+    end
+
+  end
+
+end

data/lib/hexapdf.rb

@@ -0,0 +1,34 @@
+# -*- encoding: utf-8 -*-
+#
+#--
+# This file is part of HexaPDF.
+#
+# HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
+# Copyright (C) 2016 Thomas Leitner
+#
+# HexaPDF is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Affero General Public License version 3 as
+# published by the Free Software Foundation with the addition of the
+# following permission added to Section 15 as permitted in Section 7(a):
+# FOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY
+# THOMAS LEITNER, THOMAS LEITNER DISCLAIMS THE WARRANTY OF NON
+# INFRINGEMENT OF THIRD PARTY RIGHTS.
+#
+# HexaPDF is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with HexaPDF. If not, see <http://www.gnu.org/licenses/>.
+#
+# The interactive user interfaces in modified source and object code
+# versions of HexaPDF must display Appropriate Legal Notices, as required
+# under Section 5 of the GNU Affero General Public License version 3.
+#
+# In accordance with Section 7(b) of the GNU Affero General Public
+# License, a covered work must retain the producer line in every PDF that
+# is created or manipulated using HexaPDF.
+#++
+
+require 'hexapdf/document'

data/man/man1/hexapdf.1

@@ -0,0 +1,249 @@
+.\" generated with Ronn/v0.7.3
+.\" http://github.com/rtomayko/ronn/tree/0.7.3
+.
+.TH "HEXAPDF" "1" "October 2016" "" ""
+.
+.SH "NAME"
+hexapdf \- A Versatile PDF Manipulation Application
+.
+.SH "SYNOPSIS"
+\fBhexapdf\fR [\fBOPTIONS\fR] \fBcommand\fR [\fBCOMMAND OPTIONS\fR]\.\.\.
+.
+.SH "DESCRIPTION"
+hexapdf is an application for PDF manipulation\. It is part of the hexapdf \fIhttp://hexapdf\.gettalong\.org\fR library which also allows PDF creation, among other things\.
+.
+.P
+Using the hexapdf application the following tasks can be performed with PDF files:
+.
+.IP "\(bu" 4
+Extracting embedded files (see the \fBextract\fR command)
+.
+.IP "\(bu" 4
+Showing general information of a PDF file (see the \fBinfo\fR command)
+.
+.IP "\(bu" 4
+Inspecting the internal structure of a PDF file (see the \fBinspect\fR command)
+.
+.IP "\(bu" 4
+Modifying an existing PDF file (see the \fBmodify\fR command)
+.
+.IP "" 0
+.
+.P
+The application contains a built\-in \fBhelp\fR command that can be used to provide a quick reminder of a command\'s purpose and its options\.
+.
+.SH "OPTIONS"
+The following options can only be used when no command is specified:
+.
+.TP
+\fB\-v\fR, \fB\-\-version\fR
+Show the version of the hexapdf application and exit\.
+.
+.P
+These options are available on every command (except if they are overridden):
+.
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Show the help for the application if no command was specified, or the command help otherwise\.
+.
+.SH "COMMANDS"
+hexapdf uses a command\-style interface\. This means that it provides different functionalities depending on the used command and each command can have its own options\.
+.
+.P
+There is no need to write the full command name for hexapdf to understand it, the only requirement is that is must be unambiguous\. So using \fBe\fR for the \fBextract\fR command is sufficient\.
+.
+.SS "extract"
+Synopsis: \fBextract\fR [\fBOPTIONS\fR] \fIFILE\fR
+.
+.P
+This command extracts embedded files from the PDF \fIFILE\fR\. If the \fB\-\-indices\fR option is not specified, the names and indices of the embedded files are just listed\.
+.
+.TP
+\fB\-i\fR, \fB\-\-indices\fR \fIA,B,C,\.\.\.\fR
+The indices of the embedded files that should be extract\. The value \fI0\fR can be used to extract all embedded files\.
+.
+.TP
+\fB\-s\fR, \fB\-\-[no\-]search\fR
+Search the whole PDF file instead of the standard locations, i\.e\. files attached to the document as a whole or to an individual page\. Defaults to \fIfalse\fR\.
+.
+.TP
+\fB\-p\fR, \fB\-\-password\fR \fIPASSWORD\fR
+The password to decrypt the PDF \fIFILE\fR\. Use \fB\-\fR for \fIPASSWORD\fR for reading it from standard input\.
+.
+.SS "help"
+Synopsis: \fBhelp\fR \fICOMMAND\fR\.\.\.
+.
+.P
+This command prints the application help if no arguments are given\. If one or more command names are given as arguments, these arguments are interpreted as a list of commands with sub\-commands and the help for the innermost command is shown\.
+.
+.SS "info"
+Synopsis: \fBinfo\fR [\fBOPTIONS\fR] \fIFILE\fR
+.
+.P
+This command reads the \fIFILE\fR file and shows general information about it, like author information, PDF version used, encryption information and so on\.
+.
+.TP
+\fB\-p\fR, \fB\-\-password\fR \fIPASSWORD\fR
+The password to decrypt the PDF \fIFILE\fR\. Use \fB\-\fR for \fIPASSWORD\fR for reading it from standard input\.
+.
+.SS "inspect"
+Synopsis: \fBinspect\fR [\fBOPTIONS\fR] \fIFILE\fR
+.
+.P
+This command is useful when one needs to inspect the internal object structure or a stream of a PDF file\.
+.
+.P
+If no option is given, the main PDF object, the catalog, is shown\. Otherwise the various, mutually exclusive display options define what is shown\. If multiple such options are specified only the last one is respected\. Note that PDF objects are always shown in the PDF syntax\.
+.
+.TP
+\fB\-t\fR, \fB\-\-trailer\fR
+Show the trailer dictionary\.
+.
+.TP
+\fB\-c\fR, \fB\-\-page\-count\fR
+Print the number of pages\.
+.
+.TP
+\fB\-\-pages\fR [\fIPAGES\fR]
+Show the pages with their object and generation numbers and their associated content streams\. If a range is specified, only those pages are listed\. See the \fBPAGES SPECIFICATION\fR below for details on the allowed format of \fIPAGES\fR\.
+.
+.TP
+\fB\-o\fR, \fB\-\-object\fR \fIOID\fR[,\fIGEN\fR]
+Show the object with the given object and generation numbers\. The generation number defaults to 0 if not given\.
+.
+.TP
+\fB\-s\fR, \fB\-\-stream\fR \fIOID\fR[,\fIGEN\fR]
+Show the filtered stream data (add \fB\-\-raw\fR to get the raw stream data) of the object with the given object and generation numbers\. The generation number defaults to 0 if not given\.
+.
+.TP
+\fB\-\-raw\fR
+Modifies \fB\-\-stream\fR to show the raw stream data instead of the filtered one\.
+.
+.TP
+\fB\-p\fR, \fB\-\-password\fR \fIPASSWORD\fR
+The password to decrypt the PDF \fIFILE\fR\. Use \fB\-\fR for \fIPASSWORD\fR for reading it from standard input\.
+.
+.SS "modify"
+Synopsis: \fBmodify\fR [\fBOPTIONS\fR] \fIINPUT_FILE\fR \fIOUTPUT_FILE\fR
+.
+.P
+This command modifies a PDF file\. It can be used to encrypt/decrypt a file, to optimize it and remove unused entries and to generate or delete object and cross\-reference streams\.
+.
+.TP
+\fB\-p\fR, \fB\-\-password\fR \fIPASSWORD\fR
+The password to decrypt the PDF \fIINPUT_FILE\fR\. Use \fB\-\fR for \fIPASSWORD\fR for reading it from standard input\.
+.
+.TP
+\fB\-\-pages\fR \fIPAGES\fR
+The pages (optionally rotated) that should be included in the \fIOUTPUT_FILE\fR\. See the \fBPAGES SPECIFICATION\fR below for details on the allowed format of \fIPAGES\fR\. Default: \fI1\-e\fR (i\.e\. all pages with no additional rotation applied)\.
+.
+.TP
+\fB\-\-embed\fR \fIFILE\fR
+Embed the given file into the \fIOUTPUT_FILE\fR using built\-in features of PDF\. This option can be used multiple times to embed more than one file\.
+.
+.TP
+\fB\-\-[no\-]compact\fR
+Delete unnecessary PDF objects\. This includes merging the base revision and all incremental updates into a single revision\. Default: \fIyes\fR\.
+.
+.TP
+\fB\-\-object\-streams MODE\fR
+Defines how object streams should be treated: \fIgenerate\fR will remove all exisiting object streams and generate new ones, \fIdelete\fR will only remove existing object streams and \fIpreserve\fR will do nothing\. Default: \fIpreserve\fR\.
+.
+.TP
+\fB\-\-xref\-streams MODE\fR
+Defines how cross\-reference streams should be treated: \fIgenerate\fR will add them, \fIdelete\fR will remove them and \fIpreserve\fR will do nothing\. Default: \fIpreserve\fR\.
+.
+.TP
+\fB\-\-streams MODE\fR
+Defines how streams should be treated: \fIcompress\fR will compress them when possible, \fIuncompress\fR will uncompress them when possible and \fIpreserve\fR will do nothing to them\. Default: \fIpreserve\fR\.
+.
+.P
+Encryption related options (all options except \fB\-\-decrypt\fR automatically enabled \fB\-\-encrypt\fR):
+.
+.TP
+\fB\-\-decrypt\fR
+Remove any encryption\.
+.
+.IP
+If neither \fB\-\-decrypt\fR nor \fB\-\-encrypt\fR is specified, the existing encryption configuration is preserved\.
+.
+.TP
+\fB\-\-encrypt\fR
+Encrypt the \fIOUTPUT_FILE\fR\.
+.
+.IP
+If neither \fB\-\-decrypt\fR nor \fB\-\-encrypt\fR is specified, the existing encryption configuration is preserved\.
+.
+.TP
+\fB\-\-owner\-password\fR \fIPASSWORD\fR
+The owner password to be set on the \fIOUTPUT_FILE\fR\. This password is needed when operations not allowed by the permissions need to be done\. It can also be used when opening the PDF file\.
+.
+.IP
+Use \fB\-\fR for \fIPASSWORD\fR for reading it from standard input\.
+.
+.TP
+\fB\-\-user\-password\fR \fIPASSWORD\fR
+The user password to be set on the \fIOUTPUT_FILE\fR\. This password is needed when opening the PDF file\. The application should restrict the operations to those allowed by the permissions\.
+.
+.IP
+Use \fB\-\fR for \fIPASSWORD\fR for reading it from standard input\.
+.
+.TP
+\fB\-\-algorithm\fR \fIALGORITHM\fR
+The encryption algorithm to use on the \fIOUTPUT_FILE\fR\. Allowed algorithms are \fIaes\fR and \fIarc4\fR but \fIarc4\fR should only be used if it is absolutely necessary\. Default: \fIaes\fR\.
+.
+.TP
+\fB\-\-key\-length\fR \fIBITS\fR
+The length of the encryption key in bits\. The allowed values differ based on the chosen algorithm: A number divisible by eight between 40 to 128 for \fIarc4\fR and 128 or 256 for \fIaes\fR\. Default: \fB128\fR
+.
+.TP
+\fB\-\-force\-V4\fR
+Force the use of PDF encryption version 4 if key length is \fI128\fR and algorithm is \fIarc4\fR\. This option is probably only useful for testing the implementation of PDF libraries\' encryption handling\.
+.
+.TP
+\fB\-\-permissions\fR \fIPERMS\fR
+A comma separated list of permissions to be set on the \fIOUTPUT_FILE\fR\.
+.
+.IP
+Possible values: \fIprint\fR (allow printing), \fImodify_content\fR (allow modification of the content of pages), \fIcopy_content\fR (allow text extraction and similar operations), \fImodify_annotation\fR (allow creation and modification of annotations and filling in of forms), \fIfill_in_forms\fR (allow filling in of forms even if \fImodify_annotation\fR is not set), \fIextract_content\fR (allow text and graphics extraction in accessibility cases), \fIassemble_document\fR (allow page modifications and bookmark creation), and \fIhigh_quality_print\fR (allow high quality printing)\.
+.
+.SS "version"
+This command shows the version of the hexapdf application\. It is an alternative to using the global \fB\-\-version\fR option\.
+.
+.SH "PAGES SPECIFICATION"
+Some commands allow the specification of pages using a \fIPAGES\fR argument\. This argument is expected to be a comma separated list of single page numbers or page ranges of the form \fISTART\fR\-\fIEND\fR\. The character \'\fBe\fR\' represents the last page and can be used instead of a single number or in a range\. The pages are used in the order in which the are specified\.
+.
+.P
+Additionally, the page numbers and ranges can be suffixed with a rotation modifier: \fBl\fR (for rotating a page left, i\.e\. 90 degrees counterclockwise), \fBr\fR (for rotating a page right, i\.e\. 90 degrees clockwise), \fBd\fR (for rotating a page 180 degrees) and \fBn\fR (for removing any set page rotation)\. Note that this additional functionality may not be used by all commands\.
+.
+.P
+Examples:
+.
+.IP "\(bu" 4
+\fB1,2,3\fR: The pages one, two and three\.
+.
+.IP "\(bu" 4
+\fB11,4\-9,1,e\fR: The pages eleven, four to nine, one and the last page, in exactly this order\.
+.
+.IP "\(bu" 4
+\fB1\-e\fR: All pages of the document\.
+.
+.IP "\(bu" 4
+\fBe\-1\fR: All pages of the document in reverse order\.
+.
+.IP "\(bu" 4
+\fB1l,2r,3\-5d,6n\fR: The pages one (rotate to the left), two (rotated to the right), three to five (all rotated 180 degrees) and six (any possibly set rotation removed)\.
+.
+.IP "" 0
+.
+.SH "EXIT STATUS"
+The exit status is 0 if no error happened\. Otherwise it is 1\.
+.
+.SH "SEE ALSO"
+The hexapdf website \fIhttp://hexapdf\.gettalong\.org/\fR for more information
+.
+.SH "AUTHOR"
+hexapdf was written by Thomas Leitner \fIt_leitner@gmx\.at\fR\.
+.
+.P
+This manual page was written by Thomas Leitner \fIt_leitner@gmx\.at\fR\.